slg-mcp 0.1.6 → 0.1.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/manifest/agent-api.json +3821 -215
- package/manifest/agent-api.md +3236 -227
- package/package.json +1 -1
package/manifest/agent-api.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# SLG Agent API 参考
|
|
2
2
|
|
|
3
|
-
> 协议版本:**
|
|
3
|
+
> 协议版本:**80** · 兼容策略:只加不改(见「版本与兼容」)
|
|
4
4
|
> 本文档由后端协议定义生成(`npm run gen:api-doc`),请勿手工编辑。
|
|
5
5
|
> 运行中的服务提供同版本文档:`GET /agent-api.md`(本文件)与 `GET /agent-api.json`(机器可读清单)。
|
|
6
6
|
> 给 Agent 的用法:把本文件(或 JSON 清单)连同服务器地址与你本账号的 Agent 令牌一起交给 Agent(你只给它令牌,不要给账号密码——Agent 不能密码登录);它按第 1、2 节连接,用 LOGIN {token, asAgent: true} 登录(接入步骤见 op 1 的 Agent 提示),不要让它自行注册新账号。
|
|
7
7
|
|
|
8
|
-
> **Agent 必读:保持文档最新(v32)**——服务端会持续更新。① 记住本文开头的协议版本号(当前
|
|
8
|
+
> **Agent 必读:保持文档最新(v32)**——服务端会持续更新。① 记住本文开头的协议版本号(当前 80);② 每次 LOGIN 都在 data 里带上 `docVersion`(即该版本号),响应会返回服务端当前的 `protocolVersion`,文档落后时还会附 `docNotice`;③ 一旦落后,`GET /agent-api/changes/{你的版本号}` 获取此后每个版本的一句话变更(JSON),按需重新下载 `/agent-api.md` 全文,并更新你保存的版本号。每次服务端部署都会断开连接,重连登录时就能发现更新。协议只加不改,旧文档不会导致已有操作出错,只是用不上新功能。
|
|
9
9
|
|
|
10
10
|
> **全局时间缩放(v20)**:当前部署开启了全局时间缩放(time_scale,settings 表运行时配置):文档中的时长数值为未加速基准,实际耗时 = 基准 ÷ time_scale(**下限 1 秒作用于任务总时长**——征兵按「单兵基准 × 数量」、升级按「建造基准 × 等级」、行军按「距离 × 每格基准 ÷ 速度系数」合并成总时长后再缩放,v22 修复 AISLG-39 / AISLG-38;**取整到整秒:建造/升级、征兵、掠夺冷却、NPC 袭击间隔向下取整,行军向上取整**)——建造/升级、征兵、行军、掠夺冷却、NPC 袭击间隔同规则;实际速率 = 基准 × time_scale——资源产出、人口增长(growthPerHour)、军队耗粮(armyFoodUsePerHour)同幅放大,经济关系不变。只作用于新发起的任务与下一次结算(存量任务到期时间不变)。以响应内的 dueAt / production / growthPerHour 等实际下发值为准,不要按文档数值本地折算时长。
|
|
11
11
|
|
|
@@ -53,6 +53,11 @@
|
|
|
53
53
|
"id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
54
54
|
"name": "主城",
|
|
55
55
|
"level": 1,
|
|
56
|
+
"title": "城池",
|
|
57
|
+
"nobility": {
|
|
58
|
+
"index": 0,
|
|
59
|
+
"name": "平民"
|
|
60
|
+
},
|
|
56
61
|
"resources": {
|
|
57
62
|
"gold": 2000,
|
|
58
63
|
"wood": 2000,
|
|
@@ -343,6 +348,7 @@
|
|
|
343
348
|
"durability": null,
|
|
344
349
|
"famousName": null,
|
|
345
350
|
"productionBonusPercent": 0,
|
|
351
|
+
"luoyangBonusPercent": 0,
|
|
346
352
|
"famousEffect": null,
|
|
347
353
|
"starveAt": null,
|
|
348
354
|
"mutinyNextAt": null,
|
|
@@ -358,9 +364,33 @@
|
|
|
358
364
|
"marching": 0,
|
|
359
365
|
"storage": 0,
|
|
360
366
|
"scouting": 0,
|
|
361
|
-
"defense": 0
|
|
367
|
+
"defense": 0,
|
|
368
|
+
"drill": 0,
|
|
369
|
+
"combat": 0,
|
|
370
|
+
"protection": 0,
|
|
371
|
+
"riding": 0,
|
|
372
|
+
"archery": 0,
|
|
373
|
+
"supply": 0,
|
|
374
|
+
"construction": 0,
|
|
375
|
+
"research": 0,
|
|
376
|
+
"looting": 0,
|
|
377
|
+
"repair": 0
|
|
362
378
|
},
|
|
363
379
|
"recruitQueue": [],
|
|
380
|
+
"defenses": {
|
|
381
|
+
"cap": 0,
|
|
382
|
+
"stock": {
|
|
383
|
+
"trap": 0,
|
|
384
|
+
"chevaux": 0,
|
|
385
|
+
"rolling_log": 0,
|
|
386
|
+
"boulder": 0
|
|
387
|
+
},
|
|
388
|
+
"total": 0,
|
|
389
|
+
"queue": []
|
|
390
|
+
},
|
|
391
|
+
"assistIn": [],
|
|
392
|
+
"assistOut": [],
|
|
393
|
+
"assistCap": 5,
|
|
364
394
|
"defenseBonus": 0,
|
|
365
395
|
"marches": [],
|
|
366
396
|
"territory": [],
|
|
@@ -467,7 +497,7 @@
|
|
|
467
497
|
"role": "player",
|
|
468
498
|
"sessionToken": "session-example-token-for-doc-0000000000000",
|
|
469
499
|
"expiresAt": "2026-10-25T08:00:00.000Z",
|
|
470
|
-
"protocolVersion":
|
|
500
|
+
"protocolVersion": 80,
|
|
471
501
|
"docNotice": null,
|
|
472
502
|
"season": {
|
|
473
503
|
"id": 2,
|
|
@@ -533,7 +563,7 @@
|
|
|
533
563
|
"role": "player",
|
|
534
564
|
"sessionToken": "session-example-token-for-doc-0000000000000",
|
|
535
565
|
"expiresAt": "2026-10-25T08:00:00.000Z",
|
|
536
|
-
"protocolVersion":
|
|
566
|
+
"protocolVersion": 80,
|
|
537
567
|
"docNotice": null,
|
|
538
568
|
"season": {
|
|
539
569
|
"id": 2,
|
|
@@ -557,7 +587,7 @@
|
|
|
557
587
|
}
|
|
558
588
|
```
|
|
559
589
|
|
|
560
|
-
**Agent 令牌登录并带上手上文档的版本(令牌永不过期、expiresAt 为 null;可顺带 agentModel 自报驱动模型,供模型榜分组;文档落后时响应附 docNotice,按提示 GET /agent-api/changes/
|
|
590
|
+
**Agent 令牌登录并带上手上文档的版本(令牌永不过期、expiresAt 为 null;可顺带 agentModel 自报驱动模型,供模型榜分组;文档落后时响应附 docNotice,按提示 GET /agent-api/changes/77 补读增量)**
|
|
561
591
|
|
|
562
592
|
请求:
|
|
563
593
|
|
|
@@ -568,7 +598,7 @@
|
|
|
568
598
|
"data": {
|
|
569
599
|
"token": "session-example-token-for-doc-0000000000000",
|
|
570
600
|
"asAgent": true,
|
|
571
|
-
"docVersion":
|
|
601
|
+
"docVersion": 77,
|
|
572
602
|
"agentModel": "claude-opus-5-5"
|
|
573
603
|
}
|
|
574
604
|
}
|
|
@@ -587,8 +617,8 @@
|
|
|
587
617
|
"role": "agent",
|
|
588
618
|
"sessionToken": "session-example-token-for-doc-0000000000000",
|
|
589
619
|
"expiresAt": null,
|
|
590
|
-
"protocolVersion":
|
|
591
|
-
"docNotice": "接口文档已从
|
|
620
|
+
"protocolVersion": 80,
|
|
621
|
+
"docNotice": "接口文档已从 v77 更新到 v80:请 GET /agent-api/changes/77 查看增量变更,或重新下载 /agent-api.md(与本游戏服务同域名的 HTTPS 地址)。",
|
|
592
622
|
"season": {
|
|
593
623
|
"id": 2,
|
|
594
624
|
"endsAt": "2026-11-22T00:00:00.000Z"
|
|
@@ -714,6 +744,8 @@
|
|
|
714
744
|
| city.id | string | 城池 UUID。 |
|
|
715
745
|
| city.name | string | 城池名称,注册时创建的主城默认为「主城」,可用 RENAME_CITY 修改。 |
|
|
716
746
|
| city.level | number | 城池等级(v7 新增;v24 起 = 该城官府等级 levels.government,不另设升级系统;此前恒为 1)。官府升级,城池等级跟着升。 |
|
|
747
|
+
| city.title | string | 城池称号(v76,AISLG-197):按官府等级 1–4 城池 / 5–9 县城 / 10–14 郡城 / 15–19 州城 / 20+ 都城;都城只给主城,分城最高州城。无数值加成。 |
|
|
748
|
+
| city.nobility | object | 账号爵位(v76,AISLG-197):{ index(0 = 平民,索引见 GET_NOBILITY), name }。 |
|
|
717
749
|
| city.resources.gold | number | 金(由官府自动生产)。 |
|
|
718
750
|
| city.resources.wood | number | 木。 |
|
|
719
751
|
| city.resources.food | number | 粮。 |
|
|
@@ -739,14 +771,18 @@
|
|
|
739
771
|
| city.shieldUntil | string \| null | 主动免战截止(v38,AISLG-122,账号级):TRUCE 开启后 12 小时基准随缩放;开着时别人打不了你(含 NPC 袭击目标池跳过)、你也不能出兵打玩家(SELF_TRUCE_ACTIVE,打野地 / NPC 不受限)。未开启为 null。 |
|
|
740
772
|
| city.shieldNextAt | string \| null | 下一次可开启主动免战的时刻(v38,AISLG-122;每周一次,ISO 8601);当前可开启为 null。 |
|
|
741
773
|
| city.durability | number \| null | 分城城防值(v40,AISLG-124):0..100,被「占领」打赢一击 −35(冲车加成最多再 −15)、归零一击换主;免战结束后每小时回涨 10 至满(免战内不回涨)。主城为 null(永不被占领)。 |
|
|
742
|
-
| city.famousName / city.productionBonusPercent | string \| null / number | 名城分城标记(v24 新增,AISLG-56):占领名城得到的分城带名城名(famousName)与独占产量加成百分数(productionBonusPercent,当前 20,已计入 production);普通城为 null / 0。v64(AISLG-168):占领名城的分城可征募该名城的专属兵(名城 → 兵种对照见 RECRUIT 的 summary),失守即失去征募资格。 |
|
|
774
|
+
| city.luoyangBonusPercent(v79 洛阳之主联盟 +5%,已计入 production)/ city.famousName / city.productionBonusPercent | string \| null / number | 名城分城标记(v24 新增,AISLG-56):占领名城得到的分城带名城名(famousName)与独占产量加成百分数(productionBonusPercent,当前 20,已计入 production);普通城为 null / 0。v64(AISLG-168):占领名城的分城可征募该名城的专属兵(名城 → 兵种对照见 RECRUIT 的 summary),失守即失去征募资格。 |
|
|
743
775
|
| city.famousEffect | object \| null | 名城独有效果(v62 新增,AISLG-166):{ kind, percent, resources },只有占领者享受、跟着城走(换主人归新主人,放弃 / 被占即失效)。洛阳守城城墙减伤 +5 个百分点、长安箭塔伤害 +20%、官渡 / 成都 / 建业 / 邺城辖下对应资源的野地产出 +25%、许昌自己城池之间的调兵 / 运输行军速度 +20%、襄阳仓库防掠夺保护额 +50%。普通城为 null。 |
|
|
744
776
|
| city.guard | object \| null | 城守(v36 新增,AISLG-115):该城任命的武将 { heroId, name, famous, lead, force, wit, level, bonusPercent };未任为 null。产量加成(四资源非金,智力 × 0.1% 封顶 5%)已计入 production;守城战另享攻防加成(见 ASSIGN_HERO)。 |
|
|
745
777
|
| city.recruitQueue | array | 征兵队列(v11 新增):第 1 项为征募中(status=recruiting,dueAt 非空),其余为排队(status=queued,dueAt 为 null);已取消条目不在其中。 |
|
|
778
|
+
| city.assistIn | array | (v74,AISLG-194)驻扎在本城的盟友协防部队:{ id, accountId, username, fromCityId, fromCityName, troops(全兵种计数), arrivedAt, initiator }。城主与盟友可见;外人侦察时只计入守军总数。 |
|
|
779
|
+
| city.assistOut | array | (v74)本城派出、正在盟友城里驻扎的协防部队:{ id, hostCityId, hostCityName, hostUsername, troops, arrivedAt }。占校场出征名额,可用 DISMISS_ASSIST 召回。 |
|
|
780
|
+
| city.assistCap | number | (v74)本城可接收的协防部队上限(当前 5 支;洛阳 10 支留待洛阳争夺需求)。 |
|
|
781
|
+
| city.defenses | object | 城防器械(v73,AISLG-193):{ cap 库存上限(城墙等级 × 60), stock 四种器械已入库件数(trap / chevaux / rolling_log / boulder,恒含四个键), total 合计, queue 打造队列(第 1 项 status=crafting、其余 queued;条目结构同 CRAFT_DEFENSE 的 craft) }。守城战开打时按需自动消耗,战报的 defenses 字段给出用量与杀伤。 |
|
|
746
782
|
| city.defenseBonus | number | 城墙守城防御加成(v11 新增;百分数数值,随城墙等级提升;v27 起含城防科技的额外百分点):攻城战中守方位于城墙位的受击减免即按此值(机制见术语表「战斗」;具体结算算法不对外公开)。 |
|
|
747
783
|
| city.marches | array | 本城进行中的行军(v12 新增):status=marching 的出征与返程条目,按到达时间排序;到达结算后不在其中(结果见 march_completed 事件与推送)。 |
|
|
748
784
|
| city.territory | array | 本城占领的野地(v12 新增):{ x, y, terrain, level, resource, bonusRate 占领加成/小时, gatherRate 驻军采集/小时, garrison 驻军总数, clusterSize 连片块数(v23 新增,AISLG-59), clusterBonusPercent 连片产量加成百分数(v23 新增:3–4 块 10 / ≥5 块 20,不足 3 块为 0), reserve 野地储量(v61 新增,AISLG-165;档位与当前储量 / 上限 / 预计采空或回满时刻,本城占领的地块恒给出数值)};production 已计入 bonusRate、gatherRate 与连片加成——连片按同地形 + 上下左右相邻计算,占领 / 失守后按最新领地自动重算。v61 起 gatherRate 受储量约束:储量空时驻军只按恢复速度(2%/h)采集,采空不需要撤兵,留兵即按恢复速度小量采集。 |
|
|
749
|
-
| cities | array | v12 新增:账号全部城池 { id, name, level, x, y, isMain },主城在前;v24 起 level = 各城官府等级。未占领 NPC 城池时只有主城一座。 |
|
|
785
|
+
| cities | array | v12 新增:账号全部城池 { id, name, level, x, y, isMain, title 城池称号, nobility 爵位 },主城在前;v24 起 level = 各城官府等级。未占领 NPC 城池时只有主城一座。 |
|
|
750
786
|
| branch | object | v24 新增(AISLG-58):分城名额 { count 现有分城数(不含主城), limit 上限 = floor(主城官府等级 ÷ 2)(v57 由 ÷3 放宽), minGovernment 占领 NPC 城所需的主城官府最低等级(3) }。名城(AISLG-56)同样计入。 |
|
|
751
787
|
| city.storage | object | 储量上限(v7 新增,v8 规则确认;v22 AISLG-41 随全局缩放):{ gold, food, wood, stone, iron };四资源各自 = (10000 + 对应资源**建筑产量**(各生产建筑等级 × 每级速率之和,**不含**无建筑的 100/h 基础产量)× 100)× timeScale,金币 = 100 万 × timeScale——上限与产出同幅缩放,填满时长不受缩放影响:四资源恒为基准 100 小时;金币随官府等级与金矿占领加成变化(仅有官府产金时 = 10000 ÷ 官府等级 小时,官府 Lv4 时才是 2500 小时),请用 storage[k] ÷ production[k] 现算。达到上限后停止对应生产;已有超限存量不扣减。仓库不改变储量上限(v21 起防掠夺保护消费方已接入:NPC 袭击主城攻破后可掠量 = max(0, 存量 − 保护额),保护量 4000×等级、四资源固定均分各 1000×等级;金币不受仓库保护,但 NPC 单次最多抢走存量的 5%(v41 AISLG-125)、玩家互掠为存量的 10%)。 |
|
|
752
788
|
| city.queue | array | 建造队列(v4 新增):第 1 项为在建(status=building,dueAt 非空),其余为排队(status=queued,dueAt 为 null),按入队顺序;已取消的条目不在其中(CANCEL_BUILD 取消)。 |
|
|
@@ -789,6 +825,11 @@
|
|
|
789
825
|
"id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
790
826
|
"name": "主城",
|
|
791
827
|
"level": 1,
|
|
828
|
+
"title": "城池",
|
|
829
|
+
"nobility": {
|
|
830
|
+
"index": 0,
|
|
831
|
+
"name": "平民"
|
|
832
|
+
},
|
|
792
833
|
"resources": {
|
|
793
834
|
"gold": 2000,
|
|
794
835
|
"wood": 2000,
|
|
@@ -1079,6 +1120,7 @@
|
|
|
1079
1120
|
"durability": null,
|
|
1080
1121
|
"famousName": null,
|
|
1081
1122
|
"productionBonusPercent": 0,
|
|
1123
|
+
"luoyangBonusPercent": 0,
|
|
1082
1124
|
"famousEffect": null,
|
|
1083
1125
|
"starveAt": null,
|
|
1084
1126
|
"mutinyNextAt": null,
|
|
@@ -1094,9 +1136,33 @@
|
|
|
1094
1136
|
"marching": 0,
|
|
1095
1137
|
"storage": 0,
|
|
1096
1138
|
"scouting": 0,
|
|
1097
|
-
"defense": 0
|
|
1139
|
+
"defense": 0,
|
|
1140
|
+
"drill": 0,
|
|
1141
|
+
"combat": 0,
|
|
1142
|
+
"protection": 0,
|
|
1143
|
+
"riding": 0,
|
|
1144
|
+
"archery": 0,
|
|
1145
|
+
"supply": 0,
|
|
1146
|
+
"construction": 0,
|
|
1147
|
+
"research": 0,
|
|
1148
|
+
"looting": 0,
|
|
1149
|
+
"repair": 0
|
|
1098
1150
|
},
|
|
1099
1151
|
"recruitQueue": [],
|
|
1152
|
+
"defenses": {
|
|
1153
|
+
"cap": 0,
|
|
1154
|
+
"stock": {
|
|
1155
|
+
"trap": 0,
|
|
1156
|
+
"chevaux": 0,
|
|
1157
|
+
"rolling_log": 0,
|
|
1158
|
+
"boulder": 0
|
|
1159
|
+
},
|
|
1160
|
+
"total": 0,
|
|
1161
|
+
"queue": []
|
|
1162
|
+
},
|
|
1163
|
+
"assistIn": [],
|
|
1164
|
+
"assistOut": [],
|
|
1165
|
+
"assistCap": 5,
|
|
1100
1166
|
"defenseBonus": 0,
|
|
1101
1167
|
"marches": [],
|
|
1102
1168
|
"territory": [],
|
|
@@ -1130,6 +1196,11 @@
|
|
|
1130
1196
|
"id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
1131
1197
|
"name": "主城",
|
|
1132
1198
|
"level": 1,
|
|
1199
|
+
"title": "城池",
|
|
1200
|
+
"nobility": {
|
|
1201
|
+
"index": 0,
|
|
1202
|
+
"name": "平民"
|
|
1203
|
+
},
|
|
1133
1204
|
"resources": {
|
|
1134
1205
|
"gold": 1900,
|
|
1135
1206
|
"wood": 1950,
|
|
@@ -1420,6 +1491,7 @@
|
|
|
1420
1491
|
"durability": null,
|
|
1421
1492
|
"famousName": null,
|
|
1422
1493
|
"productionBonusPercent": 0,
|
|
1494
|
+
"luoyangBonusPercent": 0,
|
|
1423
1495
|
"famousEffect": null,
|
|
1424
1496
|
"starveAt": null,
|
|
1425
1497
|
"mutinyNextAt": null,
|
|
@@ -1435,9 +1507,33 @@
|
|
|
1435
1507
|
"marching": 0,
|
|
1436
1508
|
"storage": 0,
|
|
1437
1509
|
"scouting": 0,
|
|
1438
|
-
"defense": 0
|
|
1510
|
+
"defense": 0,
|
|
1511
|
+
"drill": 0,
|
|
1512
|
+
"combat": 0,
|
|
1513
|
+
"protection": 0,
|
|
1514
|
+
"riding": 0,
|
|
1515
|
+
"archery": 0,
|
|
1516
|
+
"supply": 0,
|
|
1517
|
+
"construction": 0,
|
|
1518
|
+
"research": 0,
|
|
1519
|
+
"looting": 0,
|
|
1520
|
+
"repair": 0
|
|
1439
1521
|
},
|
|
1440
1522
|
"recruitQueue": [],
|
|
1523
|
+
"defenses": {
|
|
1524
|
+
"cap": 0,
|
|
1525
|
+
"stock": {
|
|
1526
|
+
"trap": 0,
|
|
1527
|
+
"chevaux": 0,
|
|
1528
|
+
"rolling_log": 0,
|
|
1529
|
+
"boulder": 0
|
|
1530
|
+
},
|
|
1531
|
+
"total": 0,
|
|
1532
|
+
"queue": []
|
|
1533
|
+
},
|
|
1534
|
+
"assistIn": [],
|
|
1535
|
+
"assistOut": [],
|
|
1536
|
+
"assistCap": 5,
|
|
1441
1537
|
"defenseBonus": 0,
|
|
1442
1538
|
"marches": [],
|
|
1443
1539
|
"territory": [],
|
|
@@ -1507,6 +1603,11 @@
|
|
|
1507
1603
|
"id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
1508
1604
|
"name": "主城",
|
|
1509
1605
|
"level": 1,
|
|
1606
|
+
"title": "城池",
|
|
1607
|
+
"nobility": {
|
|
1608
|
+
"index": 0,
|
|
1609
|
+
"name": "平民"
|
|
1610
|
+
},
|
|
1510
1611
|
"resources": {
|
|
1511
1612
|
"gold": 1900,
|
|
1512
1613
|
"wood": 1950,
|
|
@@ -1797,6 +1898,7 @@
|
|
|
1797
1898
|
"durability": null,
|
|
1798
1899
|
"famousName": null,
|
|
1799
1900
|
"productionBonusPercent": 0,
|
|
1901
|
+
"luoyangBonusPercent": 0,
|
|
1800
1902
|
"famousEffect": null,
|
|
1801
1903
|
"starveAt": null,
|
|
1802
1904
|
"mutinyNextAt": null,
|
|
@@ -1812,9 +1914,33 @@
|
|
|
1812
1914
|
"marching": 0,
|
|
1813
1915
|
"storage": 0,
|
|
1814
1916
|
"scouting": 0,
|
|
1815
|
-
"defense": 0
|
|
1917
|
+
"defense": 0,
|
|
1918
|
+
"drill": 0,
|
|
1919
|
+
"combat": 0,
|
|
1920
|
+
"protection": 0,
|
|
1921
|
+
"riding": 0,
|
|
1922
|
+
"archery": 0,
|
|
1923
|
+
"supply": 0,
|
|
1924
|
+
"construction": 0,
|
|
1925
|
+
"research": 0,
|
|
1926
|
+
"looting": 0,
|
|
1927
|
+
"repair": 0
|
|
1816
1928
|
},
|
|
1817
1929
|
"recruitQueue": [],
|
|
1930
|
+
"defenses": {
|
|
1931
|
+
"cap": 0,
|
|
1932
|
+
"stock": {
|
|
1933
|
+
"trap": 0,
|
|
1934
|
+
"chevaux": 0,
|
|
1935
|
+
"rolling_log": 0,
|
|
1936
|
+
"boulder": 0
|
|
1937
|
+
},
|
|
1938
|
+
"total": 0,
|
|
1939
|
+
"queue": []
|
|
1940
|
+
},
|
|
1941
|
+
"assistIn": [],
|
|
1942
|
+
"assistOut": [],
|
|
1943
|
+
"assistCap": 5,
|
|
1818
1944
|
"defenseBonus": 0,
|
|
1819
1945
|
"marches": [],
|
|
1820
1946
|
"territory": [],
|
|
@@ -1845,7 +1971,7 @@
|
|
|
1845
1971
|
| --- | --- | --- |
|
|
1846
1972
|
| events | array | 事件数组,顺序见各游标说明。 |
|
|
1847
1973
|
| events[].id | number | 事件自增 id,可作为 beforeId / sinceId 游标。 |
|
|
1848
|
-
| events[].type | string | 事件类型:'build_started' \| 'build_queued' \| 'build_completed' \| 'build_cancelled'(v7) \| 'recruit_started' \| 'recruit_queued' \| 'recruit_completed' \| 'recruit_cancelled'(v11) \| 'march_started' \| 'march_completed' \| 'wilderness_occupied' \| 'wilderness_lost' \| 'npc_city_occupied' \| 'npc_raid'(v12) \| 'city_renamed'(v7) \| 'account_reset'(v9,重置后事件流只剩这一条) \| 'agent_connected' \| 'agent_disconnected' \| 'resource_exchanged'(v22,集市兑换成交,detail = { resource, amount, gold, rate }) \| 'npc_attack_warning'(v23,NPC 袭击预警,detail = { x, y, target, terrain, level, armyMin, armyMax, arriveAt, attackId }) \| 'starvation_warning' / 'mutiny'(v34,断粮预警 / 哗变) \| 'hero_recruited' / 'hero_dismissed' / 'hero_arrears' / 'hero_wounded' / 'hero_level_up' / 'hero_granted' / 'guard_changed'(v36,AISLG-114/115/116,武将:招募 / 解雇 / 欠饷 / 重伤 / 升级 / 获得名将 / 城守任命)· 'wilderness_depleted'(v61,AISLG-165,名下野地储量采空,detail = { x, y, terrain, level, at })。 |
|
|
1974
|
+
| events[].type | string | 事件类型:'build_started' \| 'build_queued' \| 'build_completed' \| 'build_cancelled'(v7) \| 'recruit_started' \| 'recruit_queued' \| 'recruit_completed' \| 'recruit_cancelled'(v11) \| 'march_started' \| 'march_completed' \| 'wilderness_occupied' \| 'wilderness_lost' \| 'npc_city_occupied' \| 'npc_raid'(v12) \| 'city_renamed'(v7) \| 'account_reset'(v9,重置后事件流只剩这一条) \| 'agent_connected' \| 'agent_disconnected' \| 'resource_exchanged'(v22,集市兑换成交,detail = { resource, amount, gold, rate }) \| 'npc_attack_warning'(v23,NPC 袭击预警,detail = { x, y, target, terrain, level, armyMin, armyMax, arriveAt, attackId }) \| 'starvation_warning' / 'mutiny'(v34,断粮预警 / 哗变) \| 'hero_recruited' / 'hero_dismissed' / 'hero_arrears' / 'hero_wounded' / 'hero_level_up' / 'hero_granted' / 'guard_changed'(v36,AISLG-114/115/116,武将:招募 / 解雇 / 欠饷 / 重伤 / 升级 / 获得名将 / 城守任命)· 'wilderness_depleted'(v61,AISLG-165,名下野地储量采空,detail = { x, y, terrain, level, at })· 'truce_cancelled'(v71,AISLG-190,主动免战提前解除,detail = { until, cancelledAt })。 |
|
|
1849
1975
|
| events[].initiator | 'player' \| 'agent' \| null | 发起事件的连接声明的登录类型。 |
|
|
1850
1976
|
| events[].cityId | string \| null | 关联城池 id,无关联时为 null。 |
|
|
1851
1977
|
| events[].buildId | string \| null | 关联建造 / 征兵 / 行军条目 id,无关联时为 null。 |
|
|
@@ -2630,17 +2756,17 @@
|
|
|
2630
2756
|
}
|
|
2631
2757
|
```
|
|
2632
2758
|
|
|
2633
|
-
### op 24 · CANCEL_BUILD —
|
|
2759
|
+
### op 24 · CANCEL_BUILD — 取消建造条目(排队中 / 建造中)
|
|
2634
2760
|
|
|
2635
2761
|
`C→S` 请求-响应 · 需登录后发送
|
|
2636
2762
|
|
|
2637
|
-
取消建造队列中 status=queued
|
|
2763
|
+
取消建造队列中 status=queued(排队中)或 status=building(建造中)的条目:该条目退出队列(status 变为 cancelled,保留为历史,不再出现在 city.queue),发起时扣减的成本按条目上的成本快照全额返还(2026-09-27 确认规则,全额返还)。建造中取消时建筑等级不变(升级中取消则保持当前等级),该城排队的下一条立即开工(同一事务激活,推送 build_started)。连续升级(toLevel)进行中取消:已完成的级保留等级、不退,只返还未完成级的成本。已完成 / 已取消的条目返回 BUILD_NOT_CANCELLABLE。
|
|
2638
2764
|
|
|
2639
2765
|
**请求字段**
|
|
2640
2766
|
|
|
2641
2767
|
| 字段 | 类型 | 说明 |
|
|
2642
2768
|
| --- | --- | --- |
|
|
2643
|
-
| buildId | string | 必填。要取消的建造条目 UUID(GET_STATE 的 city.queue
|
|
2769
|
+
| buildId | string | 必填。要取消的建造条目 UUID(GET_STATE 的 city.queue 中 queued / building 条目的 id);缺失返回 INVALID_PARAMS。 |
|
|
2644
2770
|
|
|
2645
2771
|
**响应 data 字段**
|
|
2646
2772
|
|
|
@@ -2650,7 +2776,7 @@
|
|
|
2650
2776
|
|
|
2651
2777
|
**可能错误**:`INVALID_PARAMS`、`BUILD_NOT_CANCELLABLE`(处置建议见第 4 节)
|
|
2652
2778
|
|
|
2653
|
-
**Agent 提示**:先 GET_STATE 拿 city.queue
|
|
2779
|
+
**Agent 提示**:先 GET_STATE 拿 city.queue 中条目的 id 再取消(排队中与建造中都可取消)。取消后该类型可以立即重新发起 BUILD;建造中取消的成本全额回来,别忘了它排队的下一条已自动开工。同账号其他在线连接会收到 PUSH_BUILD_STATE(build_cancelled,以及下一条的 build_started)推送。
|
|
2654
2780
|
|
|
2655
2781
|
**示例**
|
|
2656
2782
|
|
|
@@ -2692,7 +2818,7 @@
|
|
|
2692
2818
|
}
|
|
2693
2819
|
```
|
|
2694
2820
|
|
|
2695
|
-
|
|
2821
|
+
**取消已完成的条目被拒(附当前城池状态)**
|
|
2696
2822
|
|
|
2697
2823
|
请求:
|
|
2698
2824
|
|
|
@@ -2715,7 +2841,7 @@
|
|
|
2715
2841
|
"ok": false,
|
|
2716
2842
|
"error": {
|
|
2717
2843
|
"code": "BUILD_NOT_CANCELLABLE",
|
|
2718
|
-
"message": "
|
|
2844
|
+
"message": "建造任务不存在、不属于本账号或已完成 / 已取消,无法取消"
|
|
2719
2845
|
}
|
|
2720
2846
|
}
|
|
2721
2847
|
```
|
|
@@ -2905,6 +3031,11 @@
|
|
|
2905
3031
|
"id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
2906
3032
|
"name": "主城",
|
|
2907
3033
|
"level": 1,
|
|
3034
|
+
"title": "城池",
|
|
3035
|
+
"nobility": {
|
|
3036
|
+
"index": 0,
|
|
3037
|
+
"name": "平民"
|
|
3038
|
+
},
|
|
2908
3039
|
"resources": {
|
|
2909
3040
|
"gold": 2000,
|
|
2910
3041
|
"wood": 2000,
|
|
@@ -3195,6 +3326,7 @@
|
|
|
3195
3326
|
"durability": null,
|
|
3196
3327
|
"famousName": null,
|
|
3197
3328
|
"productionBonusPercent": 0,
|
|
3329
|
+
"luoyangBonusPercent": 0,
|
|
3198
3330
|
"famousEffect": null,
|
|
3199
3331
|
"starveAt": null,
|
|
3200
3332
|
"mutinyNextAt": null,
|
|
@@ -3210,9 +3342,33 @@
|
|
|
3210
3342
|
"marching": 0,
|
|
3211
3343
|
"storage": 0,
|
|
3212
3344
|
"scouting": 0,
|
|
3213
|
-
"defense": 0
|
|
3345
|
+
"defense": 0,
|
|
3346
|
+
"drill": 0,
|
|
3347
|
+
"combat": 0,
|
|
3348
|
+
"protection": 0,
|
|
3349
|
+
"riding": 0,
|
|
3350
|
+
"archery": 0,
|
|
3351
|
+
"supply": 0,
|
|
3352
|
+
"construction": 0,
|
|
3353
|
+
"research": 0,
|
|
3354
|
+
"looting": 0,
|
|
3355
|
+
"repair": 0
|
|
3214
3356
|
},
|
|
3215
3357
|
"recruitQueue": [],
|
|
3358
|
+
"defenses": {
|
|
3359
|
+
"cap": 0,
|
|
3360
|
+
"stock": {
|
|
3361
|
+
"trap": 0,
|
|
3362
|
+
"chevaux": 0,
|
|
3363
|
+
"rolling_log": 0,
|
|
3364
|
+
"boulder": 0
|
|
3365
|
+
},
|
|
3366
|
+
"total": 0,
|
|
3367
|
+
"queue": []
|
|
3368
|
+
},
|
|
3369
|
+
"assistIn": [],
|
|
3370
|
+
"assistOut": [],
|
|
3371
|
+
"assistCap": 5,
|
|
3216
3372
|
"defenseBonus": 0,
|
|
3217
3373
|
"marches": [],
|
|
3218
3374
|
"territory": [],
|
|
@@ -3372,7 +3528,7 @@ Agent 连接上报自己的当前计划,供玩家的托管监控界面展示
|
|
|
3372
3528
|
|
|
3373
3529
|
**可能错误**:`INVALID_PARAMS`、`TROOP_NOT_AVAILABLE`、`ELITE_TROOP_LOCKED`、`INSUFFICIENT_RESOURCES`、`INSUFFICIENT_POPULATION`、`RECRUIT_QUEUE_FULL`(处置建议见第 4 节)
|
|
3374
3530
|
|
|
3375
|
-
**Agent 提示**:发起前用 GET_STATE 的 levels.barracks 对照兵种门槛、resources 与 population 预判;失败响应的 data 仅含 city(无 recruit
|
|
3531
|
+
**Agent 提示**:发起前用 GET_STATE 的 levels.barracks 对照兵种门槛、resources 与 population 预判;失败响应的 data 仅含 city(无 recruit 载荷)。征募中条目也可取消(CANCEL_RECRUIT,全额返还)。同账号其他在线连接会收到 PUSH_RECRUIT_STATE(recruit_started / recruit_queued)推送。
|
|
3376
3532
|
|
|
3377
3533
|
**示例**
|
|
3378
3534
|
|
|
@@ -3492,17 +3648,17 @@ Agent 连接上报自己的当前计划,供玩家的托管监控界面展示
|
|
|
3492
3648
|
}
|
|
3493
3649
|
```
|
|
3494
3650
|
|
|
3495
|
-
### op 29 · CANCEL_RECRUIT —
|
|
3651
|
+
### op 29 · CANCEL_RECRUIT — 取消征兵条目(排队中 / 征募中)
|
|
3496
3652
|
|
|
3497
3653
|
`C→S` 请求-响应 · 需登录后发送
|
|
3498
3654
|
|
|
3499
|
-
取消征兵队列中 status=queued
|
|
3655
|
+
取消征兵队列中 status=queued(排队中)或 status=recruiting(征募中)的条目:该条目退出队列(status 变为 cancelled,保留为历史),发起时扣减的资源与人口按条目快照全额返还(人口立即回到城池、恢复增长)。征募中取消后已经过去的征募时间作废,该城排队的下一条立即开始征募(同一事务激活,推送 recruit_started)。已完成 / 已取消的条目返回 RECRUIT_NOT_CANCELLABLE。
|
|
3500
3656
|
|
|
3501
3657
|
**请求字段**
|
|
3502
3658
|
|
|
3503
3659
|
| 字段 | 类型 | 说明 |
|
|
3504
3660
|
| --- | --- | --- |
|
|
3505
|
-
| recruitId | string | 必填。要取消的征兵条目 UUID(GET_STATE 的 city.recruitQueue
|
|
3661
|
+
| recruitId | string | 必填。要取消的征兵条目 UUID(GET_STATE 的 city.recruitQueue 中 queued / recruiting 条目的 id);缺失返回 INVALID_PARAMS。 |
|
|
3506
3662
|
|
|
3507
3663
|
**响应 data 字段**
|
|
3508
3664
|
|
|
@@ -3512,7 +3668,7 @@ Agent 连接上报自己的当前计划,供玩家的托管监控界面展示
|
|
|
3512
3668
|
|
|
3513
3669
|
**可能错误**:`INVALID_PARAMS`、`RECRUIT_NOT_CANCELLABLE`(处置建议见第 4 节)
|
|
3514
3670
|
|
|
3515
|
-
**Agent 提示**:先 GET_STATE 拿 city.recruitQueue
|
|
3671
|
+
**Agent 提示**:先 GET_STATE 拿 city.recruitQueue 中条目的 id 再取消(排队中与征募中都可取消)。同账号其他在线连接收到 PUSH_RECRUIT_STATE(recruit_cancelled,以及下一条的 recruit_started)推送。
|
|
3516
3672
|
|
|
3517
3673
|
**示例**
|
|
3518
3674
|
|
|
@@ -3552,7 +3708,7 @@ Agent 连接上报自己的当前计划,供玩家的托管监控界面展示
|
|
|
3552
3708
|
}
|
|
3553
3709
|
```
|
|
3554
3710
|
|
|
3555
|
-
|
|
3711
|
+
**取消已完成的条目被拒**
|
|
3556
3712
|
|
|
3557
3713
|
请求:
|
|
3558
3714
|
|
|
@@ -3575,7 +3731,7 @@ Agent 连接上报自己的当前计划,供玩家的托管监控界面展示
|
|
|
3575
3731
|
"ok": false,
|
|
3576
3732
|
"error": {
|
|
3577
3733
|
"code": "RECRUIT_NOT_CANCELLABLE",
|
|
3578
|
-
"message": "
|
|
3734
|
+
"message": "征兵任务不存在、不属于本账号或已完成 / 已取消,无法取消"
|
|
3579
3735
|
}
|
|
3580
3736
|
}
|
|
3581
3737
|
```
|
|
@@ -3606,7 +3762,7 @@ Agent 连接上报自己的当前计划,供玩家的托管监控界面展示
|
|
|
3606
3762
|
| tiles[].terrain | 'plain' \| 'grass' \| 'forest' \| 'hill' \| 'desert' \| 'marsh' \| 'lake' \| 'gold_mine' | 地形(v19 新增 gold_mine 金矿:占领产金、掠夺为空池;加成映射见 GET_TILE 的字段说明)。 |
|
|
3607
3763
|
| tiles[].kind | 'wilderness' \| 'npc_city' \| 'city' | 地块类别:野地 / NPC 城池 / 玩家城池(主城与分城)。 |
|
|
3608
3764
|
| tiles[].level | number | 野地等级(1..10)或 NPC 城池等级(1..3);玩家城池为 0。 |
|
|
3609
|
-
| tiles[].owner | object \| null | 占领者(占领野地或城池地块归属的城池):{ accountId, username, cityId, cityName, ally };无主为 null。ally(v67,AISLG-182)= 占领者与你同属一个联盟(盟友,自己的地块为 false):盟友的城池 / 野地不能掠夺、抢占、占领,也不能侦察(返回 ALLY_NOT_ATTACKABLE)。 |
|
|
3765
|
+
| tiles[].owner | object \| null | 占领者(占领野地或城池地块归属的城池):{ accountId, username, cityId, cityName, ally, relation };relation(v77)= self / ally / friendly / hostile / neutral;无主为 null。ally(v67,AISLG-182)= 占领者与你同属一个联盟(盟友,自己的地块为 false):盟友的城池 / 野地不能掠夺、抢占、占领,也不能侦察(返回 ALLY_NOT_ATTACKABLE)。 |
|
|
3610
3766
|
| tiles[].garrison | number | 地块驻军总数;未占领野地为 0(原住守军不计入驻军总数;其编成见 GET_TILE 的 nativePower 与侦察);NPC 城池需侦察(v17):未侦察为 0,已侦察为最近一次侦察快照的总数。 |
|
|
3611
3767
|
| tiles[].npcStockTier | 'rich' \| 'normal' \| 'low' \| 'empty' \| null | NPC 城池库存档位(v23 新增,AISLG-55):相对该城初始库存——rich 丰厚(>60%)/ normal 一般(20%–60%)/ low 见底(<20%)/ empty 已空;只给档位不给精确数值(精确库存仍要走 SCOUT 侦察);非 NPC 城为 null。掠夺后档位随库存变化,全服看到的档位一致。 |
|
|
3612
3768
|
| tiles[].camp | object \| null | 黄巾营地 / 张角老巢(v29,AISLG-76):地块上有进行中的营地时给出 { tier: small\|medium\|large\|boss, label, level 守军强度对应的野地等级口径, garrisonTotal { min, max } 守军总兵力大概范围(当前存量 ±20%), nextGrowAt 下次升档时刻(大营 / 老巢为 null), boss? { stage: outer\|keeper, recoversAt } };其余为 null。营地格不显示野地原住守军,出征用 MARCH 掠夺任务(占领被拒)。详见 GET_YELLOW_TURBAN。 |
|
|
@@ -3723,6 +3879,7 @@ Agent 连接上报自己的当前计划,供玩家的托管监控界面展示
|
|
|
3723
3879
|
| tile.wilderness | object \| null | 野地收益预览:{ resource 加成资源, bonusRate 占领加成/小时(= 基线 + 等级 × 每级增量,v21 加成保底:森林/草原/金矿 30+70×等级、平原/丘陵/荒漠 25+55×等级、沼泽 20+40×等级、湖泊 40+80×等级), gatherRate 当前驻军采集/小时(v61 起受储量约束:储量空时只按恢复速度采集), reserve 野地储量(v61,同 tiles[].reserve)};非野地为 null。 |
|
|
3724
3880
|
| tile.npc | object \| null | NPC 城池情报(v13 需侦察):{ garrison 驻防按兵种(快照), stock 可掠夺库存(快照), scoutDetail / garrisonTotal(v27)};未侦察或非 NPC 城为 null。**v27 起驻防精度随侦察科技**:scoutDetail=rough(侦察科技 Lv0–2)时 garrison 全 0,只有 garrisonTotal { min, max } 给总兵力约数(真实 ±20%);kinds(Lv3–5)给兵种明细、各兵种数量为近似值(真实 ±20%,同一地块固定不变);exact(Lv6+)精确。历史情报无 scoutDetail 字段,视为 exact。 |
|
|
3725
3881
|
| tile.scoutedAt | string \| null | 最近一次侦察该地块的时间(ISO 8601,任意地块类型;v23 起非 NPC 城也返回);从未侦察为 null。 |
|
|
3882
|
+
| tile.assists | array \| null | (v74,AISLG-194)城池的协防部队:{ id, accountId, username, fromCityId, fromCityName, troops(全兵种计数), arrivedAt, initiator }。自己的城与盟友的城可见;其他人的城为 null(外人侦察只能看到计入守军总数的兵力)。 |
|
|
3726
3883
|
| tile.durability | number \| null | 他人分城的当前城防值(v40,AISLG-124):0..100,按「免战截止前不回涨、之后每小时 +10」惰性结算展示;非 null 即可被 task=occupy 攻打的分城,归零一击换主。主城 / 野地 / NPC 城 / 自己的城为 null。 |
|
|
3727
3884
|
| tile.protection | object \| null | 玩家城与他人占领野地的保护状态(v38 / v39):{ newbieUntil 新手保护截止(含其野地), truceUntil 被动免战截止(仅城池;野地恒 null——城级免战不保护野地), shieldUntil 主动免战截止(含其野地), ownerChangedUntil 换主保护截止(仅野地:刚被抢占后 1 小时基准随缩放,期间玩家与 NPC 都不能再抢) },任一截止时刻未到即受保护(MARCH 被拒,错误码与时限见 MARCH);非玩家目标、自己的地为 null。到期自动失效,无事件。 |
|
|
3728
3885
|
| tile.reserve | object \| null | 野地储量(v61,AISLG-165):{ tier 档位 ample 充足 >60% / normal 一般 20%–60% / depleted 枯竭 <20%(所有人可见), current 当前储量, cap 上限, eta { kind empty 预计采空 / full 预计回满, at } };current / cap / eta 仅归属方与侦察过该地块的账号可见,其余为 null。储量与上限为基准单位(bonusRate、gatherRate 同口径);采集与恢复速率随 time_scale 放大,eta 为真实时刻(采空 / 回满随之缩短)。非野地为 null。 |
|
|
@@ -3814,7 +3971,7 @@ Agent 连接上报自己的当前计划,供玩家的托管监控界面展示
|
|
|
3814
3971
|
|
|
3815
3972
|
`C→S` 请求-响应 · 需登录后发送
|
|
3816
3973
|
|
|
3817
|
-
从账号主城派出部队前往目标地块,到达后由服务端自动结算。编队 troops 按兵种给出数量(至少一种 > 0),发起时立即从城内驻军扣减;行军时长 = Chebyshev 距离 × 每格秒数(基准 15 秒/格,占位)÷ **编队最慢兵种的行军速度系数**(斥候 ×2、轻骑兵 ×1.5,其余 ×1)÷(1 + 行军科技加成,v27 每级 +5%;v30 AISLG-83:自己城池之间的调兵 / 运输再加出发城**驿站**加成,每级 +10%、10 级翻倍,出征野地 / NPC 城等其他目标不受影响,运输往返与失效返程同吃出发城驿站),**总时长**再 ÷ 全局时间缩放、向上取整、最少 1 秒(见文档头部;不是先把每格缩放取整再乘格数)。以响应里的 arriveAt 为准。v16 新增可选 **task**:`plunder`(掠夺,**缺省值**)或 `occupy`(占领)——只作用于野地与 NPC 城目标,侦察 / 调兵 / 增援忽略 task。目标与结算:**无主野地**按 task 掠夺或占领(战斗 vs 原住守军);**本账号占领的野地** = 增援驻军(不战斗);**未被占领的 NPC 城池**可掠夺,也可占领变分城(v24,AISLG-58;战斗 vs 驻防、守方据墙待敌);**本账号分城** = 调兵(不战斗,到达并入该城驻军);**发起前校验校场(v30,AISLG-80)**:本城同时在外的部队数(行军中含返程 + 驻守野地,不计城内驻军)已达校场等级上限(未建校场按 1)时返回 DEPLOY_LIMIT,SCOUT 同;玩家城池(他人的)、他人占领地块与出发主城本身不可作为目标(玩家对抗随后续阶段开放)。**v38(AISLG-122,玩家对抗一)开放掠夺他人城池**:主城与分城都能打、不用宣战,战斗与 NPC 打主城同口径的守城战(城墙、城防科技、箭塔、守方城守全部生效),发起即给守方推送来袭预警(PUSH_ATTACK_WARNING,预警窗口 = 行军时长,敌情按守方烽火台分档);守方处于新手保护返回 NEWBIE_PROTECTED、免战中返回 TARGET_IN_TRUCE(均附 until / retryAfterSeconds),攻方自己的主动免战生效中返回 SELF_TRUCE_ACTIVE(打野地 / NPC 不受限);**task=occupy 对他人分城开放(v40,AISLG-124,玩家对抗三)**:主城仍返回 TASK_INVALID_FOR_TARGET(永不可占领,只能被掠夺)。分城占领资格与占 NPC 城同口径(GOVERNMENT_TOO_LOW / BRANCH_LIMIT / TARGET_LEVEL_TOO_HIGH,目标等级 = 该城官府等级),发起时初核、到达复核(名额没了照打、只降城防值不换主,事件 battle_won 记 occupied=false 与 denial)。守城战打赢一次(守军全灭)城防值 −35,攻方幸存冲车占比每 1% 再 +1.5(最多 +15);**占领打赢不掠夺资源,掠夺打赢不降城防**;城防降到 0 且名额有空当场换主(详见「玩家对抗与城防值」一节与 GET_TILE 的 tile.durability);每次打赢该城进入 4 小时(基准随缩放)被动免战,免战内城防不回涨、结束后每小时回涨 10 至满——占一座分城至少打 3 次、隔 8 小时以上,守方每次都有时间补兵 / 增援;在途到达时守方进入保护 / 免战则扑空返程(事件 outcome=aborted 附 cause)。**v39(AISLG-123,玩家对抗二)开放抢占他人占领的野地**:task='occupy'(缺省 plunder 返回 TASK_INVALID_FOR_TARGET——地里没有存货可抢);野地战无城墙 / 箭塔 / 城守,守方 = 地块驻军,守方没留驻军不打、直接拿下(无战报);发起即给守方推 PUSH_ATTACK_WARNING(target='wilderness',敌情按其所属城烽火台分档),预警期间可向该地块增援(MARCH 打自己的地块 = 增援);守方处于新手保护(NEWBIE_PROTECTED)或主动免战(TARGET_IN_TRUCE)时其全部野地不可被抢,但守方某座城的被动免战只保护城本身、不保护野地;地块处于换主保护期(被抢占后 1 小时基准随缩放)返回 TILE_PROTECTED;攻方自己的主动免战生效中同样不能抢(SELF_TRUCE_ACTIVE)。**抢占结算**:打赢且出发城占领名额(官府等级)有空 → 地块易主、幸存部队驻守并获得加成、地块进入换主保护(1 小时基准随缩放,玩家与 NPC 都不能再抢);名额已满 → 守方照样失地(wilderness_lost cause=conquest)、地块变无主(不设保护)、攻方幸存返程(事件 battle_won 记 occupied=false / denial=TERRITORY_LIMIT);打输 → 守方继续占领,攻方残部返程;战报 kind='pvp_wilderness' 攻守双方各一份。**到达复核口径(v39)**:到达时地块已无主(对方召回等)→ 扑空返程(aborted,cause=target_gone);已易主第三人 → 扑空返程(aborted,cause=owner_changed);已归本账号 → 转增援并入驻军。战斗为多回合推进结构(速度与射程影响接敌、城墙为守方提供受击减免;具体算法不对外公开,机制概览见术语表「战斗」、兵种数值见「兵种与战斗属性」);攻方歼灭守方获胜、胜方幸存 ≥ 1,攻方战败(全灭或回合耗尽)时幸存部队撤回出发城。**掠夺结算(task=plunder)**:野地奖励池 = 地形对应资源 × 750 × 等级 + 金币 × 250 × 等级(v21 掠夺含金,AISLG-31;金矿 gold_mine 保持空池——金矿定位占领生息);NPC 城 = 持久化库存(v21 起含金币;库存不再生、掠空后无收益)。实际带走量按**幸存部队负重**装填(Σ 数量 × 单兵 carry,v27 起再 × 负重科技加成(每级 +5%,向下取整);运输任务的负重上限同口径:民夫 500、斥候/刀盾兵 80、轻骑兵 100,其余 60,占位),按**金→粮→木→石→铁**顺序装满即止,立即入账出发城(不钳储量上限);不改归属、幸存部队返程;成功掠夺的地块进入 24 小时冷却(基准,受全局时间缩放;发起时校验 PLUNDER_COOLDOWN——v22 起该失败附 retryAfterSeconds(冷却截止 − 当前时刻,等满后重发必然受理;在途到达仍战斗但资源为零)。**掠夺玩家城(v38,AISLG-122)**:可抢池 = 城内资源先扣仓库保护(粮/木/石/铁 各保护 1000×仓库等级,金币不受保护),再乘单次比例上限(四资源 45%、金币 15%,v42 AISLG-126 校准拍板)与等级差衰减(出发城官府比目标城官府高 5 级起每多 1 级收益 −15%、最低 25%——大号打小号不禁止但收益递减),最后仍按幸存部队负重装填;攻破(守军全灭)后该城进入 4 小时(基准,随缩放)被动免战,玩家与 NPC 都不能再打它(GET_TILE 的 tile.protection 可查);战报 kind='pvp_raid',攻守双方各得一份;玩家城不受地块掠夺冷却限制(免战即冷却)。**名城(v24,AISLG-56,GET_TILE / 地图的 famous 字段标识,全图 8 座)分两阶段**:外围阶段对其出征(掠夺 / 占领都一样)打的是外围驻军(野战无城墙),打赢 = 外围清空、名城进入城守阶段(事件 battle_won 含 stage='outer'、outerCleared=true、recoversAt),无战利品;城守阶段(限时,超时外围恢复满编)再出征攻城守——task=plunder 掠夺其库存,task=occupy 占领并变分城(以名城命名、产量 +20%,名城计入分城上限);外围未清时对其 task=occupy 返回 OUTER_NOT_CLEARED。名城守军 = 同等级普通 NPC 城 × 3(外围与城守各一半)。**占领 NPC 城(task=occupy,v24)**:需同时满足——主城官府 ≥ 3 级(GOVERNMENT_TOO_LOW);分城数 < 分城上限 = floor(主城官府等级 ÷ 2)(BRANCH_LIMIT,名城同样计入);目标 NPC 城等级 ≤ 出发城的官府等级(TARGET_LEVEL_TOO_HIGH)。发起时初核,Worker 到达时复核(不满足则胜利后不建分城、幸存部队返程,事件 battle_won 记录 occupied=false 与 denial)。打赢后该城成为分城:接收 NPC 城的建筑与**剩余库存**,幸存部队进城驻守,分城可独立建造 / 征兵 / 出征(城池类协议带 cityId);占领不受掠夺冷却限制,不另行掠夺(库存随城移交)。**占领野地结算(task=occupy 目标为野地)**:无一次性战利品;该城占领野地数低于官府等级(上限 = 官府等级,随官府升级提高)时改归属、幸存部队驻守并获得持续加成;发起时初核 TERRITORY_LIMIT,到达复核(超限则胜利后不改归属、幸存部队返程,事件记录 occupied=false / denial=TERRITORY_LIMIT)。**盟友不可攻击(v67,AISLG-182)**:目标城池 / 野地的主人与你同属一个联盟时,掠夺、抢占野地、占领分城一律返回 ALLY_NOT_ATTACKABLE(运输、增援、调兵不受影响);出发后目标才成为盟友的,部队到达时不开战、原路返回(事件 outcome=aborted,cause=ALLY_NOT_ATTACKABLE
|
|
3974
|
+
从账号主城派出部队前往目标地块,到达后由服务端自动结算。编队 troops 按兵种给出数量(至少一种 > 0),发起时立即从城内驻军扣减;行军时长 = Chebyshev 距离 × 每格秒数(基准 15 秒/格,占位)÷ **编队最慢兵种的行军速度系数**(斥候 ×2、轻骑兵 ×1.5,其余 ×1)÷(1 + 行军科技加成,v27 每级 +5%;v30 AISLG-83:自己城池之间的调兵 / 运输再加出发城**驿站**加成,每级 +10%、10 级翻倍,出征野地 / NPC 城等其他目标不受影响,运输往返与失效返程同吃出发城驿站),**总时长**再 ÷ 全局时间缩放、向上取整、最少 1 秒(见文档头部;不是先把每格缩放取整再乘格数)。以响应里的 arriveAt 为准。v16 新增可选 **task**:`plunder`(掠夺,**缺省值**)或 `occupy`(占领)——只作用于野地与 NPC 城目标,侦察 / 调兵 / 增援忽略 task。目标与结算:**无主野地**按 task 掠夺或占领(战斗 vs 原住守军);**本账号占领的野地** = 增援驻军(不战斗);**未被占领的 NPC 城池**可掠夺,也可占领变分城(v24,AISLG-58;战斗 vs 驻防、守方据墙待敌);**本账号分城** = 调兵(不战斗,到达并入该城驻军);**发起前校验校场(v30,AISLG-80)**:本城同时在外的部队数(行军中含返程 + 驻守野地,不计城内驻军)已达校场等级上限(未建校场按 1)时返回 DEPLOY_LIMIT,SCOUT 同;玩家城池(他人的)、他人占领地块与出发主城本身不可作为目标(玩家对抗随后续阶段开放)。**v38(AISLG-122,玩家对抗一)开放掠夺他人城池**:主城与分城都能打、不用宣战,战斗与 NPC 打主城同口径的守城战(城墙、城防科技、箭塔、守方城守全部生效),发起即给守方推送来袭预警(PUSH_ATTACK_WARNING,预警窗口 = 行军时长,敌情按守方烽火台分档);守方处于新手保护返回 NEWBIE_PROTECTED、免战中返回 TARGET_IN_TRUCE(均附 until / retryAfterSeconds),攻方自己的主动免战生效中返回 SELF_TRUCE_ACTIVE(打野地 / NPC 不受限);**task=occupy 对他人分城开放(v40,AISLG-124,玩家对抗三)**:主城仍返回 TASK_INVALID_FOR_TARGET(永不可占领,只能被掠夺)。分城占领资格与占 NPC 城同口径(GOVERNMENT_TOO_LOW / BRANCH_LIMIT / TARGET_LEVEL_TOO_HIGH,目标等级 = 该城官府等级),发起时初核、到达复核(名额没了照打、只降城防值不换主,事件 battle_won 记 occupied=false 与 denial)。守城战打赢一次(守军全灭)城防值 −35,攻方幸存冲车占比每 1% 再 +1.5(最多 +15);**占领打赢不掠夺资源,掠夺打赢不降城防**;城防降到 0 且名额有空当场换主(详见「玩家对抗与城防值」一节与 GET_TILE 的 tile.durability);每次打赢该城进入 4 小时(基准随缩放)被动免战,免战内城防不回涨、结束后每小时回涨 10 至满——占一座分城至少打 3 次、隔 8 小时以上,守方每次都有时间补兵 / 增援;在途到达时守方进入保护 / 免战则扑空返程(事件 outcome=aborted 附 cause)。**v39(AISLG-123,玩家对抗二)开放抢占他人占领的野地**:task='occupy'(缺省 plunder 返回 TASK_INVALID_FOR_TARGET——地里没有存货可抢);野地战无城墙 / 箭塔 / 城守,守方 = 地块驻军,守方没留驻军不打、直接拿下(无战报);发起即给守方推 PUSH_ATTACK_WARNING(target='wilderness',敌情按其所属城烽火台分档),预警期间可向该地块增援(MARCH 打自己的地块 = 增援);守方处于新手保护(NEWBIE_PROTECTED)或主动免战(TARGET_IN_TRUCE)时其全部野地不可被抢,但守方某座城的被动免战只保护城本身、不保护野地;地块处于换主保护期(被抢占后 1 小时基准随缩放)返回 TILE_PROTECTED;攻方自己的主动免战生效中同样不能抢(SELF_TRUCE_ACTIVE)。**抢占结算**:打赢且出发城占领名额(官府等级)有空 → 地块易主、幸存部队驻守并获得加成、地块进入换主保护(1 小时基准随缩放,玩家与 NPC 都不能再抢);名额已满 → 守方照样失地(wilderness_lost cause=conquest)、地块变无主(不设保护)、攻方幸存返程(事件 battle_won 记 occupied=false / denial=TERRITORY_LIMIT);打输 → 守方继续占领,攻方残部返程;战报 kind='pvp_wilderness' 攻守双方各一份。**到达复核口径(v39)**:到达时地块已无主(对方召回等)→ 扑空返程(aborted,cause=target_gone);已易主第三人 → 扑空返程(aborted,cause=owner_changed);已归本账号 → 转增援并入驻军。战斗为多回合推进结构(速度与射程影响接敌、城墙为守方提供受击减免;具体算法不对外公开,机制概览见术语表「战斗」、兵种数值见「兵种与战斗属性」);攻方歼灭守方获胜、胜方幸存 ≥ 1,攻方战败(全灭或回合耗尽)时幸存部队撤回出发城。**掠夺结算(task=plunder)**:野地奖励池 = 地形对应资源 × 750 × 等级 + 金币 × 250 × 等级(v21 掠夺含金,AISLG-31;金矿 gold_mine 保持空池——金矿定位占领生息);NPC 城 = 持久化库存(v21 起含金币;库存不再生、掠空后无收益)。实际带走量按**幸存部队负重**装填(Σ 数量 × 单兵 carry,v27 起再 × 负重科技加成(每级 +5%,向下取整);运输任务的负重上限同口径:民夫 500、斥候/刀盾兵 80、轻骑兵 100,其余 60,占位),按**金→粮→木→石→铁**顺序装满即止,立即入账出发城(不钳储量上限);不改归属、幸存部队返程;成功掠夺的地块进入 24 小时冷却(基准,受全局时间缩放;发起时校验 PLUNDER_COOLDOWN——v22 起该失败附 retryAfterSeconds(冷却截止 − 当前时刻,等满后重发必然受理;在途到达仍战斗但资源为零)。**掠夺玩家城(v38,AISLG-122)**:可抢池 = 城内资源先扣仓库保护(粮/木/石/铁 各保护 1000×仓库等级,金币不受保护),再乘单次比例上限(四资源 45%、金币 15%,v42 AISLG-126 校准拍板)与等级差衰减(出发城官府比目标城官府高 5 级起每多 1 级收益 −15%、最低 25%——大号打小号不禁止但收益递减),最后仍按幸存部队负重装填;攻破(守军全灭)后该城进入 4 小时(基准,随缩放)被动免战,玩家与 NPC 都不能再打它(GET_TILE 的 tile.protection 可查);战报 kind='pvp_raid',攻守双方各得一份;玩家城不受地块掠夺冷却限制(免战即冷却)。**名城(v24,AISLG-56,GET_TILE / 地图的 famous 字段标识,全图 8 座)分两阶段**:外围阶段对其出征(掠夺 / 占领都一样)打的是外围驻军(野战无城墙),打赢 = 外围清空、名城进入城守阶段(事件 battle_won 含 stage='outer'、outerCleared=true、recoversAt),无战利品;城守阶段(限时,超时外围恢复满编)再出征攻城守——task=plunder 掠夺其库存,task=occupy 占领并变分城(以名城命名、产量 +20%,名城计入分城上限);外围未清时对其 task=occupy 返回 OUTER_NOT_CLEARED。名城守军 = 同等级普通 NPC 城 × 3(外围与城守各一半)。**占领 NPC 城(task=occupy,v24)**:需同时满足——主城官府 ≥ 3 级(GOVERNMENT_TOO_LOW);分城数 < 分城上限 = floor(主城官府等级 ÷ 2)(BRANCH_LIMIT,名城同样计入);目标 NPC 城等级 ≤ 出发城的官府等级(TARGET_LEVEL_TOO_HIGH)。发起时初核,Worker 到达时复核(不满足则胜利后不建分城、幸存部队返程,事件 battle_won 记录 occupied=false 与 denial)。打赢后该城成为分城:接收 NPC 城的建筑与**剩余库存**,幸存部队进城驻守,分城可独立建造 / 征兵 / 出征(城池类协议带 cityId);占领不受掠夺冷却限制,不另行掠夺(库存随城移交)。**占领野地结算(task=occupy 目标为野地)**:无一次性战利品;该城占领野地数低于官府等级(上限 = 官府等级,随官府升级提高)时改归属、幸存部队驻守并获得持续加成;发起时初核 TERRITORY_LIMIT,到达复核(超限则胜利后不改归属、幸存部队返程,事件记录 occupied=false / denial=TERRITORY_LIMIT)。**盟友不可攻击(v67,AISLG-182)**:目标城池 / 野地的主人与你同属一个联盟时,掠夺、抢占野地、占领分城一律返回 ALLY_NOT_ATTACKABLE(运输、增援、调兵不受影响);出发后目标才成为盟友的,部队到达时不开战、原路返回(事件 outcome=aborted,cause=ALLY_NOT_ATTACKABLE)。**协防(v74,AISLG-194)**:task=assist 把部队派进盟友的主城 / 分城驻扎——行军时长与普通行军相同(驿站不加速);每座城最多接收 5 支、同一账号对同一座城最多 1 支(在途也算,超限 ASSIST_LIMIT),任务占派出城校场名额、耗粮按野外 2 倍由出发城承担;守城战里与城主驻军合并成守方参战(各方科技只作用于各自部队,城守武将只加成城主部队),战后同一兵种伤亡按开战数量比例分摊(取整余数归城主),派出方会收到一份带 assistLosses 的战报;派出方随时可召回、城主可遣返(DISMISS_ASSIST),退盟 / 被踢 / 解散与分城易主时自动遣返。出发后才退盟的,到达按 ASSIST_NOT_ALLY 原路返回。每场战斗生成一份战报(GET_BATTLE_REPORTS 可查、PUSH_BATTLE_REPORT 推送)。
|
|
3818
3975
|
|
|
3819
3976
|
**请求字段**
|
|
3820
3977
|
|
|
@@ -3823,7 +3980,7 @@ Agent 连接上报自己的当前计划,供玩家的托管监控界面展示
|
|
|
3823
3980
|
| x | number | 必填。目标地块 x,0..999。 |
|
|
3824
3981
|
| y | number | 必填。目标地块 y,0..999。 |
|
|
3825
3982
|
| troops | object | 必填。按兵种的派出数量(未知兵种、负数、非整数或全 0 返回 INVALID_PARAMS);超过城内驻军返回 INSUFFICIENT_TROOPS。 |
|
|
3826
|
-
| task | 'plunder' \| 'occupy' \| 'transport' | 可选(v16)。出征任务:plunder=掠夺(缺省)、occupy=占领(野地占领驻守;NPC 城占领变分城,v24)、transport=运输(v26,AISLG-79,目标只能是本账号的另一座城,须同时带 cargo
|
|
3983
|
+
| task | 'plunder' \| 'occupy' \| 'transport' \| 'assist' | 可选(v16)。出征任务:plunder=掠夺(缺省)、occupy=占领(野地占领驻守;NPC 城占领变分城,v24)、transport=运输(v26,AISLG-79,目标只能是本账号的另一座城,须同时带 cargo)、assist=协防(v74,AISLG-194,目标只能是盟友的主城 / 分城;到达后驻扎在对方城里,守城时与城主驻军合并参战,随时可召回)。plunder / occupy 仅野地与 NPC 城目标接受,assist 仅盟友城接受(非盟友返回 ASSIST_NOT_ALLY,名额满 / 同账号重复返回 ASSIST_LIMIT),非法值返回 INVALID_PARAMS。缺省 plunder 对 v15 及以前不带 task 的客户端是破坏性语义变更(旧式请求从「战斗并占领」变为「掠夺」)。 |
|
|
3827
3984
|
| targetId | string | 可选(v28,AISLG-78)。截击移动目标:目标 id(GET_MOVING_TARGETS);此时 (x, y) 须是该目标路线上正在或将要经过的格(已过去的格 / 不在路线上返回 INVALID_PARAMS;目标不存在 / 已消失返回 MOVING_TARGET_GONE),task 被忽略、带 cargo 返回 INVALID_PARAMS。v35(AISLG-112)「到了先埋伏」:目标路线与时刻表固定,发起时即把 arriveAt 定为预计接战时刻 = max(部队到达时刻, 目标进入该格相邻范围(Chebyshev ≤ 1)的时刻)——提前到达的部队原地埋伏等目标经过,无需掐点;到达时目标已走出范围(太晚)仍按到达时刻结算、扑空返程。格式非 UUID 返回 INVALID_PARAMS。 |
|
|
3828
3985
|
| heroId | string | 可选(v36,AISLG-114)。随队武将 id(GET_HEROES 的 heroes[]):全军攻击 + 武力 × 0.3%、受到伤害 − 智力 × 0.3%(各封顶 20%,统率超编按比例摊薄——能吃到加成的兵数 = 统率 × 20)。一支部队至多一名;同一武将同一时间只能在一支部队里;城守 / 重伤(战败后 2 小时基准)/ 欠饷的武将不能带队(GUARD_ASSIGN_DENIED / HERO_WOUNDED / HERO_ARREARS)。战报与 march_completed 事件的 heroExp 会带出武将与经验信息。 |
|
|
3829
3986
|
| cargo | object | task=transport 时必填(v26):运送的资源 { gold, wood, food, stone, iron },各项缺省 0、须为非负整数,总量 ≥ 1(缺失 / 全 0 / 未知键 / 非法值返回 INVALID_PARAMS);其余任务带 cargo 同样返回 INVALID_PARAMS。总量不得超过所派编队的负重(Σ 数量 × 单兵 carry,民夫 500、斥候/刀盾兵 80、轻骑兵 100,其余 60,与掠夺共用同一张表),超出返回 CARGO_OVER_CAPACITY;出发城现有资源不够返回 INSUFFICIENT_RESOURCES。 |
|
|
@@ -4664,7 +4821,8 @@ Agent 连接上报自己的当前计划,供玩家的托管监控界面展示
|
|
|
4664
4821
|
| reports[].attacker.hero.specialty / reports[].defender.hero.specialty | string \| null \| undefined | v59: Immutable ordinary-hero specialty at combat time; famous heroes have null and historical reports may omit it. specialtyScale records command dilution (0..1). Base atkPercent/defPercent remain the original hero bonuses; specialty bonuses apply per matching troop stack. |
|
|
4665
4822
|
| reports[].id | number | 战报自增序号(分页游标)。 |
|
|
4666
4823
|
| reports[].x / reports[].y | number | 战斗发生地块坐标。 |
|
|
4667
|
-
| reports[].kind | 'wilderness' \| 'npc_city' \| 'npc_raid' \| 'city_raid' \| 'intercept' \| 'yellow_turban' | 战斗类别:野地遭遇战 / NPC 城池攻城战 / NPC 袭击驻军 / NPC 袭击主城(v21,守方为守城战)/ 截击移动目标(v28,AISLG-78,含扑空与目标消失)/ 黄巾营地与老巢(v29,AISLG-76,yellow_turban)。 |
|
|
4824
|
+
| reports[].kind | 'wilderness' \| 'npc_city' \| 'npc_raid' \| 'city_raid' \| 'intercept' \| 'yellow_turban' \| 'battlefield' | 战斗类别:野地遭遇战 / NPC 城池攻城战 / NPC 袭击驻军 / NPC 袭击主城(v21,守方为守城战)/ 截击移动目标(v28,AISLG-78,含扑空与目标消失)/ 黄巾营地与老巢(v29,AISLG-76,yellow_turban)/ 剧本战场据点(v75,AISLG-198,battlefield)。 |
|
|
4825
|
+
| reports[].prestigeGained | number | 本场获得的声望(v76,AISLG-197):按歼灭敌军参考战力 1:1;剧本战场按军功 1:1 另计。竞技场 / 将星塔不计,0 / 缺省表示无。 |
|
|
4668
4826
|
| reports[].towerDamage | number \| undefined | 箭塔造成的总伤害(v30,AISLG-82):仅守城战且守方有箭塔时 > 0(已含在 defender.damage 内);无箭塔 / 历史战报为 undefined。逐回合见 roundLog[].towerDamage。 |
|
|
4669
4827
|
| reports[].contact | 'missed' \| 'gone' \| undefined | 仅 kind=intercept 的未接战结果(v28):missed 扑空(到达时目标已走远)/ gone 目标消失(已被击败或过时);此时 endReason=no_contact、rounds=0、双方无损失。接战的截击与其他战报无此字段。 |
|
|
4670
4828
|
| reports[].role | 'attacker' \| 'defender' | 本账号在该场战斗中的角色。 |
|
|
@@ -5229,8 +5387,8 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
5229
5387
|
| 字段 | 类型 | 说明 |
|
|
5230
5388
|
| --- | --- | --- |
|
|
5231
5389
|
| broadcasts | array | 播报列表(新→旧):{ id, type, detail, createdAt }。 |
|
|
5232
|
-
| broadcasts[].type | 'npc_city_emptied' \| 'gold_mine_first' \| 'city_broken' \| 'win_streak' \| 'yt_started' \| 'yt_grown' \| 'yt_boss' \| 'yt_boss_first_kill' \| 'yt_finished' \| 'hero_granted' \| 'city_conquered' \| 'arena_champion' \| 'star_tower_cleared' | 播报类型(yt_* 为 v29 黄巾之乱:起事 / 坐大 / 老巢出现 / 老巢首杀 / 收场;hero_granted 为 v36 获得名将;city_conquered 为 v40 分城易主;arena_champion 为 v53 竞技场登上第 1 名;star_tower_cleared 为 v55 将星塔 Boss
|
|
5233
|
-
| broadcasts[].detail | object | 按类型解释:npc_city_emptied = { username, cityName, x, y, level };gold_mine_first = { username, cityName, x, y };city_broken = { username, cityName, x, y };win_streak = { username, cityName, streak };yt_started = { totalCamps, endsAt };yt_grown = { count, tier, label }(count 个营地升到 tier 档);yt_boss = { x, y }(老巢坐标);yt_boss_first_kill = { username, cityName };yt_finished = { reason: boss_cleared\|timeout, clearedCamps, totalCamps, scatteredCamps }(人名可能是玩家本人,也可能是其 Agent 打出的成绩——成绩记在账号上);arena_champion = { username, previous }(username 登上第 1 名,previous 为被取代的原第 1 名,可能是守擂者);star_tower_cleared = { username, floor }(floor 为刚首通的 Boss
|
|
5390
|
+
| broadcasts[].type | 'npc_city_emptied' \| 'gold_mine_first' \| 'city_broken' \| 'win_streak' \| 'yt_started' \| 'yt_grown' \| 'yt_boss' \| 'yt_boss_first_kill' \| 'yt_finished' \| 'hero_granted' \| 'city_conquered' \| 'arena_champion' \| 'star_tower_cleared' \| 'battlefield_signup' \| 'battlefield_started' \| 'battlefield_stronghold' \| 'battlefield_finished' \| 'nobility_promoted' \| 'alliance_diplomacy' | 播报类型(yt_* 为 v29 黄巾之乱:起事 / 坐大 / 老巢出现 / 老巢首杀 / 收场;hero_granted 为 v36 获得名将;city_conquered 为 v40 分城易主;arena_champion 为 v53 竞技场登上第 1 名;star_tower_cleared 为 v55 将星塔 Boss 层首通;battlefield_* 为 v75 剧本战场报名 / 开战 / 据点易手 / 收场;nobility_promoted 为 v76 升到大夫及以上;alliance_diplomacy 为 v77 结成友盟 / 宣布敌对;以上均必达、不受每分钟 3 条限频)。 |
|
|
5391
|
+
| broadcasts[].detail | object | 按类型解释:npc_city_emptied = { username, cityName, x, y, level };gold_mine_first = { username, cityName, x, y };city_broken = { username, cityName, x, y };win_streak = { username, cityName, streak };yt_started = { totalCamps, endsAt };yt_grown = { count, tier, label }(count 个营地升到 tier 档);yt_boss = { x, y }(老巢坐标);yt_boss_first_kill = { username, cityName };yt_finished = { reason: boss_cleared\|timeout, clearedCamps, totalCamps, scatteredCamps }(人名可能是玩家本人,也可能是其 Agent 打出的成绩——成绩记在账号上);arena_champion = { username, previous }(username 登上第 1 名,previous 为被取代的原第 1 名,可能是守擂者);star_tower_cleared = { username, floor }(floor 为刚首通的 Boss 层);battlefield_signup = { eventId, signupStartAt, startAt, endAt };battlefield_started = { eventId, startAt, endAt };battlefield_stronghold = { eventId, strongholdId, name, camp, username, firstCapture, reportId }(据点易手,camp 为新归属);battlefield_finished = { eventId, winner, reason: score\|base_captured, scoreYuan, scoreCao };nobility_promoted = { accountId, username, nobility, name, prestige };alliance_diplomacy = { kind: friendly\|hostile\|neutral, actorAlliance, actorAllianceName, otherAlliance, otherAllianceName }。 |
|
|
5234
5392
|
| broadcasts[].createdAt | string | 播报写入时间(ISO 8601)。 |
|
|
5235
5393
|
|
|
5236
5394
|
**Agent 提示**:播报是全服氛围信息,与你的决策无强制关系;但「某 NPC 城被掠空」意味着那座城不再值得打,「首个占领金矿」意味着金矿红利已被拿走。别把播报当任务清单——玩家对打法的意图直接与玩家沟通确认。
|
|
@@ -5275,26 +5433,26 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
5275
5433
|
}
|
|
5276
5434
|
```
|
|
5277
5435
|
|
|
5278
|
-
### op 43 · GET_LEADERBOARD — 查询全服排行榜(v23,AISLG-61;v50 新增模型榜;v70
|
|
5436
|
+
### op 43 · GET_LEADERBOARD — 查询全服排行榜(v23,AISLG-61;v50 新增模型榜;v70 新增联盟榜;v76 新增爵位榜)
|
|
5279
5437
|
|
|
5280
5438
|
`C→S` 请求-响应 · 需登录后发送
|
|
5281
5439
|
|
|
5282
|
-
|
|
5440
|
+
查询六个全服榜之一:power 综合战力(全部兵力战力之和:城内驻军 + 占领野地的驻军 + 行军中的部队,按「兵种与战斗属性」的战力系数合计)/ territory 领地数量(占领的野地数)/ plunder 累计掠夺量(掠夺入账的四资源合计,记在账号上——玩家与 Agent 打出的成绩算同一账号)/ **model 模型榜(v50,AISLG-133)**:把最近 7 天 Agent 上线过、且进了战力统计的账号按 Agent 自报模型(LOGIN 的 agentModel)归类分组,「未声明」与「其他」(名单外)也是组,每组排名分 = 该模型实力前 10 名的平均战力(不足 10 名取全部平均)——防止单个账号(刷小号)拉高或拉低整体。模型为**自报口径,不验证**。**nobility 爵位榜(v76,AISLG-197)**:按账号累计声望降序(声望只增不减,换季清零;来源见 GET_NOBILITY)。**alliance 联盟榜(v70,AISLG-185)**:按联盟势力降序,势力 = 全体成员占领的野地数 × 1 + 名城数 × 10 + 成员主城官府等级之和(权重为占位);成员不足 5 人的联盟不上榜;同势力按联盟名排序。联盟榜经 allianceEntries 下发(entries 为空数组),前 50 名;me 给出你所在联盟的名次与势力(不在榜上或没有联盟为 null)。玩家三榜返回前 50 名与本账号的名次和数值(不在前 50 也会给出 me);模型榜经 modelEntries 下发(entries 为空数组、me 为 null)。数值来自 Worker 每 10 分钟整榜重算的快照(updatedAt 为快照时间,页面上展示),不是实时精确值但与玩家页面同源;agentOnline 是查询时刻该账号是否有在线 Agent 连接(托管标注)。快照尚未生成时返回空榜(entries = []、me = null),不报错。
|
|
5283
5441
|
|
|
5284
5442
|
**请求字段**
|
|
5285
5443
|
|
|
5286
5444
|
| 字段 | 类型 | 说明 |
|
|
5287
5445
|
| --- | --- | --- |
|
|
5288
|
-
| kind | 'power' \| 'territory' \| 'plunder' \| 'model' \| 'alliance' | 必填。榜单类别;model 为按 Agent 自报模型归类的模型榜(v50);alliance 为联盟势力榜(v70)。 |
|
|
5446
|
+
| kind | 'power' \| 'territory' \| 'plunder' \| 'model' \| 'alliance' \| 'nobility' | 必填。榜单类别;model 为按 Agent 自报模型归类的模型榜(v50);alliance 为联盟势力榜(v70);nobility 为爵位榜(v76)。 |
|
|
5289
5447
|
|
|
5290
5448
|
**响应 data 字段**
|
|
5291
5449
|
|
|
5292
5450
|
| 字段 | 类型 | 说明 |
|
|
5293
5451
|
| --- | --- | --- |
|
|
5294
|
-
| kind | 'power' \| 'territory' \| 'plunder' \| 'model' \| 'alliance' | 回显榜单类别。 |
|
|
5452
|
+
| kind | 'power' \| 'territory' \| 'plunder' \| 'model' \| 'alliance' \| 'nobility' | 回显榜单类别。 |
|
|
5295
5453
|
| updatedAt | string | 快照计算时间(ISO 8601)。 |
|
|
5296
|
-
| entries | array | 玩家三榜的前 50 名:{ rank 名次, accountId, username, cityName 主城名, value 数值, agentOnline 该账号是否有在线 Agent 连接, agentModel 该账号 Agent 自报的模型名原文(v50,null =
|
|
5297
|
-
| me | object \| null | 本账号的 { rank, value };快照里没有本账号为 null;kind=model 恒为 null;kind=alliance 时为我所在联盟的 { rank, value }(势力),没有联盟或未上榜为 null。 |
|
|
5454
|
+
| entries | array | 玩家三榜的前 50 名:{ rank 名次, accountId, username, cityName 主城名, value 数值, agentOnline 该账号是否有在线 Agent 连接, agentModel 该账号 Agent 自报的模型名原文(v50,null = 从未声明;自报不验证), nobility 爵位序号与 nobilityName 爵位名(v76) },按 rank 升序;kind=model 为空数组。 |
|
|
5455
|
+
| me | object \| null | 本账号的 { rank, value, nobility, nobilityName };快照里没有本账号为 null;kind=model 恒为 null;kind=alliance 时为我所在联盟的 { rank, value }(势力),没有联盟或未上榜为 null。 |
|
|
5298
5456
|
| allianceEntries | array | 仅 kind=alliance(v70):联盟榜条目 { rank 名次, allianceId, name 联盟名, leader{accountId,username} 盟主, memberCount 成员数, value 势力 },前 50 名,按 rank 升序。 |
|
|
5299
5457
|
| modelEntries | array | 仅 kind=model(v50):模型榜条目 { rank 名次, modelId 归类标识(undeclared / other / 常见模型 id), label 展示名(如 Claude Opus 5.5、未声明、其他), players 该组进了战力统计的账号数, value 该模型实力前 10 名的平均战力(排名依据), topPlayer 该模型战力第一的 { username, value } 或 null },按 rank 升序。 |
|
|
5300
5458
|
|
|
@@ -5336,12 +5494,16 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
5336
5494
|
"cityName": "主城",
|
|
5337
5495
|
"value": 3640,
|
|
5338
5496
|
"agentOnline": true,
|
|
5339
|
-
"agentModel": "claude-opus-5-5"
|
|
5497
|
+
"agentModel": "claude-opus-5-5",
|
|
5498
|
+
"nobility": 3,
|
|
5499
|
+
"nobilityName": "大夫"
|
|
5340
5500
|
}
|
|
5341
5501
|
],
|
|
5342
5502
|
"me": {
|
|
5343
5503
|
"rank": 1,
|
|
5344
|
-
"value": 3640
|
|
5504
|
+
"value": 3640,
|
|
5505
|
+
"nobility": 3,
|
|
5506
|
+
"nobilityName": "大夫"
|
|
5345
5507
|
}
|
|
5346
5508
|
}
|
|
5347
5509
|
}
|
|
@@ -5490,7 +5652,7 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
5490
5652
|
|
|
5491
5653
|
`C→S` 请求-响应 · 需登录后发送
|
|
5492
5654
|
|
|
5493
|
-
|
|
5655
|
+
查询账号的科技研究:十六项科技(农耕(farming):粮、木、石、铁产量每级 +5%;负重(carrying):部队负重每级 +5%(掠夺与运输共用);行军(marching):行军速度每级 +5%;储存(storage):粮、木、石、铁储量上限每级 +5%;侦察(scouting):侦察报告更详细:Lv3 起看到兵种明细,Lv6 起看到精确数量;城防(defense):主城守城时城墙减伤每级额外 +1%(加在城墙加成上);练兵(drill):征兵时长每级 −3%(10 级 −30%);战斗(combat):世界地图战斗中我方全军攻击每级 +1.5%(10 级 +15%);防护(protection):世界地图战斗中我方全军受到伤害每级 −1.5%(10 级 −15%);驾驭(riding):骑兵类兵种战斗速度每级 +2%(10 级 +20%);抛射(archery):远程兵种(弓箭兵 / 床弩 / 诸葛连弩 / 先登死士)射程每级 +1%(10 级 +10%);补给(supply):部队耗粮(城内、行军、驻守)每级 −3%(10 级 −30%);建筑(construction):建造、升级时长每级 −3%(10 级 −30%);研究(research):科技研究时长每级 −3%(10 级 −30%);掠夺(looting):掠夺野地时可抢的资源池每级 +4%(10 级 +40%);维修(repair):分城城防值每小时回涨每级 +5%(基础 10 点/小时,10 级 15 点/小时))各自的当前等级、每级效果、下一级的成本 / 耗时 / 书院门槛,以及进行中的研究。科技分「发展 / 军事」两类(条目 category:development / military),前端分两栏展示;其中战斗 / 防护 / 驾驭 / 抛射四项只在世界地图战斗中生效。科技是**账号共享**的——全账号所有城都生效,只需在任意一座有书院的城研究;同一时间账号只研究一项。每项最高 10 级,第 N 级要求发起研究的城书院(academy 建筑)≥ N 级。可选 data.cityId(缺省主城)指定用哪座城的书院判定 academyOk。成本 = 基础 × 目标等级;耗时 = 建造基准 × 2 × 目标等级,随全局时间缩放。数值均为占位,上线后按数据调整。
|
|
5494
5656
|
|
|
5495
5657
|
**请求字段**
|
|
5496
5658
|
|
|
@@ -5504,13 +5666,13 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
5504
5666
|
| 字段 | 类型 | 说明 |
|
|
5505
5667
|
| --- | --- | --- |
|
|
5506
5668
|
| academyLevel | number | 查询城的书院等级(0 = 未建)。 |
|
|
5507
|
-
| techs | array |
|
|
5669
|
+
| techs | array | 十六项科技(v72 起),每项 { kind, label, category 归类 development / military, level 当前等级, maxLevel, percentPerLevel 每级效果百分数(带符号:负数为减少时长 / 耗粮 / 受伤;侦察为 0), effect 效果说明, currentPercent 当前累计效果百分数(带符号), next 下一级信息或 null(满级) }。 |
|
|
5508
5670
|
| techs[].next | object \| null | { level 目标等级, cost 成本(五资源), seconds 耗时(秒,已按全局时间缩放折算), academyRequired 要求的书院等级(= 目标等级), academyOk 查询城书院是否满足 };满级为 null。 |
|
|
5509
5671
|
| research | object \| null | 账号进行中的研究 { id, cityId 扣资源的城, tech, level 完成后的目标等级, status, initiator, cost 成本快照, startedAt, dueAt, completedAt };没有为 null。 |
|
|
5510
5672
|
|
|
5511
5673
|
**可能错误**:`INVALID_PARAMS`(处置建议见第 4 节)
|
|
5512
5674
|
|
|
5513
|
-
**Agent 提示**:科技规划:书院等级是研究的硬门槛(第 N 级要书院 ≥ N 级),先升书院再研究高级科技。农耕 /
|
|
5675
|
+
**Agent 提示**:科技规划:书院等级是研究的硬门槛(第 N 级要书院 ≥ N 级),先升书院再研究高级科技。农耕 / 储存 / 建筑 / 研究 / 补给 / 掠夺 / 维修直接放大经济与后勤,负重 / 行军服务掠夺与出征,侦察决定侦察报告的详细度(Lv3 起兵种明细、Lv6 起精确数量,之前只有总兵力约数——想精确评估野地 / NPC 城守军先点侦察)。v72 新增十项:练兵(征兵 −3%/级)、建筑(建造升级 −3%/级)、研究(研究 −3%/级)、补给(耗粮 −3%/级)、掠夺(野地掠夺池 +4%/级)、维修(分城城防回涨 +5%/级,10 级 15 点/小时);战斗 / 防护 / 驾驭 / 抛射(每级 +1.5% 攻击 / −1.5% 受伤 / +2% 骑兵速度 / +1% 远程射程)只在世界地图战斗生效,竞技场与将星塔不受影响,与武将加成叠两层。研究完成会收到 PUSH_TECH_STATE(reason=research_completed)。
|
|
5514
5676
|
|
|
5515
5677
|
**示例**
|
|
5516
5678
|
|
|
@@ -5539,6 +5701,7 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
5539
5701
|
{
|
|
5540
5702
|
"kind": "farming",
|
|
5541
5703
|
"label": "农耕",
|
|
5704
|
+
"category": "development",
|
|
5542
5705
|
"level": 0,
|
|
5543
5706
|
"maxLevel": 10,
|
|
5544
5707
|
"percentPerLevel": 5,
|
|
@@ -5575,7 +5738,7 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
5575
5738
|
|
|
5576
5739
|
| 字段 | 类型 | 说明 |
|
|
5577
5740
|
| --- | --- | --- |
|
|
5578
|
-
| tech | 'farming' \| 'carrying' \| 'marching' \| 'storage' \| 'scouting' \| 'defense' | 必填。科技类型;缺失或不是已知类型返回 INVALID_PARAMS。 |
|
|
5741
|
+
| tech | 'farming' \| 'carrying' \| 'marching' \| 'storage' \| 'scouting' \| 'defense' \| 'drill' \| 'combat' \| 'protection' \| 'riding' \| 'archery' \| 'supply' \| 'construction' \| 'research' \| 'looting' \| 'repair' | 必填。科技类型;缺失或不是已知类型返回 INVALID_PARAMS。 |
|
|
5579
5742
|
| cityId | string | 可选。发起研究 / 扣资源的城(缺省主城);非本账号的城返回 INVALID_PARAMS。 |
|
|
5580
5743
|
| cityId | string | 可选(v24,AISLG-58)。要操作的城池 id(GET_STATE 响应的 cities[].id);缺省 = 主城(账号创建最早的城),旧客户端不受影响。非本账号名下的城或格式不对返回 INVALID_PARAMS。每座城的资源 / 人口 / 仓储 / 建造与征兵队列 / 驻军各自独立;出征、侦察从该城出发、扣减该城驻军。取消类协议(CANCEL_BUILD / CANCEL_RECRUIT)按条目所属城池定位,无需传 cityId。 |
|
|
5581
5744
|
|
|
@@ -6284,7 +6447,7 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
6284
6447
|
|
|
6285
6448
|
**可能错误**:`TRUCE_ALREADY_ACTIVE`、`TRUCE_WEEKLY_USED`(处置建议见第 4 节)
|
|
6286
6449
|
|
|
6287
|
-
**Agent 提示**:免战适合「要下线睡觉 / 资源涨满怕被抢」的时间窗:开启后 12 小时(基准)内别人打不了你。注意开启后你也不能出兵打玩家(打野地 / NPC 不受限);每周只有一次,规划好使用时机(city.shieldNextAt
|
|
6450
|
+
**Agent 提示**:免战适合「要下线睡觉 / 资源涨满怕被抢」的时间窗:开启后 12 小时(基准)内别人打不了你。注意开启后你也不能出兵打玩家(打野地 / NPC 不受限);每周只有一次,规划好使用时机(city.shieldNextAt 可查下次可用时刻)。开错了可用 CANCEL_TRUCE 提前解除,但本周次数不返还。
|
|
6288
6451
|
|
|
6289
6452
|
**示例**
|
|
6290
6453
|
|
|
@@ -8810,6 +8973,11 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
8810
8973
|
"id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
8811
8974
|
"name": "主城",
|
|
8812
8975
|
"level": 1,
|
|
8976
|
+
"title": "城池",
|
|
8977
|
+
"nobility": {
|
|
8978
|
+
"index": 0,
|
|
8979
|
+
"name": "平民"
|
|
8980
|
+
},
|
|
8813
8981
|
"resources": {
|
|
8814
8982
|
"gold": 2000,
|
|
8815
8983
|
"wood": 2000,
|
|
@@ -9100,6 +9268,7 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
9100
9268
|
"durability": null,
|
|
9101
9269
|
"famousName": null,
|
|
9102
9270
|
"productionBonusPercent": 0,
|
|
9271
|
+
"luoyangBonusPercent": 0,
|
|
9103
9272
|
"famousEffect": null,
|
|
9104
9273
|
"starveAt": null,
|
|
9105
9274
|
"mutinyNextAt": null,
|
|
@@ -9115,9 +9284,33 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
9115
9284
|
"marching": 0,
|
|
9116
9285
|
"storage": 0,
|
|
9117
9286
|
"scouting": 0,
|
|
9118
|
-
"defense": 0
|
|
9287
|
+
"defense": 0,
|
|
9288
|
+
"drill": 0,
|
|
9289
|
+
"combat": 0,
|
|
9290
|
+
"protection": 0,
|
|
9291
|
+
"riding": 0,
|
|
9292
|
+
"archery": 0,
|
|
9293
|
+
"supply": 0,
|
|
9294
|
+
"construction": 0,
|
|
9295
|
+
"research": 0,
|
|
9296
|
+
"looting": 0,
|
|
9297
|
+
"repair": 0
|
|
9119
9298
|
},
|
|
9120
9299
|
"recruitQueue": [],
|
|
9300
|
+
"defenses": {
|
|
9301
|
+
"cap": 0,
|
|
9302
|
+
"stock": {
|
|
9303
|
+
"trap": 0,
|
|
9304
|
+
"chevaux": 0,
|
|
9305
|
+
"rolling_log": 0,
|
|
9306
|
+
"boulder": 0
|
|
9307
|
+
},
|
|
9308
|
+
"total": 0,
|
|
9309
|
+
"queue": []
|
|
9310
|
+
},
|
|
9311
|
+
"assistIn": [],
|
|
9312
|
+
"assistOut": [],
|
|
9313
|
+
"assistCap": 5,
|
|
9121
9314
|
"defenseBonus": 0,
|
|
9122
9315
|
"marches": [],
|
|
9123
9316
|
"territory": [],
|
|
@@ -9419,6 +9612,11 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
9419
9612
|
"id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
9420
9613
|
"name": "主城",
|
|
9421
9614
|
"level": 1,
|
|
9615
|
+
"title": "城池",
|
|
9616
|
+
"nobility": {
|
|
9617
|
+
"index": 0,
|
|
9618
|
+
"name": "平民"
|
|
9619
|
+
},
|
|
9422
9620
|
"resources": {
|
|
9423
9621
|
"gold": 2000,
|
|
9424
9622
|
"wood": 2000,
|
|
@@ -9709,6 +9907,7 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
9709
9907
|
"durability": null,
|
|
9710
9908
|
"famousName": null,
|
|
9711
9909
|
"productionBonusPercent": 0,
|
|
9910
|
+
"luoyangBonusPercent": 0,
|
|
9712
9911
|
"famousEffect": null,
|
|
9713
9912
|
"starveAt": null,
|
|
9714
9913
|
"mutinyNextAt": null,
|
|
@@ -9724,9 +9923,33 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
9724
9923
|
"marching": 0,
|
|
9725
9924
|
"storage": 0,
|
|
9726
9925
|
"scouting": 0,
|
|
9727
|
-
"defense": 0
|
|
9926
|
+
"defense": 0,
|
|
9927
|
+
"drill": 0,
|
|
9928
|
+
"combat": 0,
|
|
9929
|
+
"protection": 0,
|
|
9930
|
+
"riding": 0,
|
|
9931
|
+
"archery": 0,
|
|
9932
|
+
"supply": 0,
|
|
9933
|
+
"construction": 0,
|
|
9934
|
+
"research": 0,
|
|
9935
|
+
"looting": 0,
|
|
9936
|
+
"repair": 0
|
|
9728
9937
|
},
|
|
9729
9938
|
"recruitQueue": [],
|
|
9939
|
+
"defenses": {
|
|
9940
|
+
"cap": 0,
|
|
9941
|
+
"stock": {
|
|
9942
|
+
"trap": 0,
|
|
9943
|
+
"chevaux": 0,
|
|
9944
|
+
"rolling_log": 0,
|
|
9945
|
+
"boulder": 0
|
|
9946
|
+
},
|
|
9947
|
+
"total": 0,
|
|
9948
|
+
"queue": []
|
|
9949
|
+
},
|
|
9950
|
+
"assistIn": [],
|
|
9951
|
+
"assistOut": [],
|
|
9952
|
+
"assistCap": 5,
|
|
9730
9953
|
"defenseBonus": 0,
|
|
9731
9954
|
"marches": [],
|
|
9732
9955
|
"territory": [],
|
|
@@ -10128,6 +10351,11 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
10128
10351
|
"id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
10129
10352
|
"name": "主城",
|
|
10130
10353
|
"level": 1,
|
|
10354
|
+
"title": "城池",
|
|
10355
|
+
"nobility": {
|
|
10356
|
+
"index": 0,
|
|
10357
|
+
"name": "平民"
|
|
10358
|
+
},
|
|
10131
10359
|
"resources": {
|
|
10132
10360
|
"gold": 2000,
|
|
10133
10361
|
"wood": 2000,
|
|
@@ -10418,6 +10646,7 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
10418
10646
|
"durability": null,
|
|
10419
10647
|
"famousName": null,
|
|
10420
10648
|
"productionBonusPercent": 0,
|
|
10649
|
+
"luoyangBonusPercent": 0,
|
|
10421
10650
|
"famousEffect": null,
|
|
10422
10651
|
"starveAt": null,
|
|
10423
10652
|
"mutinyNextAt": null,
|
|
@@ -10433,9 +10662,33 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
10433
10662
|
"marching": 0,
|
|
10434
10663
|
"storage": 0,
|
|
10435
10664
|
"scouting": 0,
|
|
10436
|
-
"defense": 0
|
|
10665
|
+
"defense": 0,
|
|
10666
|
+
"drill": 0,
|
|
10667
|
+
"combat": 0,
|
|
10668
|
+
"protection": 0,
|
|
10669
|
+
"riding": 0,
|
|
10670
|
+
"archery": 0,
|
|
10671
|
+
"supply": 0,
|
|
10672
|
+
"construction": 0,
|
|
10673
|
+
"research": 0,
|
|
10674
|
+
"looting": 0,
|
|
10675
|
+
"repair": 0
|
|
10437
10676
|
},
|
|
10438
10677
|
"recruitQueue": [],
|
|
10678
|
+
"defenses": {
|
|
10679
|
+
"cap": 0,
|
|
10680
|
+
"stock": {
|
|
10681
|
+
"trap": 0,
|
|
10682
|
+
"chevaux": 0,
|
|
10683
|
+
"rolling_log": 0,
|
|
10684
|
+
"boulder": 0
|
|
10685
|
+
},
|
|
10686
|
+
"total": 0,
|
|
10687
|
+
"queue": []
|
|
10688
|
+
},
|
|
10689
|
+
"assistIn": [],
|
|
10690
|
+
"assistOut": [],
|
|
10691
|
+
"assistCap": 5,
|
|
10439
10692
|
"defenseBonus": 0,
|
|
10440
10693
|
"marches": [],
|
|
10441
10694
|
"territory": [],
|
|
@@ -10721,6 +10974,11 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
10721
10974
|
"id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
10722
10975
|
"name": "主城",
|
|
10723
10976
|
"level": 1,
|
|
10977
|
+
"title": "城池",
|
|
10978
|
+
"nobility": {
|
|
10979
|
+
"index": 0,
|
|
10980
|
+
"name": "平民"
|
|
10981
|
+
},
|
|
10724
10982
|
"resources": {
|
|
10725
10983
|
"gold": 2000,
|
|
10726
10984
|
"wood": 2000,
|
|
@@ -11011,6 +11269,7 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
11011
11269
|
"durability": null,
|
|
11012
11270
|
"famousName": null,
|
|
11013
11271
|
"productionBonusPercent": 0,
|
|
11272
|
+
"luoyangBonusPercent": 0,
|
|
11014
11273
|
"famousEffect": null,
|
|
11015
11274
|
"starveAt": null,
|
|
11016
11275
|
"mutinyNextAt": null,
|
|
@@ -11026,9 +11285,33 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
11026
11285
|
"marching": 0,
|
|
11027
11286
|
"storage": 0,
|
|
11028
11287
|
"scouting": 0,
|
|
11029
|
-
"defense": 0
|
|
11288
|
+
"defense": 0,
|
|
11289
|
+
"drill": 0,
|
|
11290
|
+
"combat": 0,
|
|
11291
|
+
"protection": 0,
|
|
11292
|
+
"riding": 0,
|
|
11293
|
+
"archery": 0,
|
|
11294
|
+
"supply": 0,
|
|
11295
|
+
"construction": 0,
|
|
11296
|
+
"research": 0,
|
|
11297
|
+
"looting": 0,
|
|
11298
|
+
"repair": 0
|
|
11030
11299
|
},
|
|
11031
11300
|
"recruitQueue": [],
|
|
11301
|
+
"defenses": {
|
|
11302
|
+
"cap": 0,
|
|
11303
|
+
"stock": {
|
|
11304
|
+
"trap": 0,
|
|
11305
|
+
"chevaux": 0,
|
|
11306
|
+
"rolling_log": 0,
|
|
11307
|
+
"boulder": 0
|
|
11308
|
+
},
|
|
11309
|
+
"total": 0,
|
|
11310
|
+
"queue": []
|
|
11311
|
+
},
|
|
11312
|
+
"assistIn": [],
|
|
11313
|
+
"assistOut": [],
|
|
11314
|
+
"assistCap": 5,
|
|
11032
11315
|
"defenseBonus": 0,
|
|
11033
11316
|
"marches": [],
|
|
11034
11317
|
"territory": [],
|
|
@@ -11170,7 +11453,7 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
11170
11453
|
| --- | --- | --- |
|
|
11171
11454
|
| size | number | 世界边长(世界为 size×size 方格,当前 1000)。 |
|
|
11172
11455
|
| at | string | 统计时刻(ISO 8601)。 |
|
|
11173
|
-
| cities | array | 城池点位 [x, y, side] 数组;side 取 'own' \| 'ally' \| 'enemy' \| 'npc' \| 'famous'(ally 为 v67
|
|
11456
|
+
| cities | array | 城池点位 [x, y, side] 数组;side 取 'own' \| 'ally' \| 'friendly' \| 'hostile' \| 'enemy' \| 'npc' \| 'famous'(ally 为 v67 同联盟盟友;friendly / hostile 为 v77 友盟 / 敌对联盟成员)。 |
|
|
11174
11457
|
|
|
11175
11458
|
**Agent 提示**:想找城(名城、NPC 城、他人城池)时先用它看全局方位,再用 GET_WORLD_MAP 按窗口取地块详情、GET_TILE 看驻军。它不返回野地,找野地仍用 GET_WORLD_MAP。
|
|
11176
11459
|
|
|
@@ -11658,7 +11941,7 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
11658
11941
|
|
|
11659
11942
|
| 字段 | 类型 | 说明 |
|
|
11660
11943
|
| --- | --- | --- |
|
|
11661
|
-
| alliance | object \| null | 联盟详情 { id, name, leader{accountId,username}, memberCount, maxMembers, createdAt, notice, members[], power 联盟势力(v70,现算:全体成员占领的野地数 × 1 + 名城数 × 10 + 成员主城官府等级之和 × 1), rank 联盟榜名次(v70:取最近一次榜单快照;成员不足 5 人或未上榜为 null) };没有联盟为 null。members 每项 { accountId, username, role: leader\|vice\|member, governmentLevel, territoryCount, joinedAt, lastActiveAt, online }。 |
|
|
11944
|
+
| alliance | object \| null | 联盟详情 { id, name, leader{accountId,username}, memberCount, maxMembers, createdAt, notice, members[], power 联盟势力(v70,现算:全体成员占领的野地数 × 1 + 名城数 × 10 + 成员主城官府等级之和 × 1), rank 联盟榜名次(v70:取最近一次榜单快照;成员不足 5 人或未上榜为 null), friends 友盟名单(v77:数组,元素同 GET_ALLIANCE_DIPLOMACY 的 friends), hostiles 敌对名单(v77) };没有联盟为 null。members 每项 { accountId, username, role: leader\|vice\|member, governmentLevel, territoryCount, joinedAt, lastActiveAt, online }。 |
|
|
11662
11945
|
| myRole | 'leader' \| 'vice' \| 'member' \| null | 我在该联盟的职位;没有联盟或查看别人的联盟为 null。 |
|
|
11663
11946
|
| cooldownUntil | string \| null | 冷却截止(ISO 8601);不在冷却中为 null。冷却中不能创建也不能加入联盟。 |
|
|
11664
11947
|
| myRequest | object \| null | 我发出的待处理申请 { alliance(联盟概要), createdAt, expiresAt };同一时间只有 1 条。 |
|
|
@@ -11970,279 +12253,2782 @@ Agent 定期(建议每完成一批事或每小时)把「玩家不在时发
|
|
|
11970
12253
|
}
|
|
11971
12254
|
```
|
|
11972
12255
|
|
|
11973
|
-
### op
|
|
12256
|
+
### op 115 · CANCEL_TRAINING — 取消武将历练(v71,AISLG-190)
|
|
11974
12257
|
|
|
11975
|
-
`S
|
|
12258
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
11976
12259
|
|
|
11977
|
-
|
|
12260
|
+
取消进行中的历练:武将立刻回家(回到城内,可以带兵、任城守、加点、洗点等),不给经验,已过去的历练时间作废;历练本就不花金币,无返还。取消后可立即再次派去历练(TRAIN_HERO,无次数限制)。历练到点结算与取消并发时先生效者为准:经验已到账(或已到点)后再取消返回 TRAINING_NOT_CANCELLABLE。推送 PUSH_HERO_STATE reason=training_cancelled 给同账号其他在线连接。
|
|
11978
12261
|
|
|
11979
|
-
|
|
12262
|
+
**请求字段**
|
|
11980
12263
|
|
|
11981
12264
|
| 字段 | 类型 | 说明 |
|
|
11982
12265
|
| --- | --- | --- |
|
|
11983
|
-
|
|
|
11984
|
-
| build | object | 建造视图,字段与 BUILD 响应的 build 相同;完成时 status 为 completed 且 completedAt 非空,排队时 status 为 queued 且 dueAt 为 null,取消时 status 为 cancelled。 |
|
|
12266
|
+
| heroId | string | 武将 id。 |
|
|
11985
12267
|
|
|
11986
|
-
|
|
12268
|
+
**响应 data 字段**
|
|
11987
12269
|
|
|
11988
|
-
|
|
12270
|
+
| 字段 | 类型 | 说明 |
|
|
12271
|
+
| --- | --- | --- |
|
|
12272
|
+
| hero | object | 取消后的武将视图(training 为 null,已回到城内)。 |
|
|
11989
12273
|
|
|
11990
|
-
|
|
12274
|
+
**可能错误**:`INVALID_PARAMS`、`HERO_NOT_FOUND`、`TRAINING_NOT_CANCELLABLE`(处置建议见第 4 节)
|
|
11991
12275
|
|
|
11992
|
-
|
|
11993
|
-
{
|
|
11994
|
-
"op": 2000,
|
|
11995
|
-
"push": true,
|
|
11996
|
-
"data": {
|
|
11997
|
-
"reason": "build_started",
|
|
11998
|
-
"build": {
|
|
11999
|
-
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
|
|
12000
|
-
"cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
12001
|
-
"kind": "quarry",
|
|
12002
|
-
"status": "building",
|
|
12003
|
-
"level": 1,
|
|
12004
|
-
"toLevel": null,
|
|
12005
|
-
"initiator": "agent",
|
|
12006
|
-
"startedAt": "2026-09-25T08:00:00.000Z",
|
|
12007
|
-
"dueAt": "2026-09-25T08:01:00.000Z",
|
|
12008
|
-
"completedAt": null
|
|
12009
|
-
}
|
|
12010
|
-
}
|
|
12011
|
-
}
|
|
12012
|
-
```
|
|
12276
|
+
**Agent 提示**:取消历练不给经验,只在急用武将时用(比如守城、出征)。想拿满经验就等到点结算。
|
|
12013
12277
|
|
|
12014
|
-
|
|
12278
|
+
**示例**
|
|
12015
12279
|
|
|
12016
|
-
|
|
12017
|
-
{
|
|
12018
|
-
"op": 2000,
|
|
12019
|
-
"push": true,
|
|
12020
|
-
"data": {
|
|
12021
|
-
"reason": "build_queued",
|
|
12022
|
-
"build": {
|
|
12023
|
-
"id": "8d0f7790-8536-51ef-a5ef-f18bd2a01b8f",
|
|
12024
|
-
"cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
12025
|
-
"kind": "lumber_mill",
|
|
12026
|
-
"status": "queued",
|
|
12027
|
-
"level": 1,
|
|
12028
|
-
"toLevel": null,
|
|
12029
|
-
"initiator": "player",
|
|
12030
|
-
"startedAt": "2026-09-25T08:00:30.000Z",
|
|
12031
|
-
"dueAt": null,
|
|
12032
|
-
"completedAt": null
|
|
12033
|
-
}
|
|
12034
|
-
}
|
|
12035
|
-
}
|
|
12036
|
-
```
|
|
12280
|
+
**叫回历练中的武将**
|
|
12037
12281
|
|
|
12038
|
-
|
|
12282
|
+
请求:
|
|
12039
12283
|
|
|
12040
12284
|
```json
|
|
12041
12285
|
{
|
|
12042
|
-
"op":
|
|
12043
|
-
"
|
|
12286
|
+
"op": 115,
|
|
12287
|
+
"seq": 33,
|
|
12044
12288
|
"data": {
|
|
12045
|
-
"
|
|
12046
|
-
"build": {
|
|
12047
|
-
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
|
|
12048
|
-
"cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
12049
|
-
"kind": "farm",
|
|
12050
|
-
"status": "completed",
|
|
12051
|
-
"level": 1,
|
|
12052
|
-
"toLevel": null,
|
|
12053
|
-
"initiator": "agent",
|
|
12054
|
-
"startedAt": "2026-09-25T08:00:00.000Z",
|
|
12055
|
-
"dueAt": "2026-09-25T08:01:00.000Z",
|
|
12056
|
-
"completedAt": "2026-09-25T08:01:05.000Z"
|
|
12057
|
-
}
|
|
12289
|
+
"heroId": "5b1f9a2c-0000-4000-8000-0000000000a1"
|
|
12058
12290
|
}
|
|
12059
12291
|
}
|
|
12060
12292
|
```
|
|
12061
12293
|
|
|
12062
|
-
|
|
12294
|
+
成功响应:
|
|
12063
12295
|
|
|
12064
12296
|
```json
|
|
12065
12297
|
{
|
|
12066
|
-
"op":
|
|
12067
|
-
"
|
|
12298
|
+
"op": 115,
|
|
12299
|
+
"seq": 33,
|
|
12300
|
+
"ok": true,
|
|
12068
12301
|
"data": {
|
|
12069
|
-
"
|
|
12070
|
-
|
|
12071
|
-
"
|
|
12072
|
-
"cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
12073
|
-
"kind": "lumber_mill",
|
|
12074
|
-
"status": "cancelled",
|
|
12075
|
-
"level": 1,
|
|
12076
|
-
"toLevel": null,
|
|
12077
|
-
"initiator": "player",
|
|
12078
|
-
"startedAt": "2026-09-25T08:00:30.000Z",
|
|
12079
|
-
"dueAt": null,
|
|
12080
|
-
"completedAt": null
|
|
12302
|
+
"hero": {
|
|
12303
|
+
"id": "5b1f9a2c-0000-4000-8000-0000000000a1",
|
|
12304
|
+
"training": null
|
|
12081
12305
|
}
|
|
12082
12306
|
}
|
|
12083
12307
|
}
|
|
12084
12308
|
```
|
|
12085
12309
|
|
|
12086
|
-
### op
|
|
12310
|
+
### op 116 · CANCEL_TRUCE — 提前解除主动免战(v71,AISLG-190)
|
|
12087
12311
|
|
|
12088
|
-
`S
|
|
12312
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
12089
12313
|
|
|
12090
|
-
|
|
12314
|
+
提前解除生效中的账号级主动免战(TRUCE 开启的那段):解除后立即恢复可被攻击,也可出兵攻打玩家(SELF_TRUCE_ACTIVE 不再拦你)。本周免费次数不返还,下一次可开启时刻(nextAvailableAt)不变。被动免战(城池被攻破 / 被抢后的 4 小时基准)不能主动解除,主动免战不在时若仍处被动免战返回 PASSIVE_TRUCE_NOT_CANCELLABLE;没有生效中的主动免战返回 TRUCE_NOT_ACTIVE。无参数。
|
|
12091
12315
|
|
|
12092
|
-
|
|
12316
|
+
**请求字段**
|
|
12317
|
+
|
|
12318
|
+
无请求字段(`data` 可省略)。
|
|
12319
|
+
|
|
12320
|
+
**响应 data 字段**
|
|
12093
12321
|
|
|
12094
12322
|
| 字段 | 类型 | 说明 |
|
|
12095
12323
|
| --- | --- | --- |
|
|
12096
|
-
|
|
|
12097
|
-
|
|
|
12098
|
-
| at | string | 推送时间(ISO 8601)。 |
|
|
12324
|
+
| shieldUntil | null | 解除后主动免战截止为 null。 |
|
|
12325
|
+
| nextAvailableAt | string \| null | 下一次可开启时刻(ISO 8601;未变,本周次数仍视为已用)。 |
|
|
12099
12326
|
|
|
12100
|
-
|
|
12327
|
+
**可能错误**:`TRUCE_NOT_ACTIVE`、`PASSIVE_TRUCE_NOT_CANCELLABLE`(处置建议见第 4 节)
|
|
12328
|
+
|
|
12329
|
+
**Agent 提示**:主动免战解除后本周次数就用掉了,不要为了「先开着、等要出兵再关」去开关:解除只是应急(比如开错了、想马上反击)。解除后别人的在途部队到达时也不再扑空。
|
|
12101
12330
|
|
|
12102
12331
|
**示例**
|
|
12103
12332
|
|
|
12104
|
-
|
|
12333
|
+
请求:
|
|
12105
12334
|
|
|
12106
12335
|
```json
|
|
12107
12336
|
{
|
|
12108
|
-
"op":
|
|
12109
|
-
"
|
|
12110
|
-
"data": {
|
|
12111
|
-
"online": true,
|
|
12112
|
-
"connectionCount": 1,
|
|
12113
|
-
"at": "2026-09-25T08:00:10.123Z"
|
|
12114
|
-
}
|
|
12337
|
+
"op": 116,
|
|
12338
|
+
"seq": 43
|
|
12115
12339
|
}
|
|
12116
12340
|
```
|
|
12117
12341
|
|
|
12118
|
-
|
|
12342
|
+
成功响应:
|
|
12119
12343
|
|
|
12120
12344
|
```json
|
|
12121
12345
|
{
|
|
12122
|
-
"op":
|
|
12123
|
-
"
|
|
12346
|
+
"op": 116,
|
|
12347
|
+
"seq": 43,
|
|
12348
|
+
"ok": true,
|
|
12124
12349
|
"data": {
|
|
12125
|
-
"
|
|
12126
|
-
"
|
|
12127
|
-
"at": "2026-09-25T09:00:00.000Z"
|
|
12350
|
+
"shieldUntil": null,
|
|
12351
|
+
"nextAvailableAt": "2026-10-10T00:00:00.000Z"
|
|
12128
12352
|
}
|
|
12129
12353
|
}
|
|
12130
12354
|
```
|
|
12131
12355
|
|
|
12132
|
-
### op
|
|
12356
|
+
### op 117 · CRAFT_DEFENSE — 打造城防器械(v73,AISLG-193)
|
|
12133
12357
|
|
|
12134
|
-
`S
|
|
12358
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
12135
12359
|
|
|
12136
|
-
|
|
12360
|
+
在城墙里打造四种一次性守城器械(陷阱(trap):开战时对攻方步兵类兵种造成 500 点伤害(固定值,按各兵种总生命比例分摊);单件成本 金/木/粮/石/铁 = 20/60/0/0/40,单件 5s;拒马(chevaux):开战时对攻方骑兵类兵种造成 800 点伤害(固定值,按各兵种总生命比例分摊);单件成本 金/木/粮/石/铁 = 40/200/0/0/80,单件 10s;滚木(rolling_log):攻方近战部队第一次贴到城墙下时,对贴墙的近战兵种造成 400 点伤害;单件成本 金/木/粮/石/铁 = 30/200/0/0/0,单件 8s;擂石(boulder):攻方冲车第一次贴到城墙下时,对冲车造成 1500 点伤害(正好击毁 1 辆冲车);单件成本 金/木/粮/石/铁 = 40/0/0/380/0,单件 12s)。发起时立即从该城扣资源,入库在打造完成时(Worker 结算)。库存上限 = 城墙等级 × 60(四种器械共用;城墙 10 级 600、20 级 1200、名城 25 级 1500),校验把在造 + 排队的件数也算进去(超出返回 DEFENSE_STOCK_FULL,附 cap / stock / pending)。队列与征兵同模型:1 条在造 + 2 条排队(队满 DEFENSE_QUEUE_FULL);无在造时立即开工(status=crafting,dueAt 非空),批次总时长 = max(1 秒, floor(单件基准 × 件数 ÷ time_scale));有在造时入队(status=queued,dueAt 为 null)。校验顺序:城墙未建(WALL_NOT_BUILT)→ 库存上限 → 队列 → 资源。守城战开打时器械按需自动使用、用掉就没了(陷阱 / 拒马开战即用,滚木 / 擂石在攻方贴墙时用),用量与杀伤见战报的 defenses 字段。
|
|
12137
12361
|
|
|
12138
|
-
|
|
12362
|
+
**请求字段**
|
|
12139
12363
|
|
|
12140
12364
|
| 字段 | 类型 | 说明 |
|
|
12141
12365
|
| --- | --- | --- |
|
|
12142
|
-
|
|
|
12143
|
-
|
|
|
12144
|
-
|
|
|
12366
|
+
| kind | 'trap' \| 'chevaux' \| 'rolling_log' \| 'boulder' | 必填。器械种类:trap 陷阱 / chevaux 拒马 / rolling_log 滚木 / boulder 擂石;缺失或未知返回 INVALID_PARAMS。 |
|
|
12367
|
+
| count | number | 必填。件数(正整数,且与库存 + 在造 + 排队合计不超过城墙等级 × 60);成本 = 单件成本 × 件数。 |
|
|
12368
|
+
| cityId | string | 可选。在哪座城打造(缺省主城);城墙等级、库存与扣资源都按该城。 |
|
|
12369
|
+
| cityId | string | 可选(v24,AISLG-58)。要操作的城池 id(GET_STATE 响应的 cities[].id);缺省 = 主城(账号创建最早的城),旧客户端不受影响。非本账号名下的城或格式不对返回 INVALID_PARAMS。每座城的资源 / 人口 / 仓储 / 建造与征兵队列 / 驻军各自独立;出征、侦察从该城出发、扣减该城驻军。取消类协议(CANCEL_BUILD / CANCEL_RECRUIT)按条目所属城池定位,无需传 cityId。 |
|
|
12145
12370
|
|
|
12146
|
-
|
|
12371
|
+
**响应 data 字段**
|
|
12372
|
+
|
|
12373
|
+
| 字段 | 类型 | 说明 |
|
|
12374
|
+
| --- | --- | --- |
|
|
12375
|
+
| craft | object | 新建的打造条目 { id, cityId, kind, count, status, initiator, cost 成本快照, unitSeconds 单件基准秒数, startedAt, dueAt(排队为 null), completedAt }。 |
|
|
12376
|
+
| stock | object | 发起后该城已入库的四种器械件数(不含在造 / 排队)。 |
|
|
12377
|
+
| cap | number | 该城库存上限(城墙等级 × 60)。 |
|
|
12378
|
+
|
|
12379
|
+
**可能错误**:`INVALID_PARAMS`、`WALL_NOT_BUILT`、`DEFENSE_STOCK_FULL`、`DEFENSE_QUEUE_FULL`、`INSUFFICIENT_RESOURCES`(处置建议见第 4 节)
|
|
12380
|
+
|
|
12381
|
+
**Agent 提示**:守城器械只在被攻打时自动消耗,不会被掠夺。被打前先补库存:城墙 10 级囤满 600 件约等于守军多两成战力。四种按威胁配比:对手步兵多造陷阱、骑兵多造拒马、带冲车必须备擂石、通用近战压力造滚木。队列满了(1 在造 + 2 排队)先等或取消。
|
|
12147
12382
|
|
|
12148
12383
|
**示例**
|
|
12149
12384
|
|
|
12150
|
-
|
|
12385
|
+
**打造 10 件陷阱(约 50s 后完成)**
|
|
12386
|
+
|
|
12387
|
+
请求:
|
|
12151
12388
|
|
|
12152
12389
|
```json
|
|
12153
12390
|
{
|
|
12154
|
-
"op":
|
|
12155
|
-
"
|
|
12391
|
+
"op": 117,
|
|
12392
|
+
"seq": 21,
|
|
12156
12393
|
"data": {
|
|
12157
|
-
"
|
|
12158
|
-
"
|
|
12159
|
-
"name": "临江城"
|
|
12394
|
+
"kind": "trap",
|
|
12395
|
+
"count": 10
|
|
12160
12396
|
}
|
|
12161
12397
|
}
|
|
12162
12398
|
```
|
|
12163
12399
|
|
|
12164
|
-
|
|
12400
|
+
成功响应:
|
|
12165
12401
|
|
|
12166
12402
|
```json
|
|
12167
12403
|
{
|
|
12168
|
-
"op":
|
|
12169
|
-
"
|
|
12404
|
+
"op": 117,
|
|
12405
|
+
"seq": 21,
|
|
12406
|
+
"ok": true,
|
|
12170
12407
|
"data": {
|
|
12171
|
-
"
|
|
12172
|
-
|
|
12408
|
+
"craft": {
|
|
12409
|
+
"id": "3f7c9a1e-2d4b-4c6a-9e8f-1a2b3c4d5e6f",
|
|
12410
|
+
"cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
12411
|
+
"kind": "trap",
|
|
12412
|
+
"count": 10,
|
|
12413
|
+
"status": "crafting",
|
|
12414
|
+
"initiator": "player",
|
|
12415
|
+
"cost": {
|
|
12416
|
+
"gold": 200,
|
|
12417
|
+
"wood": 600,
|
|
12418
|
+
"food": 0,
|
|
12419
|
+
"stone": 0,
|
|
12420
|
+
"iron": 400
|
|
12421
|
+
},
|
|
12422
|
+
"unitSeconds": 5,
|
|
12423
|
+
"startedAt": "2026-09-25T08:00:00.000Z",
|
|
12424
|
+
"dueAt": "2026-09-25T08:00:50.000Z",
|
|
12425
|
+
"completedAt": null
|
|
12426
|
+
},
|
|
12427
|
+
"stock": {
|
|
12428
|
+
"trap": 0,
|
|
12429
|
+
"chevaux": 0,
|
|
12430
|
+
"rolling_log": 0,
|
|
12431
|
+
"boulder": 0
|
|
12432
|
+
},
|
|
12433
|
+
"cap": 600
|
|
12173
12434
|
}
|
|
12174
12435
|
}
|
|
12175
12436
|
```
|
|
12176
12437
|
|
|
12177
|
-
|
|
12178
|
-
|
|
12179
|
-
`S→C` 服务端推送 · 无 `seq`
|
|
12180
|
-
|
|
12181
|
-
账号内任一 Agent 连接上报计划后,推送给该账号其他在线连接(上报方除外——它已从直接响应拿到快照)。玩家网页用它实时渲染 Agent 的下一步动作与整体计划。
|
|
12182
|
-
|
|
12183
|
-
**data 字段**
|
|
12184
|
-
|
|
12185
|
-
| 字段 | 类型 | 说明 |
|
|
12186
|
-
| --- | --- | --- |
|
|
12187
|
-
| nextAction | string \| null | 更新后的下一步动作;已清除为 null。 |
|
|
12188
|
-
| overallPlan | string \| null | 更新后的整体计划;已清除为 null。 |
|
|
12189
|
-
| updatedAt | string | 本次上报时间(ISO 8601)。 |
|
|
12190
|
-
|
|
12191
|
-
**Agent 提示**:收到 null 字段表示对应段落被清除;断线重连后错过的更新不补推,用 GET_AGENT_INFO 的 plan 字段取最新快照(账号 0d3d8e2a… 维度,后写覆盖先写)。
|
|
12192
|
-
|
|
12193
|
-
**示例**
|
|
12438
|
+
**超出库存上限(城墙 10 级、已入库 590、在造 20,再下 10 件)**
|
|
12194
12439
|
|
|
12195
|
-
|
|
12440
|
+
请求:
|
|
12196
12441
|
|
|
12197
12442
|
```json
|
|
12198
12443
|
{
|
|
12199
|
-
"op":
|
|
12200
|
-
"
|
|
12444
|
+
"op": 117,
|
|
12445
|
+
"seq": 22,
|
|
12201
12446
|
"data": {
|
|
12202
|
-
"
|
|
12203
|
-
"
|
|
12204
|
-
"updatedAt": "2026-09-25T08:00:30.000Z"
|
|
12447
|
+
"kind": "chevaux",
|
|
12448
|
+
"count": 10
|
|
12205
12449
|
}
|
|
12206
12450
|
}
|
|
12207
12451
|
```
|
|
12208
12452
|
|
|
12209
|
-
|
|
12453
|
+
失败响应(`DEFENSE_STOCK_FULL`):
|
|
12210
12454
|
|
|
12211
12455
|
```json
|
|
12212
12456
|
{
|
|
12213
|
-
"op":
|
|
12214
|
-
"
|
|
12457
|
+
"op": 117,
|
|
12458
|
+
"seq": 22,
|
|
12459
|
+
"ok": false,
|
|
12460
|
+
"error": {
|
|
12461
|
+
"code": "DEFENSE_STOCK_FULL",
|
|
12462
|
+
"message": "器械库存已达上限(城墙等级 × 60,四种器械共用),先把库存用在守城或升级城墙"
|
|
12463
|
+
},
|
|
12215
12464
|
"data": {
|
|
12216
|
-
"
|
|
12217
|
-
"
|
|
12218
|
-
"
|
|
12465
|
+
"cap": 600,
|
|
12466
|
+
"stock": 590,
|
|
12467
|
+
"pending": 20
|
|
12219
12468
|
}
|
|
12220
12469
|
}
|
|
12221
12470
|
```
|
|
12222
12471
|
|
|
12223
|
-
### op
|
|
12472
|
+
### op 118 · CANCEL_DEFENSE_CRAFT — 取消打造(v73,AISLG-193)
|
|
12224
12473
|
|
|
12225
|
-
`S
|
|
12474
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
12226
12475
|
|
|
12227
|
-
|
|
12476
|
+
取消排队中(queued)或打造中(crafting)的器械条目:按发起时的成本快照全额返还到该城,库存不变;该城排队的下一条立即开工(同事务激活,推送 craft_started)。与 Worker 到点完成按条件守卫并发,先翻转状态者生效。
|
|
12228
12477
|
|
|
12229
|
-
|
|
12478
|
+
**请求字段**
|
|
12230
12479
|
|
|
12231
12480
|
| 字段 | 类型 | 说明 |
|
|
12232
12481
|
| --- | --- | --- |
|
|
12233
|
-
|
|
|
12234
|
-
| recruit | object | 征兵视图,字段与 RECRUIT 响应的 recruit 相同;完成时 status 为 completed 且 completedAt 非空。 |
|
|
12482
|
+
| craftId | string | 必填。要取消的打造条目 id(GET_STATE 的 city.defenses.queue 中条目的 id);缺失或格式非法返回 INVALID_PARAMS。 |
|
|
12235
12483
|
|
|
12236
|
-
|
|
12484
|
+
**响应 data 字段**
|
|
12485
|
+
|
|
12486
|
+
| 字段 | 类型 | 说明 |
|
|
12487
|
+
| --- | --- | --- |
|
|
12488
|
+
| craft | object | 被取消的打造条目(status=cancelled,completedAt 为 null)。 |
|
|
12489
|
+
|
|
12490
|
+
**可能错误**:`INVALID_PARAMS`、`DEFENSE_NOT_CANCELLABLE`(处置建议见第 4 节)
|
|
12491
|
+
|
|
12492
|
+
**Agent 提示**:取消全额返还,但会丢掉这段时间的进度;只是缺资源的话优先等完成,别反复取消重下。
|
|
12237
12493
|
|
|
12238
12494
|
**示例**
|
|
12239
12495
|
|
|
12240
|
-
|
|
12496
|
+
**取消进行中的打造**
|
|
12497
|
+
|
|
12498
|
+
请求:
|
|
12241
12499
|
|
|
12242
12500
|
```json
|
|
12243
12501
|
{
|
|
12244
|
-
"op":
|
|
12245
|
-
"
|
|
12502
|
+
"op": 118,
|
|
12503
|
+
"seq": 23,
|
|
12504
|
+
"data": {
|
|
12505
|
+
"craftId": "3f7c9a1e-2d4b-4c6a-9e8f-1a2b3c4d5e6f"
|
|
12506
|
+
}
|
|
12507
|
+
}
|
|
12508
|
+
```
|
|
12509
|
+
|
|
12510
|
+
成功响应:
|
|
12511
|
+
|
|
12512
|
+
```json
|
|
12513
|
+
{
|
|
12514
|
+
"op": 118,
|
|
12515
|
+
"seq": 23,
|
|
12516
|
+
"ok": true,
|
|
12517
|
+
"data": {
|
|
12518
|
+
"craft": {
|
|
12519
|
+
"id": "3f7c9a1e-2d4b-4c6a-9e8f-1a2b3c4d5e6f",
|
|
12520
|
+
"cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
12521
|
+
"kind": "trap",
|
|
12522
|
+
"count": 10,
|
|
12523
|
+
"status": "cancelled",
|
|
12524
|
+
"initiator": "player",
|
|
12525
|
+
"cost": {
|
|
12526
|
+
"gold": 200,
|
|
12527
|
+
"wood": 600,
|
|
12528
|
+
"food": 0,
|
|
12529
|
+
"stone": 0,
|
|
12530
|
+
"iron": 400
|
|
12531
|
+
},
|
|
12532
|
+
"unitSeconds": 5,
|
|
12533
|
+
"startedAt": "2026-09-25T08:00:00.000Z",
|
|
12534
|
+
"dueAt": null,
|
|
12535
|
+
"completedAt": null
|
|
12536
|
+
}
|
|
12537
|
+
}
|
|
12538
|
+
}
|
|
12539
|
+
```
|
|
12540
|
+
|
|
12541
|
+
### op 119 · DISMISS_ASSIST — 召回 / 遣返协防部队(v74,AISLG-194)
|
|
12542
|
+
|
|
12543
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
12544
|
+
|
|
12545
|
+
让一支驻扎在盟友城里的协防部队回出发城:派出方随时可以召回,城主可以遣返任意一支驻扎在自己城里的协防部队。部队原路返回(行军时长按两地距离与编队速度计算,驿站不加速),到达后并回出发城驻军;途中可以被 RECALL_MARCH 折返(折返仍是回出发城)。每座城最多接收 5 支协防部队,同一账号对同一座城最多 1 支;退盟 / 被踢 / 解散与城主放弃分城时相关协防部队自动遣返(事件 assist_returned,cause = ally_left / city_discarded);分城被占领要求守方全灭,协防部队随城覆灭,派出方收到 assist_returned(cause = wiped,troops 为空、returning 为 null,没有返程行军)。
|
|
12546
|
+
|
|
12547
|
+
**请求字段**
|
|
12548
|
+
|
|
12549
|
+
| 字段 | 类型 | 说明 |
|
|
12550
|
+
| --- | --- | --- |
|
|
12551
|
+
| assistId | string | 必填。协防记录 id:派出方看 GET_STATE 的 city.assistOut,城主看 city.assistIn(盟友看 GET_TILE 详情的 assists)。 |
|
|
12552
|
+
|
|
12553
|
+
**响应 data 字段**
|
|
12554
|
+
|
|
12555
|
+
| 字段 | 类型 | 说明 |
|
|
12556
|
+
| --- | --- | --- |
|
|
12557
|
+
| marchId | string \| null | 返程行军 id(可用 RECALL_MARCH 再折返);部队已不在(城 / 账号被重置)为 null。 |
|
|
12558
|
+
| assistId | string | 被召回 / 遣返的协防记录 id。 |
|
|
12559
|
+
|
|
12560
|
+
**可能错误**:`INVALID_PARAMS`、`ASSIST_NOT_FOUND`(处置建议见第 4 节)
|
|
12561
|
+
|
|
12562
|
+
**Agent 提示**:协防部队占派出城的校场出征名额、耗粮由派出城按野外部队 2 倍承担;守城战时与城主驻军合并参战,伤亡按开战时各兵种数量比例分摊(余数归城主)。战斗后派出方会收到一份带 assistLosses 的战报。
|
|
12563
|
+
|
|
12564
|
+
**示例**
|
|
12565
|
+
|
|
12566
|
+
**城主遣返一支协防部队(或派出方召回)**
|
|
12567
|
+
|
|
12568
|
+
请求:
|
|
12569
|
+
|
|
12570
|
+
```json
|
|
12571
|
+
{
|
|
12572
|
+
"op": 119,
|
|
12573
|
+
"seq": 31,
|
|
12574
|
+
"data": {
|
|
12575
|
+
"assistId": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"
|
|
12576
|
+
}
|
|
12577
|
+
}
|
|
12578
|
+
```
|
|
12579
|
+
|
|
12580
|
+
成功响应:
|
|
12581
|
+
|
|
12582
|
+
```json
|
|
12583
|
+
{
|
|
12584
|
+
"op": 119,
|
|
12585
|
+
"seq": 31,
|
|
12586
|
+
"ok": true,
|
|
12587
|
+
"data": {
|
|
12588
|
+
"assistId": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
|
|
12589
|
+
"marchId": "2f1e3d4c-5b6a-4978-8c9d-0a1b2c3d4e5f"
|
|
12590
|
+
}
|
|
12591
|
+
}
|
|
12592
|
+
```
|
|
12593
|
+
|
|
12594
|
+
### op 120 · GET_BATTLEFIELD — 查询剧本战场(官渡之战,v75,AISLG-198)
|
|
12595
|
+
|
|
12596
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
12597
|
+
|
|
12598
|
+
周期性的剧本战场,玩家与 Agent 通用。日程:北京时间每周二 20:00 开始报名、周三 20:00 开战、周四 20:00 结束(现实时间,不随全局时间缩放)。每周一场,剧本按周轮换:官渡之战 → 讨伐董卓 → 赤壁之战(循环),本场剧本见 event.script、下一场见 nextScript。官渡之战(script=guandu)是阵营对阵:报名要求主城官府 ≥ 5 级,选袁绍军或曹操军(一方报名人数超过另一方 1.5 倍且多 5 人以上时,人多一方暂停报名)。战场是 30×30 的独立地图,与世界地图完全隔离;中间一条河(x=15)只有 3 处渡口(y=5/15/25)能过。行军每格 60 秒现实时间,不随全局缩放。9 个据点:袁绍大营(2,15,0 分/小时,守军 ×10);曹操大营(27,15,0 分/小时,守军 ×10);白马渡口(15,5,10 分/小时,守军 ×2);延津渡口(15,15,10 分/小时,守军 ×2);官渡渡口(15,25,10 分/小时,守军 ×2);酸枣据点(7,8,10 分/小时,守军 ×2);阳武据点(7,22,10 分/小时,守军 ×2);中牟据点(22,8,10 分/小时,守军 ×2);乌巢粮仓(22,22,30 分/小时,守军 ×4)。守军 = 3 级 NPC 城守军(义兵 100 / 刀盾 30 / 弓箭 40 / 轻骑 12)× 表格倍数 × max(1, 报名人数 ÷ 20);大营按守城战(城墙 10、箭塔 10),其余按野战。报名期从主城带一支部队入场(按人口最多 3000,每人一次,开战后不能追加),入场后可拆成最多 3 队。军功 = 歼灭敌军参考战力 1:1(打 NPC 守军也算),首次打下据点额外 +200;乌巢粮仓让敌方阵营所有部队耗粮翻倍;开战时一方人数少于另一方 70% 时,人少一方据点积分 × min(1.5, 多/少)。结束时按胜负发奖(胜方 3000 金 + 四资源各 15000;败方 1000 金 + 各 5000),个人军功前 10 有额外奖励(个人军功第 1 名 6000 金 + 各 30000;第 2–3 名 4000 金 + 各 20000;第 4–10 名 2500 金 + 各 12000),军功 > 0 才能领;幸存部队回主城。战场商店(军功跨场累积、换季清零):资源包 200 军功(每场限 5);武将经验 300 军功(每场限 3);刀盾兵 600 军功(每场限 2);轻骑兵 600 军功(每场限 2)。讨伐董卓(script=dongzhuo,全服合作):只有讨董联军一方,所有报名玩家都在同一边(报名时 camp 仍要传,服务端统一记为 yuan),对手是 NPC 董卓军。一条推进线 汜水关 → 虎牢关 → 洛阳,前一关打下后下一关才开放(strongholds[].unlocked)。守军 = 3 级 NPC 城守军 × 倍数 × max(1, 报名人数 ÷ 10):汜水关 ×15(城墙 10 / 箭塔 10)、虎牢关 ×40(城墙 15 / 箭塔 15,守将吕布攻击 +20% 、减伤 −20%)、洛阳 ×30(城墙 20 / 箭塔 20)。守军伤亡保留不回血。攻下洛阳即结束(胜);时间到也结束。奖励按全服最远进度领一档(军功 > 0 才能领):破汜水关 1000 金 + 四资源各 5000;破虎牢关 2000 金 + 四资源各 10000;攻下洛阳 4000 金 + 四资源各 20000;个人军功前 10 的额外奖励与官渡相同。没有玩家对抗。 赤壁之战(script=chibi):孙刘联军(yuan)对曹操军(cao),人数限制、人少补偿、胜负判定、奖励表与官渡相同;报名要求爵位大夫及以上(NOBILITY_TOO_LOW,附 required / current)。地图同为 30×30 与河(x=15,3 处渡口),双方各 4 个据点加各 1 座大营(共 10 个,见 strongholds);大营与据点守军、积分产出与官渡对应据点相同(大营守军 ×10,城墙 / 箭塔 10)。风向:开战时随机东南风(se)或西北风(nw),之后每 6 小时交替一次,切换前 30 分钟预告;event.wind = { direction, label, bonusCamp, nextAt, noticeAt }。顺风方(se 利孙刘、nw 利曹操)的远程兵种与床弩射程 +10%(战报可见)。火攻(FIRE_BATTLEFIELD_STRONGHOLD,op 139):孙刘方、东南风期间,花 300 军功,火攻与己方据点相邻(曼哈顿距离 ≤ 10)的曹方据点,立即对守军造成总生命 20% 的伤害;同一目标每 2 小时最多一次。连锁战船(CHAIN_BATTLEFIELD_STRONGHOLD,op 140):曹方给己方据点花 200 军功连锁 6 小时:守军受到的伤害 −15%,但被火攻时伤害翻倍(20% → 40%)。赤壁商店另有铁骑兵 20(直接进主城,800 军功,每场限 1 次)。
|
|
12599
|
+
|
|
12600
|
+
**请求字段**
|
|
12601
|
+
|
|
12602
|
+
无请求字段(`data` 可省略)。
|
|
12603
|
+
|
|
12604
|
+
**响应 data 字段**
|
|
12605
|
+
|
|
12606
|
+
| 字段 | 类型 | 说明 |
|
|
12607
|
+
| --- | --- | --- |
|
|
12608
|
+
| event | object \| null | 当前 / 最近一场战场:{ id, script: guandu\|dongzhuo\|chibi, name, status: signup\|active\|finished, signupStartAt, startAt, endAt, camps: { yuan: { camp, name, signups, entered, score }, cao: 同结构 }, winner: yuan\|cao\|null, finishReason: score\|base_captured\|null, underdog: { camp, multiplier } \| null, wind: 赤壁专有 { direction: se\|nw, label, bonusCamp, nextAt, noticeAt }(其他剧本为 null) }。从未开过为 null。 |
|
|
12609
|
+
| nextSignupAt | string | 下一场报名开始时刻(北京时间每周二 20:00)。 |
|
|
12610
|
+
| nextScript | 'guandu' \| 'dongzhuo' \| 'chibi' | 下一场的剧本(轮换预告)。 |
|
|
12611
|
+
| strongholds | array | 本场据点(官渡 9 个 / 讨董 3 关 / 赤壁 10 个;讨董按推进线顺序):{ id, name, kind: base\|ford\|post\|granary, x, y, ownerCamp: yuan\|cao\|null(null = 中立 NPC;讨董的董卓军也是 null), pointsPerHour, garrison(全兵种计数,NPC + 玩家据守合计), garrisonPower(参考战力), wallLevel, towerLevel, firstCaptureAvailable(首占 +200 军功还没被拿过), capturedAt, unlocked(讨董:前一关未打下为 false;其他剧本恒为 true), chainUntil(赤壁曹方连锁截止,其他 null), fireNextAt(赤壁火攻冷却截止,其他 null) }。 |
|
|
12612
|
+
| me | object \| null | 本场我的状态:{ accountId, username, camp, merit 本场军功, rank 本场名次(未入场为 null), entered, squads: [{ id, x, y, status: marching\|idle\|garrison, troops, targetX, targetY, targetStrongholdId, arriveAt, originX, originY, strongholdId }], cumulativeMerit 跨场军功余额 };未报名为 null。 |
|
|
12613
|
+
| top | array | 本场军功榜前 10:{ rank, accountId, username, camp, merit }(同分并列,军功 0 不上榜)。 |
|
|
12614
|
+
| shop | object | 战场商店(赤壁多一个 iron_cavalry):{ cumulativeMerit, items: [{ item: resources\|hero_exp\|swordsman\|cavalry\|iron_cavalry, label, cost, limit, bought 本场已买, reward: { resources? , heroExp?, troop?, count? } }] }。 |
|
|
12615
|
+
| rewards | object | 奖励表:{ winner { label, gold, resourcesEach }, loser 同结构, rankTiers: [{ label, rank, maxRank, gold, resourcesEach }], progressTiers: [{ label, progress, gold, resourcesEach }](讨董的全服进度档;其他剧本为空数组) }。 |
|
|
12616
|
+
|
|
12617
|
+
**Agent 提示**:先看 event.script 与 event.status:signup 期只能报名 / 入场,active 才能行军与攻打。行军目标用 strongholds 的 id(MARCH_BATTLEFIELD_SQUAD 会按据点坐标走最短路径);河只有 3 处渡口,先取渡口再渡河。攻打前用 garrisonPower 与自己的队伍战力对比,有城墙的据点按守城战(城墙 + 箭塔),没有把握先打渡口 / 普通据点。军功来自歼灭敌军(打 NPC 也算),首占据点 +200;乌巢(granary_wuchao)价值 30 分/小时并让敌方耗粮翻倍,适合偷袭。结束奖励自动入账,军功可立刻在战场商店换资源 / 武将经验 / 兵。讨董:只看 unlocked 为 true 的关卡,先打汜水关再虎牢关,洛阳最后;赤壁:先看 event.wind,东南风时孙刘方可以火攻,西北风时曹方可以连锁,留意预告的切换时刻。
|
|
12618
|
+
|
|
12619
|
+
**示例**
|
|
12620
|
+
|
|
12621
|
+
**战场进行中:我在袁绍军,一支队伍正在去延津渡口**
|
|
12622
|
+
|
|
12623
|
+
请求:
|
|
12624
|
+
|
|
12625
|
+
```json
|
|
12626
|
+
{
|
|
12627
|
+
"op": 120,
|
|
12628
|
+
"seq": 30,
|
|
12629
|
+
"data": {}
|
|
12630
|
+
}
|
|
12631
|
+
```
|
|
12632
|
+
|
|
12633
|
+
成功响应:
|
|
12634
|
+
|
|
12635
|
+
```json
|
|
12636
|
+
{
|
|
12637
|
+
"op": 120,
|
|
12638
|
+
"seq": 30,
|
|
12639
|
+
"ok": true,
|
|
12640
|
+
"data": {
|
|
12641
|
+
"event": {
|
|
12642
|
+
"id": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
|
|
12643
|
+
"script": "guandu",
|
|
12644
|
+
"name": "官渡之战",
|
|
12645
|
+
"status": "active",
|
|
12646
|
+
"signupStartAt": "2026-09-24T08:00:00.000Z",
|
|
12647
|
+
"startAt": "2026-09-25T08:00:00.000Z",
|
|
12648
|
+
"endAt": "2026-09-26T08:00:00.000Z",
|
|
12649
|
+
"camps": {
|
|
12650
|
+
"yuan": {
|
|
12651
|
+
"camp": "yuan",
|
|
12652
|
+
"name": "袁绍军",
|
|
12653
|
+
"signups": 12,
|
|
12654
|
+
"entered": 10,
|
|
12655
|
+
"score": 180
|
|
12656
|
+
},
|
|
12657
|
+
"cao": {
|
|
12658
|
+
"camp": "cao",
|
|
12659
|
+
"name": "曹操军",
|
|
12660
|
+
"signups": 15,
|
|
12661
|
+
"entered": 13,
|
|
12662
|
+
"score": 240
|
|
12663
|
+
}
|
|
12664
|
+
},
|
|
12665
|
+
"winner": null,
|
|
12666
|
+
"finishReason": null,
|
|
12667
|
+
"underdog": null
|
|
12668
|
+
},
|
|
12669
|
+
"nextSignupAt": "2026-10-02T08:00:00.000Z",
|
|
12670
|
+
"nextScript": "dongzhuo",
|
|
12671
|
+
"strongholds": [
|
|
12672
|
+
{
|
|
12673
|
+
"id": "ford_yanjin",
|
|
12674
|
+
"name": "延津渡口",
|
|
12675
|
+
"kind": "ford",
|
|
12676
|
+
"x": 15,
|
|
12677
|
+
"y": 15,
|
|
12678
|
+
"ownerCamp": "cao",
|
|
12679
|
+
"pointsPerHour": 10,
|
|
12680
|
+
"garrison": {
|
|
12681
|
+
"porter": 0,
|
|
12682
|
+
"militia": 120,
|
|
12683
|
+
"scout": 0,
|
|
12684
|
+
"pikeman": 0,
|
|
12685
|
+
"swordsman": 40,
|
|
12686
|
+
"archer": 60,
|
|
12687
|
+
"cavalry": 15,
|
|
12688
|
+
"iron_cavalry": 0,
|
|
12689
|
+
"supply_wagon": 0,
|
|
12690
|
+
"ballista": 0,
|
|
12691
|
+
"siege_ram": 0,
|
|
12692
|
+
"yulin_guard": 0,
|
|
12693
|
+
"danyang_soldier": 0,
|
|
12694
|
+
"baimao_soldier": 0,
|
|
12695
|
+
"huwei_guard": 0,
|
|
12696
|
+
"zhuge_crossbow": 0,
|
|
12697
|
+
"xiandeng_warrior": 0,
|
|
12698
|
+
"hubao_cavalry": 0,
|
|
12699
|
+
"xiliang_cavalry": 0
|
|
12700
|
+
},
|
|
12701
|
+
"garrisonPower": 710,
|
|
12702
|
+
"wallLevel": 0,
|
|
12703
|
+
"towerLevel": 0,
|
|
12704
|
+
"firstCaptureAvailable": false,
|
|
12705
|
+
"capturedAt": "2026-09-25T08:00:00.000Z"
|
|
12706
|
+
},
|
|
12707
|
+
"(其余 8 个据点同结构)"
|
|
12708
|
+
],
|
|
12709
|
+
"me": {
|
|
12710
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
12711
|
+
"username": "alice",
|
|
12712
|
+
"camp": "yuan",
|
|
12713
|
+
"merit": 1240,
|
|
12714
|
+
"rank": 3,
|
|
12715
|
+
"entered": true,
|
|
12716
|
+
"squads": [
|
|
12717
|
+
{
|
|
12718
|
+
"id": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
|
|
12719
|
+
"x": 14,
|
|
12720
|
+
"y": 15,
|
|
12721
|
+
"status": "marching",
|
|
12722
|
+
"troops": {
|
|
12723
|
+
"porter": 0,
|
|
12724
|
+
"militia": 300,
|
|
12725
|
+
"scout": 0,
|
|
12726
|
+
"pikeman": 0,
|
|
12727
|
+
"swordsman": 200,
|
|
12728
|
+
"archer": 150,
|
|
12729
|
+
"cavalry": 50,
|
|
12730
|
+
"iron_cavalry": 0,
|
|
12731
|
+
"supply_wagon": 0,
|
|
12732
|
+
"ballista": 0,
|
|
12733
|
+
"siege_ram": 0,
|
|
12734
|
+
"yulin_guard": 0,
|
|
12735
|
+
"danyang_soldier": 0,
|
|
12736
|
+
"baimao_soldier": 0,
|
|
12737
|
+
"huwei_guard": 0,
|
|
12738
|
+
"zhuge_crossbow": 0,
|
|
12739
|
+
"xiandeng_warrior": 0,
|
|
12740
|
+
"hubao_cavalry": 0,
|
|
12741
|
+
"xiliang_cavalry": 0
|
|
12742
|
+
},
|
|
12743
|
+
"targetX": 15,
|
|
12744
|
+
"targetY": 15,
|
|
12745
|
+
"targetStrongholdId": "ford_yanjin",
|
|
12746
|
+
"arriveAt": "2026-09-25T08:01:00.000Z",
|
|
12747
|
+
"originX": 13,
|
|
12748
|
+
"originY": 15,
|
|
12749
|
+
"strongholdId": null
|
|
12750
|
+
}
|
|
12751
|
+
],
|
|
12752
|
+
"cumulativeMerit": 3600
|
|
12753
|
+
},
|
|
12754
|
+
"top": [
|
|
12755
|
+
{
|
|
12756
|
+
"rank": 1,
|
|
12757
|
+
"accountId": "…",
|
|
12758
|
+
"username": "bob",
|
|
12759
|
+
"camp": "cao",
|
|
12760
|
+
"merit": 2200
|
|
12761
|
+
},
|
|
12762
|
+
{
|
|
12763
|
+
"rank": 2,
|
|
12764
|
+
"accountId": "…",
|
|
12765
|
+
"username": "carol",
|
|
12766
|
+
"camp": "yuan",
|
|
12767
|
+
"merit": 1500
|
|
12768
|
+
},
|
|
12769
|
+
{
|
|
12770
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
12771
|
+
"username": "alice",
|
|
12772
|
+
"camp": "yuan",
|
|
12773
|
+
"merit": 1240,
|
|
12774
|
+
"rank": 3,
|
|
12775
|
+
"entered": true,
|
|
12776
|
+
"squads": [
|
|
12777
|
+
{
|
|
12778
|
+
"id": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
|
|
12779
|
+
"x": 14,
|
|
12780
|
+
"y": 15,
|
|
12781
|
+
"status": "marching",
|
|
12782
|
+
"troops": {
|
|
12783
|
+
"porter": 0,
|
|
12784
|
+
"militia": 300,
|
|
12785
|
+
"scout": 0,
|
|
12786
|
+
"pikeman": 0,
|
|
12787
|
+
"swordsman": 200,
|
|
12788
|
+
"archer": 150,
|
|
12789
|
+
"cavalry": 50,
|
|
12790
|
+
"iron_cavalry": 0,
|
|
12791
|
+
"supply_wagon": 0,
|
|
12792
|
+
"ballista": 0,
|
|
12793
|
+
"siege_ram": 0,
|
|
12794
|
+
"yulin_guard": 0,
|
|
12795
|
+
"danyang_soldier": 0,
|
|
12796
|
+
"baimao_soldier": 0,
|
|
12797
|
+
"huwei_guard": 0,
|
|
12798
|
+
"zhuge_crossbow": 0,
|
|
12799
|
+
"xiandeng_warrior": 0,
|
|
12800
|
+
"hubao_cavalry": 0,
|
|
12801
|
+
"xiliang_cavalry": 0
|
|
12802
|
+
},
|
|
12803
|
+
"targetX": 15,
|
|
12804
|
+
"targetY": 15,
|
|
12805
|
+
"targetStrongholdId": "ford_yanjin",
|
|
12806
|
+
"arriveAt": "2026-09-25T08:01:00.000Z",
|
|
12807
|
+
"originX": 13,
|
|
12808
|
+
"originY": 15,
|
|
12809
|
+
"strongholdId": null
|
|
12810
|
+
}
|
|
12811
|
+
],
|
|
12812
|
+
"cumulativeMerit": 3600
|
|
12813
|
+
}
|
|
12814
|
+
],
|
|
12815
|
+
"shop": {
|
|
12816
|
+
"cumulativeMerit": 3600,
|
|
12817
|
+
"items": [
|
|
12818
|
+
{
|
|
12819
|
+
"item": "resources",
|
|
12820
|
+
"label": "资源包",
|
|
12821
|
+
"cost": 200,
|
|
12822
|
+
"limit": 5,
|
|
12823
|
+
"bought": 0,
|
|
12824
|
+
"reward": {
|
|
12825
|
+
"resources": {
|
|
12826
|
+
"gold": 0,
|
|
12827
|
+
"wood": 10000,
|
|
12828
|
+
"food": 10000,
|
|
12829
|
+
"stone": 10000,
|
|
12830
|
+
"iron": 10000
|
|
12831
|
+
}
|
|
12832
|
+
}
|
|
12833
|
+
},
|
|
12834
|
+
{
|
|
12835
|
+
"item": "hero_exp",
|
|
12836
|
+
"label": "武将经验",
|
|
12837
|
+
"cost": 300,
|
|
12838
|
+
"limit": 3,
|
|
12839
|
+
"bought": 0,
|
|
12840
|
+
"reward": {
|
|
12841
|
+
"heroExp": 5000
|
|
12842
|
+
}
|
|
12843
|
+
},
|
|
12844
|
+
{
|
|
12845
|
+
"item": "swordsman",
|
|
12846
|
+
"label": "刀盾兵",
|
|
12847
|
+
"cost": 600,
|
|
12848
|
+
"limit": 2,
|
|
12849
|
+
"bought": 0,
|
|
12850
|
+
"reward": {
|
|
12851
|
+
"troop": "swordsman",
|
|
12852
|
+
"count": 100
|
|
12853
|
+
}
|
|
12854
|
+
},
|
|
12855
|
+
{
|
|
12856
|
+
"item": "cavalry",
|
|
12857
|
+
"label": "轻骑兵",
|
|
12858
|
+
"cost": 600,
|
|
12859
|
+
"limit": 2,
|
|
12860
|
+
"bought": 0,
|
|
12861
|
+
"reward": {
|
|
12862
|
+
"troop": "cavalry",
|
|
12863
|
+
"count": 50
|
|
12864
|
+
}
|
|
12865
|
+
}
|
|
12866
|
+
]
|
|
12867
|
+
},
|
|
12868
|
+
"rewards": {
|
|
12869
|
+
"winner": {
|
|
12870
|
+
"label": "胜方每人",
|
|
12871
|
+
"gold": 3000,
|
|
12872
|
+
"resourcesEach": 15000
|
|
12873
|
+
},
|
|
12874
|
+
"loser": {
|
|
12875
|
+
"label": "败方每人",
|
|
12876
|
+
"gold": 1000,
|
|
12877
|
+
"resourcesEach": 5000
|
|
12878
|
+
},
|
|
12879
|
+
"rankTiers": [
|
|
12880
|
+
{
|
|
12881
|
+
"label": "个人军功第 1 名",
|
|
12882
|
+
"maxRank": 1,
|
|
12883
|
+
"gold": 6000,
|
|
12884
|
+
"resourcesEach": 30000
|
|
12885
|
+
},
|
|
12886
|
+
{
|
|
12887
|
+
"label": "第 2–3 名",
|
|
12888
|
+
"maxRank": 3,
|
|
12889
|
+
"gold": 4000,
|
|
12890
|
+
"resourcesEach": 20000
|
|
12891
|
+
},
|
|
12892
|
+
{
|
|
12893
|
+
"label": "第 4–10 名",
|
|
12894
|
+
"maxRank": 10,
|
|
12895
|
+
"gold": 2500,
|
|
12896
|
+
"resourcesEach": 12000
|
|
12897
|
+
}
|
|
12898
|
+
],
|
|
12899
|
+
"progressTiers": []
|
|
12900
|
+
}
|
|
12901
|
+
}
|
|
12902
|
+
}
|
|
12903
|
+
```
|
|
12904
|
+
|
|
12905
|
+
### op 121 · SIGNUP_BATTLEFIELD — 报名剧本战场(v75,AISLG-198;v80 讨董 / 赤壁)
|
|
12906
|
+
|
|
12907
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
12908
|
+
|
|
12909
|
+
在报名期(北京时间每周二 20:00 开始报名、周三 20:00 开战、周四 20:00 结束(现实时间,不随全局时间缩放))报名:主城官府 ≥ 5 级;同一场只能报一次,阵营选定后不能改。官渡 / 赤壁:一方报名人数超过另一方 1.5 倍且多出 5 人以上时,人多的一方暂停报名(返回 BATTLEFIELD_CAMP_FULL,附 count / otherCount / limit);赤壁另需爵位大夫及以上(NOBILITY_TOO_LOW,附 required / current)。讨伐董卓是单阵营合作本,所有报名玩家都记为讨董联军(yuan),不做人数失衡判断。报名只占阵营人数,不带兵;带兵用 ENTER_BATTLEFIELD(开战前)。
|
|
12910
|
+
|
|
12911
|
+
**请求字段**
|
|
12912
|
+
|
|
12913
|
+
| 字段 | 类型 | 说明 |
|
|
12914
|
+
| --- | --- | --- |
|
|
12915
|
+
| camp | 'yuan' \| 'cao' | 必填。袁绍军 yuan / 曹操军 cao(讨董场统一记为 yuan,此字段仍需传合法值)。 |
|
|
12916
|
+
|
|
12917
|
+
**响应 data 字段**
|
|
12918
|
+
|
|
12919
|
+
| 字段 | 类型 | 说明 |
|
|
12920
|
+
| --- | --- | --- |
|
|
12921
|
+
| event | object \| null | 当前 / 最近一场战场:{ id, script: guandu\|dongzhuo\|chibi, name, status: signup\|active\|finished, signupStartAt, startAt, endAt, camps: { yuan: { camp, name, signups, entered, score }, cao: 同结构 }, winner: yuan\|cao\|null, finishReason: score\|base_captured\|null, underdog: { camp, multiplier } \| null, wind: 赤壁专有 { direction: se\|nw, label, bonusCamp, nextAt, noticeAt }(其他剧本为 null) }。从未开过为 null。 |
|
|
12922
|
+
| nextSignupAt | string | 下一场报名开始时刻(北京时间每周二 20:00)。 |
|
|
12923
|
+
| nextScript | 'guandu' \| 'dongzhuo' \| 'chibi' | 下一场的剧本(轮换预告)。 |
|
|
12924
|
+
| strongholds | array | 本场据点(官渡 9 个 / 讨董 3 关 / 赤壁 10 个;讨董按推进线顺序):{ id, name, kind: base\|ford\|post\|granary, x, y, ownerCamp: yuan\|cao\|null(null = 中立 NPC;讨董的董卓军也是 null), pointsPerHour, garrison(全兵种计数,NPC + 玩家据守合计), garrisonPower(参考战力), wallLevel, towerLevel, firstCaptureAvailable(首占 +200 军功还没被拿过), capturedAt, unlocked(讨董:前一关未打下为 false;其他剧本恒为 true), chainUntil(赤壁曹方连锁截止,其他 null), fireNextAt(赤壁火攻冷却截止,其他 null) }。 |
|
|
12925
|
+
| me | object \| null | 本场我的状态:{ accountId, username, camp, merit 本场军功, rank 本场名次(未入场为 null), entered, squads: [{ id, x, y, status: marching\|idle\|garrison, troops, targetX, targetY, targetStrongholdId, arriveAt, originX, originY, strongholdId }], cumulativeMerit 跨场军功余额 };未报名为 null。 |
|
|
12926
|
+
| top | array | 本场军功榜前 10:{ rank, accountId, username, camp, merit }(同分并列,军功 0 不上榜)。 |
|
|
12927
|
+
| shop | object | 战场商店(赤壁多一个 iron_cavalry):{ cumulativeMerit, items: [{ item: resources\|hero_exp\|swordsman\|cavalry\|iron_cavalry, label, cost, limit, bought 本场已买, reward: { resources? , heroExp?, troop?, count? } }] }。 |
|
|
12928
|
+
| rewards | object | 奖励表:{ winner { label, gold, resourcesEach }, loser 同结构, rankTiers: [{ label, rank, maxRank, gold, resourcesEach }], progressTiers: [{ label, progress, gold, resourcesEach }](讨董的全服进度档;其他剧本为空数组) }。 |
|
|
12929
|
+
|
|
12930
|
+
**可能错误**:`INVALID_PARAMS`、`BATTLEFIELD_SIGNUP_CLOSED`、`BATTLEFIELD_ALREADY_JOINED`、`BATTLEFIELD_GOVERNMENT_TOO_LOW`、`BATTLEFIELD_CAMP_FULL`、`NOBILITY_TOO_LOW`(处置建议见第 4 节)
|
|
12931
|
+
|
|
12932
|
+
**Agent 提示**:报名前先 GET_BATTLEFIELD 看双方 signups,选人少的一方通常能吃到人少补偿;报名后记得在开战前 ENTER_BATTLEFIELD 带兵入场,否则开战后无法入场。
|
|
12933
|
+
|
|
12934
|
+
**示例**
|
|
12935
|
+
|
|
12936
|
+
**报名袁绍军**
|
|
12937
|
+
|
|
12938
|
+
请求:
|
|
12939
|
+
|
|
12940
|
+
```json
|
|
12941
|
+
{
|
|
12942
|
+
"op": 121,
|
|
12943
|
+
"seq": 31,
|
|
12944
|
+
"data": {
|
|
12945
|
+
"camp": "yuan"
|
|
12946
|
+
}
|
|
12947
|
+
}
|
|
12948
|
+
```
|
|
12949
|
+
|
|
12950
|
+
成功响应:
|
|
12951
|
+
|
|
12952
|
+
```json
|
|
12953
|
+
{
|
|
12954
|
+
"op": 121,
|
|
12955
|
+
"seq": 31,
|
|
12956
|
+
"ok": true,
|
|
12957
|
+
"data": {
|
|
12958
|
+
"event": {
|
|
12959
|
+
"id": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
|
|
12960
|
+
"script": "guandu",
|
|
12961
|
+
"name": "官渡之战",
|
|
12962
|
+
"status": "active",
|
|
12963
|
+
"signupStartAt": "2026-09-24T08:00:00.000Z",
|
|
12964
|
+
"startAt": "2026-09-25T08:00:00.000Z",
|
|
12965
|
+
"endAt": "2026-09-26T08:00:00.000Z",
|
|
12966
|
+
"camps": {
|
|
12967
|
+
"yuan": {
|
|
12968
|
+
"camp": "yuan",
|
|
12969
|
+
"name": "袁绍军",
|
|
12970
|
+
"signups": 12,
|
|
12971
|
+
"entered": 10,
|
|
12972
|
+
"score": 180
|
|
12973
|
+
},
|
|
12974
|
+
"cao": {
|
|
12975
|
+
"camp": "cao",
|
|
12976
|
+
"name": "曹操军",
|
|
12977
|
+
"signups": 15,
|
|
12978
|
+
"entered": 13,
|
|
12979
|
+
"score": 240
|
|
12980
|
+
}
|
|
12981
|
+
},
|
|
12982
|
+
"winner": null,
|
|
12983
|
+
"finishReason": null,
|
|
12984
|
+
"underdog": null
|
|
12985
|
+
},
|
|
12986
|
+
"me": {
|
|
12987
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
12988
|
+
"username": "alice",
|
|
12989
|
+
"camp": "yuan",
|
|
12990
|
+
"merit": 0,
|
|
12991
|
+
"rank": null,
|
|
12992
|
+
"entered": false,
|
|
12993
|
+
"squads": [],
|
|
12994
|
+
"cumulativeMerit": 3600
|
|
12995
|
+
}
|
|
12996
|
+
}
|
|
12997
|
+
}
|
|
12998
|
+
```
|
|
12999
|
+
|
|
13000
|
+
### op 122 · ENTER_BATTLEFIELD — 带部队入场(v75,AISLG-198)
|
|
13001
|
+
|
|
13002
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
13003
|
+
|
|
13004
|
+
报名后、开战前,从主城带一支部队进入战场:按人口计最多 3000(铁骑兵 3、辎重车 6……),部队从主城驻军扣除,战场结束后幸存部队回到主城。每人每场只能入场一次,开战后不能追加兵力。入场后队伍出现在自己大营旁,可用 SPLIT_BATTLEFIELD_SQUAD 拆成最多 3 队。
|
|
13005
|
+
|
|
13006
|
+
**请求字段**
|
|
13007
|
+
|
|
13008
|
+
| 字段 | 类型 | 说明 |
|
|
13009
|
+
| --- | --- | --- |
|
|
13010
|
+
| troops | object | 必填。按兵种数量(非负整数,至少 1 个单位):{ militia, swordsman, archer, cavalry, ... },键集同 MARCH.troops;按人口合计 ≤ 3000。 |
|
|
13011
|
+
|
|
13012
|
+
**响应 data 字段**
|
|
13013
|
+
|
|
13014
|
+
| 字段 | 类型 | 说明 |
|
|
13015
|
+
| --- | --- | --- |
|
|
13016
|
+
| event | object \| null | 当前 / 最近一场战场:{ id, script: guandu\|dongzhuo\|chibi, name, status: signup\|active\|finished, signupStartAt, startAt, endAt, camps: { yuan: { camp, name, signups, entered, score }, cao: 同结构 }, winner: yuan\|cao\|null, finishReason: score\|base_captured\|null, underdog: { camp, multiplier } \| null, wind: 赤壁专有 { direction: se\|nw, label, bonusCamp, nextAt, noticeAt }(其他剧本为 null) }。从未开过为 null。 |
|
|
13017
|
+
| nextSignupAt | string | 下一场报名开始时刻(北京时间每周二 20:00)。 |
|
|
13018
|
+
| nextScript | 'guandu' \| 'dongzhuo' \| 'chibi' | 下一场的剧本(轮换预告)。 |
|
|
13019
|
+
| strongholds | array | 本场据点(官渡 9 个 / 讨董 3 关 / 赤壁 10 个;讨董按推进线顺序):{ id, name, kind: base\|ford\|post\|granary, x, y, ownerCamp: yuan\|cao\|null(null = 中立 NPC;讨董的董卓军也是 null), pointsPerHour, garrison(全兵种计数,NPC + 玩家据守合计), garrisonPower(参考战力), wallLevel, towerLevel, firstCaptureAvailable(首占 +200 军功还没被拿过), capturedAt, unlocked(讨董:前一关未打下为 false;其他剧本恒为 true), chainUntil(赤壁曹方连锁截止,其他 null), fireNextAt(赤壁火攻冷却截止,其他 null) }。 |
|
|
13020
|
+
| me | object \| null | 本场我的状态:{ accountId, username, camp, merit 本场军功, rank 本场名次(未入场为 null), entered, squads: [{ id, x, y, status: marching\|idle\|garrison, troops, targetX, targetY, targetStrongholdId, arriveAt, originX, originY, strongholdId }], cumulativeMerit 跨场军功余额 };未报名为 null。 |
|
|
13021
|
+
| top | array | 本场军功榜前 10:{ rank, accountId, username, camp, merit }(同分并列,军功 0 不上榜)。 |
|
|
13022
|
+
| shop | object | 战场商店(赤壁多一个 iron_cavalry):{ cumulativeMerit, items: [{ item: resources\|hero_exp\|swordsman\|cavalry\|iron_cavalry, label, cost, limit, bought 本场已买, reward: { resources? , heroExp?, troop?, count? } }] }。 |
|
|
13023
|
+
| rewards | object | 奖励表:{ winner { label, gold, resourcesEach }, loser 同结构, rankTiers: [{ label, rank, maxRank, gold, resourcesEach }], progressTiers: [{ label, progress, gold, resourcesEach }](讨董的全服进度档;其他剧本为空数组) }。 |
|
|
13024
|
+
|
|
13025
|
+
**可能错误**:`INVALID_PARAMS`、`BATTLEFIELD_NOT_JOINED`、`BATTLEFIELD_ENTRY_CLOSED`、`BATTLEFIELD_ALREADY_ENTERED`、`BATTLEFIELD_POPULATION_LIMIT`、`INSUFFICIENT_TROOPS`(处置建议见第 4 节)
|
|
13026
|
+
|
|
13027
|
+
**Agent 提示**:入场前用 GET_STATE 的 city.army 确认兵够,并算清人口(铁骑兵 3 / 辎重车 6 / 床弩 3 / 冲车 5)。全部兵力一次性带入即可,开战后无法追加;拆队是战术选择,不影响入场上限。
|
|
13028
|
+
|
|
13029
|
+
**示例**
|
|
13030
|
+
|
|
13031
|
+
**带 700 单位入场**
|
|
13032
|
+
|
|
13033
|
+
请求:
|
|
13034
|
+
|
|
13035
|
+
```json
|
|
13036
|
+
{
|
|
13037
|
+
"op": 122,
|
|
13038
|
+
"seq": 32,
|
|
13039
|
+
"data": {
|
|
13040
|
+
"troops": {
|
|
13041
|
+
"militia": 300,
|
|
13042
|
+
"swordsman": 200,
|
|
13043
|
+
"archer": 150,
|
|
13044
|
+
"cavalry": 50
|
|
13045
|
+
}
|
|
13046
|
+
}
|
|
13047
|
+
}
|
|
13048
|
+
```
|
|
13049
|
+
|
|
13050
|
+
成功响应:
|
|
13051
|
+
|
|
13052
|
+
```json
|
|
13053
|
+
{
|
|
13054
|
+
"op": 122,
|
|
13055
|
+
"seq": 32,
|
|
13056
|
+
"ok": true,
|
|
13057
|
+
"data": {
|
|
13058
|
+
"me": {
|
|
13059
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
13060
|
+
"username": "alice",
|
|
13061
|
+
"camp": "yuan",
|
|
13062
|
+
"merit": 1240,
|
|
13063
|
+
"rank": 3,
|
|
13064
|
+
"entered": true,
|
|
13065
|
+
"squads": [
|
|
13066
|
+
{
|
|
13067
|
+
"id": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
|
|
13068
|
+
"x": 14,
|
|
13069
|
+
"y": 15,
|
|
13070
|
+
"status": "idle",
|
|
13071
|
+
"troops": {
|
|
13072
|
+
"porter": 0,
|
|
13073
|
+
"militia": 300,
|
|
13074
|
+
"scout": 0,
|
|
13075
|
+
"pikeman": 0,
|
|
13076
|
+
"swordsman": 200,
|
|
13077
|
+
"archer": 150,
|
|
13078
|
+
"cavalry": 50,
|
|
13079
|
+
"iron_cavalry": 0,
|
|
13080
|
+
"supply_wagon": 0,
|
|
13081
|
+
"ballista": 0,
|
|
13082
|
+
"siege_ram": 0,
|
|
13083
|
+
"yulin_guard": 0,
|
|
13084
|
+
"danyang_soldier": 0,
|
|
13085
|
+
"baimao_soldier": 0,
|
|
13086
|
+
"huwei_guard": 0,
|
|
13087
|
+
"zhuge_crossbow": 0,
|
|
13088
|
+
"xiandeng_warrior": 0,
|
|
13089
|
+
"hubao_cavalry": 0,
|
|
13090
|
+
"xiliang_cavalry": 0
|
|
13091
|
+
},
|
|
13092
|
+
"targetX": null,
|
|
13093
|
+
"targetY": null,
|
|
13094
|
+
"targetStrongholdId": null,
|
|
13095
|
+
"arriveAt": null,
|
|
13096
|
+
"originX": 13,
|
|
13097
|
+
"originY": 15,
|
|
13098
|
+
"strongholdId": null
|
|
13099
|
+
}
|
|
13100
|
+
],
|
|
13101
|
+
"cumulativeMerit": 3600
|
|
13102
|
+
}
|
|
13103
|
+
}
|
|
13104
|
+
}
|
|
13105
|
+
```
|
|
13106
|
+
|
|
13107
|
+
### op 123 · SPLIT_BATTLEFIELD_SQUAD — 拆分战场队伍(v75,AISLG-198)
|
|
13108
|
+
|
|
13109
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
13110
|
+
|
|
13111
|
+
从一支队伍里分出一支新队伍(位置相同、状态待命),每人最多 3 队;行军中不能拆。新队伍与原队伍都必须至少剩 1 个单位。
|
|
13112
|
+
|
|
13113
|
+
**请求字段**
|
|
13114
|
+
|
|
13115
|
+
| 字段 | 类型 | 说明 |
|
|
13116
|
+
| --- | --- | --- |
|
|
13117
|
+
| squadId | string | 必填。要拆分的队伍 id(GET_BATTLEFIELD 的 me.squads)。 |
|
|
13118
|
+
| troops | object | 必填。从原队伍分出的兵种数量,不能超过原队伍现有数量。 |
|
|
13119
|
+
|
|
13120
|
+
**响应 data 字段**
|
|
13121
|
+
|
|
13122
|
+
| 字段 | 类型 | 说明 |
|
|
13123
|
+
| --- | --- | --- |
|
|
13124
|
+
| event | object \| null | 当前 / 最近一场战场:{ id, script: guandu\|dongzhuo\|chibi, name, status: signup\|active\|finished, signupStartAt, startAt, endAt, camps: { yuan: { camp, name, signups, entered, score }, cao: 同结构 }, winner: yuan\|cao\|null, finishReason: score\|base_captured\|null, underdog: { camp, multiplier } \| null, wind: 赤壁专有 { direction: se\|nw, label, bonusCamp, nextAt, noticeAt }(其他剧本为 null) }。从未开过为 null。 |
|
|
13125
|
+
| nextSignupAt | string | 下一场报名开始时刻(北京时间每周二 20:00)。 |
|
|
13126
|
+
| nextScript | 'guandu' \| 'dongzhuo' \| 'chibi' | 下一场的剧本(轮换预告)。 |
|
|
13127
|
+
| strongholds | array | 本场据点(官渡 9 个 / 讨董 3 关 / 赤壁 10 个;讨董按推进线顺序):{ id, name, kind: base\|ford\|post\|granary, x, y, ownerCamp: yuan\|cao\|null(null = 中立 NPC;讨董的董卓军也是 null), pointsPerHour, garrison(全兵种计数,NPC + 玩家据守合计), garrisonPower(参考战力), wallLevel, towerLevel, firstCaptureAvailable(首占 +200 军功还没被拿过), capturedAt, unlocked(讨董:前一关未打下为 false;其他剧本恒为 true), chainUntil(赤壁曹方连锁截止,其他 null), fireNextAt(赤壁火攻冷却截止,其他 null) }。 |
|
|
13128
|
+
| me | object \| null | 本场我的状态:{ accountId, username, camp, merit 本场军功, rank 本场名次(未入场为 null), entered, squads: [{ id, x, y, status: marching\|idle\|garrison, troops, targetX, targetY, targetStrongholdId, arriveAt, originX, originY, strongholdId }], cumulativeMerit 跨场军功余额 };未报名为 null。 |
|
|
13129
|
+
| top | array | 本场军功榜前 10:{ rank, accountId, username, camp, merit }(同分并列,军功 0 不上榜)。 |
|
|
13130
|
+
| shop | object | 战场商店(赤壁多一个 iron_cavalry):{ cumulativeMerit, items: [{ item: resources\|hero_exp\|swordsman\|cavalry\|iron_cavalry, label, cost, limit, bought 本场已买, reward: { resources? , heroExp?, troop?, count? } }] }。 |
|
|
13131
|
+
| rewards | object | 奖励表:{ winner { label, gold, resourcesEach }, loser 同结构, rankTiers: [{ label, rank, maxRank, gold, resourcesEach }], progressTiers: [{ label, progress, gold, resourcesEach }](讨董的全服进度档;其他剧本为空数组) }。 |
|
|
13132
|
+
|
|
13133
|
+
**可能错误**:`INVALID_PARAMS`、`BATTLEFIELD_SQUAD_NOT_FOUND`、`BATTLEFIELD_SQUAD_BUSY`、`BATTLEFIELD_SQUAD_LIMIT`、`INSUFFICIENT_TROOPS`(处置建议见第 4 节)
|
|
13134
|
+
|
|
13135
|
+
**Agent 提示**:拆队适合「主力攻据点 + 骑兵绕后抢乌巢 / 渡口」这类分兵。行军中不能拆,先等到达。
|
|
13136
|
+
|
|
13137
|
+
**示例**
|
|
13138
|
+
|
|
13139
|
+
**从主力里分出 100 骑兵当机动队**
|
|
13140
|
+
|
|
13141
|
+
请求:
|
|
13142
|
+
|
|
13143
|
+
```json
|
|
13144
|
+
{
|
|
13145
|
+
"op": 123,
|
|
13146
|
+
"seq": 33,
|
|
13147
|
+
"data": {
|
|
13148
|
+
"squadId": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
|
|
13149
|
+
"troops": {
|
|
13150
|
+
"cavalry": 100
|
|
13151
|
+
}
|
|
13152
|
+
}
|
|
13153
|
+
}
|
|
13154
|
+
```
|
|
13155
|
+
|
|
13156
|
+
成功响应:
|
|
13157
|
+
|
|
13158
|
+
```json
|
|
13159
|
+
{
|
|
13160
|
+
"op": 123,
|
|
13161
|
+
"seq": 33,
|
|
13162
|
+
"ok": true,
|
|
13163
|
+
"data": {
|
|
13164
|
+
"me": {
|
|
13165
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
13166
|
+
"username": "alice",
|
|
13167
|
+
"camp": "yuan",
|
|
13168
|
+
"merit": 1240,
|
|
13169
|
+
"rank": 3,
|
|
13170
|
+
"entered": true,
|
|
13171
|
+
"squads": [
|
|
13172
|
+
{
|
|
13173
|
+
"id": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
|
|
13174
|
+
"x": 14,
|
|
13175
|
+
"y": 15,
|
|
13176
|
+
"status": "marching",
|
|
13177
|
+
"troops": {
|
|
13178
|
+
"porter": 0,
|
|
13179
|
+
"militia": 300,
|
|
13180
|
+
"scout": 0,
|
|
13181
|
+
"pikeman": 0,
|
|
13182
|
+
"swordsman": 200,
|
|
13183
|
+
"archer": 150,
|
|
13184
|
+
"cavalry": 50,
|
|
13185
|
+
"iron_cavalry": 0,
|
|
13186
|
+
"supply_wagon": 0,
|
|
13187
|
+
"ballista": 0,
|
|
13188
|
+
"siege_ram": 0,
|
|
13189
|
+
"yulin_guard": 0,
|
|
13190
|
+
"danyang_soldier": 0,
|
|
13191
|
+
"baimao_soldier": 0,
|
|
13192
|
+
"huwei_guard": 0,
|
|
13193
|
+
"zhuge_crossbow": 0,
|
|
13194
|
+
"xiandeng_warrior": 0,
|
|
13195
|
+
"hubao_cavalry": 0,
|
|
13196
|
+
"xiliang_cavalry": 0
|
|
13197
|
+
},
|
|
13198
|
+
"targetX": 15,
|
|
13199
|
+
"targetY": 15,
|
|
13200
|
+
"targetStrongholdId": "ford_yanjin",
|
|
13201
|
+
"arriveAt": "2026-09-25T08:01:00.000Z",
|
|
13202
|
+
"originX": 13,
|
|
13203
|
+
"originY": 15,
|
|
13204
|
+
"strongholdId": null
|
|
13205
|
+
},
|
|
13206
|
+
{
|
|
13207
|
+
"id": "…",
|
|
13208
|
+
"x": 14,
|
|
13209
|
+
"y": 15,
|
|
13210
|
+
"status": "marching",
|
|
13211
|
+
"troops": {
|
|
13212
|
+
"porter": 0,
|
|
13213
|
+
"militia": 300,
|
|
13214
|
+
"scout": 0,
|
|
13215
|
+
"pikeman": 0,
|
|
13216
|
+
"swordsman": 200,
|
|
13217
|
+
"archer": 150,
|
|
13218
|
+
"cavalry": 100,
|
|
13219
|
+
"iron_cavalry": 0,
|
|
13220
|
+
"supply_wagon": 0,
|
|
13221
|
+
"ballista": 0,
|
|
13222
|
+
"siege_ram": 0,
|
|
13223
|
+
"yulin_guard": 0,
|
|
13224
|
+
"danyang_soldier": 0,
|
|
13225
|
+
"baimao_soldier": 0,
|
|
13226
|
+
"huwei_guard": 0,
|
|
13227
|
+
"zhuge_crossbow": 0,
|
|
13228
|
+
"xiandeng_warrior": 0,
|
|
13229
|
+
"hubao_cavalry": 0,
|
|
13230
|
+
"xiliang_cavalry": 0
|
|
13231
|
+
},
|
|
13232
|
+
"targetX": 15,
|
|
13233
|
+
"targetY": 15,
|
|
13234
|
+
"targetStrongholdId": "ford_yanjin",
|
|
13235
|
+
"arriveAt": "2026-09-25T08:01:00.000Z",
|
|
13236
|
+
"originX": 13,
|
|
13237
|
+
"originY": 15,
|
|
13238
|
+
"strongholdId": null
|
|
13239
|
+
}
|
|
13240
|
+
],
|
|
13241
|
+
"cumulativeMerit": 3600
|
|
13242
|
+
}
|
|
13243
|
+
}
|
|
13244
|
+
}
|
|
13245
|
+
```
|
|
13246
|
+
|
|
13247
|
+
### op 124 · MARCH_BATTLEFIELD_SQUAD — 战场内行军 / 攻打据点(v75,AISLG-198)
|
|
13248
|
+
|
|
13249
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
13250
|
+
|
|
13251
|
+
给一支待命 / 据守中的队伍下令:目标给 strongholdId(自动取据点坐标)或 x / y;每格 60 秒现实时间,河只能从 3 处渡口(y=5/15/25)通过。到达友方据点 = 入驻据守(合并守军);到达敌方 / 中立据点 = 自动开战(有城墙的据点按守城战),胜方幸存部队留守、据点易手。行军中不能再次下令。讨伐董卓的关卡未解锁(unlocked 为 false)时返回 BATTLEFIELD_STRONGHOLD_LOCKED(附 unlockAfter)。
|
|
13252
|
+
|
|
13253
|
+
**请求字段**
|
|
13254
|
+
|
|
13255
|
+
| 字段 | 类型 | 说明 |
|
|
13256
|
+
| --- | --- | --- |
|
|
13257
|
+
| squadId | string | 必填。队伍 id。 |
|
|
13258
|
+
| strongholdId | string | 可选(与 x / y 二选一)。目标据点 id;同时给 x / y 时必须与据点坐标一致,否则 BATTLEFIELD_TARGET_INVALID。 |
|
|
13259
|
+
| x | number | 可选。目标横坐标(0..29);只在没有 strongholdId 时使用,且必须与 y 同时给。 |
|
|
13260
|
+
| y | number | 可选。目标纵坐标(0..29);只在没有 strongholdId 时使用。 |
|
|
13261
|
+
|
|
13262
|
+
**响应 data 字段**
|
|
13263
|
+
|
|
13264
|
+
| 字段 | 类型 | 说明 |
|
|
13265
|
+
| --- | --- | --- |
|
|
13266
|
+
| event | object \| null | 当前 / 最近一场战场:{ id, script: guandu\|dongzhuo\|chibi, name, status: signup\|active\|finished, signupStartAt, startAt, endAt, camps: { yuan: { camp, name, signups, entered, score }, cao: 同结构 }, winner: yuan\|cao\|null, finishReason: score\|base_captured\|null, underdog: { camp, multiplier } \| null, wind: 赤壁专有 { direction: se\|nw, label, bonusCamp, nextAt, noticeAt }(其他剧本为 null) }。从未开过为 null。 |
|
|
13267
|
+
| nextSignupAt | string | 下一场报名开始时刻(北京时间每周二 20:00)。 |
|
|
13268
|
+
| nextScript | 'guandu' \| 'dongzhuo' \| 'chibi' | 下一场的剧本(轮换预告)。 |
|
|
13269
|
+
| strongholds | array | 本场据点(官渡 9 个 / 讨董 3 关 / 赤壁 10 个;讨董按推进线顺序):{ id, name, kind: base\|ford\|post\|granary, x, y, ownerCamp: yuan\|cao\|null(null = 中立 NPC;讨董的董卓军也是 null), pointsPerHour, garrison(全兵种计数,NPC + 玩家据守合计), garrisonPower(参考战力), wallLevel, towerLevel, firstCaptureAvailable(首占 +200 军功还没被拿过), capturedAt, unlocked(讨董:前一关未打下为 false;其他剧本恒为 true), chainUntil(赤壁曹方连锁截止,其他 null), fireNextAt(赤壁火攻冷却截止,其他 null) }。 |
|
|
13270
|
+
| me | object \| null | 本场我的状态:{ accountId, username, camp, merit 本场军功, rank 本场名次(未入场为 null), entered, squads: [{ id, x, y, status: marching\|idle\|garrison, troops, targetX, targetY, targetStrongholdId, arriveAt, originX, originY, strongholdId }], cumulativeMerit 跨场军功余额 };未报名为 null。 |
|
|
13271
|
+
| top | array | 本场军功榜前 10:{ rank, accountId, username, camp, merit }(同分并列,军功 0 不上榜)。 |
|
|
13272
|
+
| shop | object | 战场商店(赤壁多一个 iron_cavalry):{ cumulativeMerit, items: [{ item: resources\|hero_exp\|swordsman\|cavalry\|iron_cavalry, label, cost, limit, bought 本场已买, reward: { resources? , heroExp?, troop?, count? } }] }。 |
|
|
13273
|
+
| rewards | object | 奖励表:{ winner { label, gold, resourcesEach }, loser 同结构, rankTiers: [{ label, rank, maxRank, gold, resourcesEach }], progressTiers: [{ label, progress, gold, resourcesEach }](讨董的全服进度档;其他剧本为空数组) }。 |
|
|
13274
|
+
|
|
13275
|
+
**可能错误**:`INVALID_PARAMS`、`BATTLEFIELD_NOT_ACTIVE`、`BATTLEFIELD_SQUAD_NOT_FOUND`、`BATTLEFIELD_SQUAD_BUSY`、`BATTLEFIELD_UNREACHABLE`、`BATTLEFIELD_TARGET_INVALID`、`BATTLEFIELD_STRONGHOLD_LOCKED`(处置建议见第 4 节)
|
|
13276
|
+
|
|
13277
|
+
**Agent 提示**:到达结算与战报由服务端在 Worker 里完成,客户端轮询 / 收 PUSH_BATTLEFIELD_STATE 后重查即可。攻打前对比 garrisonPower 与自己的队伍战力;没有把握先打渡口(10 分/小时)或普通据点。战败的幸存部队会退回出发位置。
|
|
13278
|
+
|
|
13279
|
+
**示例**
|
|
13280
|
+
|
|
13281
|
+
**从 (14,15) 攻打延津渡口**
|
|
13282
|
+
|
|
13283
|
+
请求:
|
|
13284
|
+
|
|
13285
|
+
```json
|
|
13286
|
+
{
|
|
13287
|
+
"op": 124,
|
|
13288
|
+
"seq": 34,
|
|
13289
|
+
"data": {
|
|
13290
|
+
"squadId": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
|
|
13291
|
+
"strongholdId": "ford_yanjin"
|
|
13292
|
+
}
|
|
13293
|
+
}
|
|
13294
|
+
```
|
|
13295
|
+
|
|
13296
|
+
成功响应:
|
|
13297
|
+
|
|
13298
|
+
```json
|
|
13299
|
+
{
|
|
13300
|
+
"op": 124,
|
|
13301
|
+
"seq": 34,
|
|
13302
|
+
"ok": true,
|
|
13303
|
+
"data": {
|
|
13304
|
+
"me": {
|
|
13305
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
13306
|
+
"username": "alice",
|
|
13307
|
+
"camp": "yuan",
|
|
13308
|
+
"merit": 1240,
|
|
13309
|
+
"rank": 3,
|
|
13310
|
+
"entered": true,
|
|
13311
|
+
"squads": [
|
|
13312
|
+
{
|
|
13313
|
+
"id": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
|
|
13314
|
+
"x": 14,
|
|
13315
|
+
"y": 15,
|
|
13316
|
+
"status": "marching",
|
|
13317
|
+
"troops": {
|
|
13318
|
+
"porter": 0,
|
|
13319
|
+
"militia": 300,
|
|
13320
|
+
"scout": 0,
|
|
13321
|
+
"pikeman": 0,
|
|
13322
|
+
"swordsman": 200,
|
|
13323
|
+
"archer": 150,
|
|
13324
|
+
"cavalry": 50,
|
|
13325
|
+
"iron_cavalry": 0,
|
|
13326
|
+
"supply_wagon": 0,
|
|
13327
|
+
"ballista": 0,
|
|
13328
|
+
"siege_ram": 0,
|
|
13329
|
+
"yulin_guard": 0,
|
|
13330
|
+
"danyang_soldier": 0,
|
|
13331
|
+
"baimao_soldier": 0,
|
|
13332
|
+
"huwei_guard": 0,
|
|
13333
|
+
"zhuge_crossbow": 0,
|
|
13334
|
+
"xiandeng_warrior": 0,
|
|
13335
|
+
"hubao_cavalry": 0,
|
|
13336
|
+
"xiliang_cavalry": 0
|
|
13337
|
+
},
|
|
13338
|
+
"targetX": 15,
|
|
13339
|
+
"targetY": 15,
|
|
13340
|
+
"targetStrongholdId": "ford_yanjin",
|
|
13341
|
+
"arriveAt": "2026-09-25T08:01:00.000Z",
|
|
13342
|
+
"originX": 13,
|
|
13343
|
+
"originY": 15,
|
|
13344
|
+
"strongholdId": null
|
|
13345
|
+
}
|
|
13346
|
+
],
|
|
13347
|
+
"cumulativeMerit": 3600
|
|
13348
|
+
}
|
|
13349
|
+
}
|
|
13350
|
+
}
|
|
13351
|
+
```
|
|
13352
|
+
|
|
13353
|
+
### op 125 · BUY_BATTLEFIELD_ITEM — 战场商店兑换(v75,AISLG-198)
|
|
13354
|
+
|
|
13355
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
13356
|
+
|
|
13357
|
+
用战场军功换东西(军功跨场累积、换季清零;每场限购,见 GET_BATTLEFIELD 的 shop.items):资源包 200 军功(每场限 5);武将经验 300 军功(每场限 3);刀盾兵 600 军功(每场限 2);轻骑兵 600 军功(每场限 2)。赤壁场次另有 铁骑兵 800 军功(直接进主城,每场限 1 次)。兑换即时到账(资源包进主城、兵直接进主城驻军、武将经验给指定武将),不占队列。
|
|
13358
|
+
|
|
13359
|
+
**请求字段**
|
|
13360
|
+
|
|
13361
|
+
| 字段 | 类型 | 说明 |
|
|
13362
|
+
| --- | --- | --- |
|
|
13363
|
+
| item | 'resources' \| 'hero_exp' \| 'swordsman' \| 'cavalry' \| 'iron_cavalry' | 必填。商品(iron_cavalry 仅赤壁场次可买)。 |
|
|
13364
|
+
| heroId | string | item=hero_exp 时必填:经验给这个武将(必须属于本账号)。 |
|
|
13365
|
+
|
|
13366
|
+
**响应 data 字段**
|
|
13367
|
+
|
|
13368
|
+
| 字段 | 类型 | 说明 |
|
|
13369
|
+
| --- | --- | --- |
|
|
13370
|
+
| item | string | 商品。 |
|
|
13371
|
+
| cost | number | 本次扣掉的军功。 |
|
|
13372
|
+
| cumulativeMerit | number | 兑换后的军功余额。 |
|
|
13373
|
+
| bought | number | 本场该商品累计已买数量(含本次)。 |
|
|
13374
|
+
| reward | object | 到账内容:{ resources? } / { heroExp, level, leveledTo } / { troop, count }。 |
|
|
13375
|
+
|
|
13376
|
+
**可能错误**:`INVALID_PARAMS`、`BATTLEFIELD_NOT_ACTIVE`、`BATTLEFIELD_SHOP_LIMIT`、`BATTLEFIELD_MERIT_INSUFFICIENT`、`HERO_NOT_FOUND`(处置建议见第 4 节)
|
|
13377
|
+
|
|
13378
|
+
**Agent 提示**:打得多不如换得准:资源包适合补建造缺口,武将经验给主力将,刀盾 / 轻骑直接补战损。注意每场限购,军功余额跨场保留但换季清零。
|
|
13379
|
+
|
|
13380
|
+
**示例**
|
|
13381
|
+
|
|
13382
|
+
**换一包资源**
|
|
13383
|
+
|
|
13384
|
+
请求:
|
|
13385
|
+
|
|
13386
|
+
```json
|
|
13387
|
+
{
|
|
13388
|
+
"op": 125,
|
|
13389
|
+
"seq": 35,
|
|
13390
|
+
"data": {
|
|
13391
|
+
"item": "resources"
|
|
13392
|
+
}
|
|
13393
|
+
}
|
|
13394
|
+
```
|
|
13395
|
+
|
|
13396
|
+
成功响应:
|
|
13397
|
+
|
|
13398
|
+
```json
|
|
13399
|
+
{
|
|
13400
|
+
"op": 125,
|
|
13401
|
+
"seq": 35,
|
|
13402
|
+
"ok": true,
|
|
13403
|
+
"data": {
|
|
13404
|
+
"item": "resources",
|
|
13405
|
+
"cost": 200,
|
|
13406
|
+
"cumulativeMerit": 3400,
|
|
13407
|
+
"bought": 1,
|
|
13408
|
+
"reward": {
|
|
13409
|
+
"resources": {
|
|
13410
|
+
"gold": 0,
|
|
13411
|
+
"wood": 10000,
|
|
13412
|
+
"food": 10000,
|
|
13413
|
+
"stone": 10000,
|
|
13414
|
+
"iron": 10000
|
|
13415
|
+
}
|
|
13416
|
+
}
|
|
13417
|
+
}
|
|
13418
|
+
}
|
|
13419
|
+
```
|
|
13420
|
+
|
|
13421
|
+
### op 126 · GET_NOBILITY — 查询声望与爵位(v76,AISLG-197)
|
|
13422
|
+
|
|
13423
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
13424
|
+
|
|
13425
|
+
累计声望只增不减:世界地图上的每一场战斗(攻守、输赢、NPC / 玩家 / 黄巾)按歼灭敌军的参考战力 1:1 计;剧本战场的军功按 1 军功 = 1 声望再计一次。竞技场与将星塔不计。爵位共 10 级(平民 0 / 公士 100 / 簪袅 500 / 大夫 2000 / 公乘 6000 / 五大夫 15000 / 庶长 35000 / 关内侯 80000 / 列侯 160000 / 王 300000),达到门槛自动升级;升到大夫及以上会全服播报。大夫(3)起可以占领名城(之前只能打外围与掠夺);五大夫 / 列侯各让普通武将上限 +1。每日俸禄(金币 = 爵位序号 × 200 × 全局时间缩放,当前示例 公士 10000 金、簪袅 20000 金、大夫 30000 金、公乘 40000 金)在北京时间每天 0 点后领一次,用 CLAIM_NOBILITY_SALARY。声威与爵位随赛季重置;上一季的最高爵位随名人堂留存。
|
|
13426
|
+
|
|
13427
|
+
**请求字段**
|
|
13428
|
+
|
|
13429
|
+
无请求字段(`data` 可省略)。
|
|
13430
|
+
|
|
13431
|
+
**响应 data 字段**
|
|
13432
|
+
|
|
13433
|
+
| 字段 | 类型 | 说明 |
|
|
13434
|
+
| --- | --- | --- |
|
|
13435
|
+
| prestige | number | 累计声望。 |
|
|
13436
|
+
| index | number | 爵位序号(0 = 平民)。 |
|
|
13437
|
+
| name | string | 爵位名称。 |
|
|
13438
|
+
| privilege | string | 该爵位特权说明。 |
|
|
13439
|
+
| next | object \| null | 下一级爵位 { index, name, threshold };已到「王」为 null。 |
|
|
13440
|
+
| progressPercent | number | 距离下一级的进度(0..100;满级 100)。 |
|
|
13441
|
+
| salaryGold | number | 每日俸禄金额(金币;平民 0;已按全局时间缩放折算)。 |
|
|
13442
|
+
| claimedToday | boolean | 今日(北京日)是否已领。 |
|
|
13443
|
+
| claimable | boolean | 现在是否可以领。 |
|
|
13444
|
+
| lastClaimedAt | string \| null | 最近一次领取时刻;从未领过为 null。 |
|
|
13445
|
+
| nextClaimAt | string | 下次可领时刻(今日已领 = 明日 0 点北京时间;否则为现在)。 |
|
|
13446
|
+
| heroCapBonus | number | 普通武将上限加成(五大夫 +1、列侯再 +1)。 |
|
|
13447
|
+
| canOccupyFamous | boolean | 能否占领名城(爵位 ≥ 大夫)。 |
|
|
13448
|
+
|
|
13449
|
+
**Agent 提示**:声望是长期累积线:能打就打,不用刻意刷。打名城前先确认 canOccupyFamous;否则先打 NPC 城 / 野地攒到 2000 声望。俸禄每天记得领(claimable 为 true 时),金额随爵位提高。
|
|
13450
|
+
|
|
13451
|
+
**示例**
|
|
13452
|
+
|
|
13453
|
+
**大夫:今天还能领俸禄,距公乘还差 3650 声望**
|
|
13454
|
+
|
|
13455
|
+
请求:
|
|
13456
|
+
|
|
13457
|
+
```json
|
|
13458
|
+
{
|
|
13459
|
+
"op": 126,
|
|
13460
|
+
"seq": 40,
|
|
13461
|
+
"data": {}
|
|
13462
|
+
}
|
|
13463
|
+
```
|
|
13464
|
+
|
|
13465
|
+
成功响应:
|
|
13466
|
+
|
|
13467
|
+
```json
|
|
13468
|
+
{
|
|
13469
|
+
"op": 126,
|
|
13470
|
+
"seq": 40,
|
|
13471
|
+
"ok": true,
|
|
13472
|
+
"data": {
|
|
13473
|
+
"prestige": 2350,
|
|
13474
|
+
"index": 3,
|
|
13475
|
+
"name": "大夫",
|
|
13476
|
+
"privilege": "可占领名城;每日俸禄",
|
|
13477
|
+
"next": {
|
|
13478
|
+
"index": 4,
|
|
13479
|
+
"name": "公乘",
|
|
13480
|
+
"threshold": 6000
|
|
13481
|
+
},
|
|
13482
|
+
"progressPercent": 8,
|
|
13483
|
+
"salaryGold": 30000,
|
|
13484
|
+
"claimedToday": false,
|
|
13485
|
+
"claimable": true,
|
|
13486
|
+
"lastClaimedAt": null,
|
|
13487
|
+
"nextClaimAt": "2026-10-27T04:00:00.000Z",
|
|
13488
|
+
"heroCapBonus": 0,
|
|
13489
|
+
"canOccupyFamous": true
|
|
13490
|
+
}
|
|
13491
|
+
}
|
|
13492
|
+
```
|
|
13493
|
+
|
|
13494
|
+
### op 127 · CLAIM_NOBILITY_SALARY — 领取每日爵位俸禄(v76,AISLG-197)
|
|
13495
|
+
|
|
13496
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
13497
|
+
|
|
13498
|
+
按北京日领取一次爵位俸禄(金币),直接加到主城。平民没有俸禄(NOBILITY_SALARY_NONE);今日已领返回 NOBILITY_SALARY_CLAIMED(附 nextClaimAt)。金额 = 爵位序号 × 200 × 全局时间缩放。
|
|
13499
|
+
|
|
13500
|
+
**请求字段**
|
|
13501
|
+
|
|
13502
|
+
无请求字段(`data` 可省略)。
|
|
13503
|
+
|
|
13504
|
+
**响应 data 字段**
|
|
13505
|
+
|
|
13506
|
+
| 字段 | 类型 | 说明 |
|
|
13507
|
+
| --- | --- | --- |
|
|
13508
|
+
| gold | number | 本次领取的金币。 |
|
|
13509
|
+
| index | number | 领取后的爵位序号。 |
|
|
13510
|
+
| name | string | 领取后的爵位名称。 |
|
|
13511
|
+
| prestige | number | 领取后的累计声望。 |
|
|
13512
|
+
| claimedAt | string | 领取时刻(ISO 8601)。 |
|
|
13513
|
+
|
|
13514
|
+
**可能错误**:`NOBILITY_SALARY_NONE`、`NOBILITY_SALARY_CLAIMED`(处置建议见第 4 节)
|
|
13515
|
+
|
|
13516
|
+
**Agent 提示**:每天上线先领一次(幂等:重复领只会返回已领)。金币直接进主城,可用于建造 / 征兵 / 俸禄。
|
|
13517
|
+
|
|
13518
|
+
**示例**
|
|
13519
|
+
|
|
13520
|
+
**大夫领取 3 万金(示例按 50 倍缩放)**
|
|
13521
|
+
|
|
13522
|
+
请求:
|
|
13523
|
+
|
|
13524
|
+
```json
|
|
13525
|
+
{
|
|
13526
|
+
"op": 127,
|
|
13527
|
+
"seq": 41,
|
|
13528
|
+
"data": {}
|
|
13529
|
+
}
|
|
13530
|
+
```
|
|
13531
|
+
|
|
13532
|
+
成功响应:
|
|
13533
|
+
|
|
13534
|
+
```json
|
|
13535
|
+
{
|
|
13536
|
+
"op": 127,
|
|
13537
|
+
"seq": 41,
|
|
13538
|
+
"ok": true,
|
|
13539
|
+
"data": {
|
|
13540
|
+
"gold": 30000,
|
|
13541
|
+
"index": 3,
|
|
13542
|
+
"name": "大夫",
|
|
13543
|
+
"prestige": 2350,
|
|
13544
|
+
"claimedAt": "2026-10-27T04:00:00.000Z"
|
|
13545
|
+
}
|
|
13546
|
+
}
|
|
13547
|
+
```
|
|
13548
|
+
|
|
13549
|
+
### op 128 · ALLIANCE_DIPLOMACY_INVITE — 发起友好邀请(v77,AISLG-195)
|
|
13550
|
+
|
|
13551
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
13552
|
+
|
|
13553
|
+
联盟之间有三种关系:**中立**(默认)/ **友好**(一方发邀请、另一方同意,邀请 48 小时过期)/ **敌对**(一方单方面宣布,不需要对方同意)。友盟双方成员互不攻击(掠夺、抢野地、占分城、侦察都返回 ALLY_NOT_ATTACKABLE),可以互相协防;地图上显示友军色。敌对只在地图上标红、来袭预警标出「敌对联盟」,不改变战斗与收益规则(不等于宣战)。上限:每个联盟最多 2 个友盟、5 个敌对。解除友好后 24 小时内双方仍不能互相攻击,72 小时内不能再次结好。管理操作仅限玩家连接的盟主 / 副盟主(Agent 返回 AGENT_FORBIDDEN);关系变化在双方联盟频道发系统消息,结友 / 宣布敌对另发全服播报;换季关系保留、邀请清空。 本协议由盟主 / 副盟主向另一个联盟发出友好邀请(48 小时有效)。双方任一方的友盟已达 2 个返回 DIPLOMACY_LIMIT;已是友盟 / 敌对返回 DIPLOMACY_EXISTS;解除友好 72 小时冷却内返回 DIPLOMACY_COOLDOWN。仅玩家连接。
|
|
13554
|
+
|
|
13555
|
+
**请求字段**
|
|
13556
|
+
|
|
13557
|
+
| 字段 | 类型 | 说明 |
|
|
13558
|
+
| --- | --- | --- |
|
|
13559
|
+
| allianceId | string | 目标联盟 id。 |
|
|
13560
|
+
|
|
13561
|
+
**响应 data 字段**
|
|
13562
|
+
|
|
13563
|
+
| 字段 | 类型 | 说明 |
|
|
13564
|
+
| --- | --- | --- |
|
|
13565
|
+
| (同 GET_ALLIANCE_DIPLOMACY) | object | 返回最新外交全貌(含刚发出的邀请)。 |
|
|
13566
|
+
|
|
13567
|
+
**可能错误**:`INVALID_PARAMS`、`ALLIANCE_NOT_IN`、`ALLIANCE_FORBIDDEN`、`ALLIANCE_NOT_FOUND`、`DIPLOMACY_LIMIT`、`DIPLOMACY_EXISTS`、`DIPLOMACY_COOLDOWN`(处置建议见第 4 节)
|
|
13568
|
+
|
|
13569
|
+
**Agent 提示**:管理操作 Agent 不能做;由玩家的盟主 / 副盟主在联盟面板发起。
|
|
13570
|
+
|
|
13571
|
+
**示例**
|
|
13572
|
+
|
|
13573
|
+
**向洛阳盟发出邀请**
|
|
13574
|
+
|
|
13575
|
+
请求:
|
|
13576
|
+
|
|
13577
|
+
```json
|
|
13578
|
+
{
|
|
13579
|
+
"op": 128,
|
|
13580
|
+
"seq": 51,
|
|
13581
|
+
"data": {
|
|
13582
|
+
"allianceId": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70"
|
|
13583
|
+
}
|
|
13584
|
+
}
|
|
13585
|
+
```
|
|
13586
|
+
|
|
13587
|
+
成功响应:
|
|
13588
|
+
|
|
13589
|
+
```json
|
|
13590
|
+
{
|
|
13591
|
+
"op": 128,
|
|
13592
|
+
"seq": 51,
|
|
13593
|
+
"ok": true,
|
|
13594
|
+
"data": {
|
|
13595
|
+
"allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
|
|
13596
|
+
"friends": [
|
|
13597
|
+
{
|
|
13598
|
+
"alliance": {
|
|
13599
|
+
"id": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70",
|
|
13600
|
+
"name": "洛阳盟",
|
|
13601
|
+
"leader": {
|
|
13602
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
13603
|
+
"username": "bob"
|
|
13604
|
+
},
|
|
13605
|
+
"memberCount": 18,
|
|
13606
|
+
"maxMembers": 30,
|
|
13607
|
+
"createdAt": "2026-09-25T08:00:00.000Z"
|
|
13608
|
+
},
|
|
13609
|
+
"relation": "friendly",
|
|
13610
|
+
"since": "2026-09-25T08:00:00.000Z",
|
|
13611
|
+
"noAttackUntil": null,
|
|
13612
|
+
"refriendAfter": null
|
|
13613
|
+
}
|
|
13614
|
+
],
|
|
13615
|
+
"hostiles": [],
|
|
13616
|
+
"invites": [
|
|
13617
|
+
{
|
|
13618
|
+
"id": "12",
|
|
13619
|
+
"alliance": {
|
|
13620
|
+
"id": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70",
|
|
13621
|
+
"name": "洛阳盟",
|
|
13622
|
+
"leader": {
|
|
13623
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
13624
|
+
"username": "bob"
|
|
13625
|
+
},
|
|
13626
|
+
"memberCount": 18,
|
|
13627
|
+
"maxMembers": 30,
|
|
13628
|
+
"createdAt": "2026-09-25T08:00:00.000Z"
|
|
13629
|
+
},
|
|
13630
|
+
"inviter": {
|
|
13631
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
13632
|
+
"username": "bob"
|
|
13633
|
+
},
|
|
13634
|
+
"direction": "received",
|
|
13635
|
+
"createdAt": "2026-09-25T08:00:00.000Z",
|
|
13636
|
+
"expiresAt": "2026-09-27T08:00:00.000Z"
|
|
13637
|
+
}
|
|
13638
|
+
],
|
|
13639
|
+
"limits": {
|
|
13640
|
+
"friends": 2,
|
|
13641
|
+
"hostiles": 5
|
|
13642
|
+
}
|
|
13643
|
+
}
|
|
13644
|
+
}
|
|
13645
|
+
```
|
|
13646
|
+
|
|
13647
|
+
### op 129 · ALLIANCE_DIPLOMACY_RESPOND — 同意 / 拒绝友好邀请(v77,AISLG-195)
|
|
13648
|
+
|
|
13649
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
13650
|
+
|
|
13651
|
+
联盟之间有三种关系:**中立**(默认)/ **友好**(一方发邀请、另一方同意,邀请 48 小时过期)/ **敌对**(一方单方面宣布,不需要对方同意)。友盟双方成员互不攻击(掠夺、抢野地、占分城、侦察都返回 ALLY_NOT_ATTACKABLE),可以互相协防;地图上显示友军色。敌对只在地图上标红、来袭预警标出「敌对联盟」,不改变战斗与收益规则(不等于宣战)。上限:每个联盟最多 2 个友盟、5 个敌对。解除友好后 24 小时内双方仍不能互相攻击,72 小时内不能再次结好。管理操作仅限玩家连接的盟主 / 副盟主(Agent 返回 AGENT_FORBIDDEN);关系变化在双方联盟频道发系统消息,结友 / 宣布敌对另发全服播报;换季关系保留、邀请清空。 本协议由收到邀请一方的盟主 / 副盟主答复(accept=true 同意 / false 拒绝)。同意时双方友盟名额、72 小时冷却都会复核(不通过返回 DIPLOMACY_LIMIT / DIPLOMACY_COOLDOWN),成功后双方联盟频道各写一条系统消息并全服播报。仅玩家连接。
|
|
13652
|
+
|
|
13653
|
+
**请求字段**
|
|
13654
|
+
|
|
13655
|
+
| 字段 | 类型 | 说明 |
|
|
13656
|
+
| --- | --- | --- |
|
|
13657
|
+
| inviteId | string | 邀请 id(GET_ALLIANCE_DIPLOMACY 的 invites[].id)。 |
|
|
13658
|
+
| accept | boolean | true 同意 / false 拒绝。 |
|
|
13659
|
+
|
|
13660
|
+
**响应 data 字段**
|
|
13661
|
+
|
|
13662
|
+
| 字段 | 类型 | 说明 |
|
|
13663
|
+
| --- | --- | --- |
|
|
13664
|
+
| (同 GET_ALLIANCE_DIPLOMACY) | object | 返回最新外交全貌。 |
|
|
13665
|
+
|
|
13666
|
+
**可能错误**:`INVALID_PARAMS`、`ALLIANCE_NOT_IN`、`ALLIANCE_FORBIDDEN`、`DIPLOMACY_INVITE_NOT_FOUND`、`DIPLOMACY_LIMIT`、`DIPLOMACY_EXISTS`、`DIPLOMACY_COOLDOWN`(处置建议见第 4 节)
|
|
13667
|
+
|
|
13668
|
+
**Agent 提示**:同意后双方成员立即不能互相攻击,且可以互相协防;规划军事行动前先确认。
|
|
13669
|
+
|
|
13670
|
+
**示例**
|
|
13671
|
+
|
|
13672
|
+
**同意邀请,双方成为友盟**
|
|
13673
|
+
|
|
13674
|
+
请求:
|
|
13675
|
+
|
|
13676
|
+
```json
|
|
13677
|
+
{
|
|
13678
|
+
"op": 129,
|
|
13679
|
+
"seq": 52,
|
|
13680
|
+
"data": {
|
|
13681
|
+
"inviteId": "12",
|
|
13682
|
+
"accept": true
|
|
13683
|
+
}
|
|
13684
|
+
}
|
|
13685
|
+
```
|
|
13686
|
+
|
|
13687
|
+
成功响应:
|
|
13688
|
+
|
|
13689
|
+
```json
|
|
13690
|
+
{
|
|
13691
|
+
"op": 129,
|
|
13692
|
+
"seq": 52,
|
|
13693
|
+
"ok": true,
|
|
13694
|
+
"data": {
|
|
13695
|
+
"allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
|
|
13696
|
+
"friends": [
|
|
13697
|
+
{
|
|
13698
|
+
"alliance": {
|
|
13699
|
+
"id": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70",
|
|
13700
|
+
"name": "洛阳盟",
|
|
13701
|
+
"leader": {
|
|
13702
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
13703
|
+
"username": "bob"
|
|
13704
|
+
},
|
|
13705
|
+
"memberCount": 18,
|
|
13706
|
+
"maxMembers": 30,
|
|
13707
|
+
"createdAt": "2026-09-25T08:00:00.000Z"
|
|
13708
|
+
},
|
|
13709
|
+
"relation": "friendly",
|
|
13710
|
+
"since": "2026-09-25T08:00:00.000Z",
|
|
13711
|
+
"noAttackUntil": null,
|
|
13712
|
+
"refriendAfter": null
|
|
13713
|
+
}
|
|
13714
|
+
],
|
|
13715
|
+
"hostiles": [],
|
|
13716
|
+
"invites": [],
|
|
13717
|
+
"limits": {
|
|
13718
|
+
"friends": 2,
|
|
13719
|
+
"hostiles": 5
|
|
13720
|
+
}
|
|
13721
|
+
}
|
|
13722
|
+
}
|
|
13723
|
+
```
|
|
13724
|
+
|
|
13725
|
+
### op 130 · ALLIANCE_DIPLOMACY_END — 解除友好 / 敌对(v77,AISLG-195)
|
|
13726
|
+
|
|
13727
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
13728
|
+
|
|
13729
|
+
联盟之间有三种关系:**中立**(默认)/ **友好**(一方发邀请、另一方同意,邀请 48 小时过期)/ **敌对**(一方单方面宣布,不需要对方同意)。友盟双方成员互不攻击(掠夺、抢野地、占分城、侦察都返回 ALLY_NOT_ATTACKABLE),可以互相协防;地图上显示友军色。敌对只在地图上标红、来袭预警标出「敌对联盟」,不改变战斗与收益规则(不等于宣战)。上限:每个联盟最多 2 个友盟、5 个敌对。解除友好后 24 小时内双方仍不能互相攻击,72 小时内不能再次结好。管理操作仅限玩家连接的盟主 / 副盟主(Agent 返回 AGENT_FORBIDDEN);关系变化在双方联盟频道发系统消息,结友 / 宣布敌对另发全服播报;换季关系保留、邀请清空。 本协议由盟主 / 副盟主单方面解除与目标联盟的友好或敌对,回到中立。解除友好会写入 24 小时不可攻击 + 72 小时不可再结好的冷却(防解约偷袭 / 反复横跳)。仅玩家连接。
|
|
13730
|
+
|
|
13731
|
+
**请求字段**
|
|
13732
|
+
|
|
13733
|
+
| 字段 | 类型 | 说明 |
|
|
13734
|
+
| --- | --- | --- |
|
|
13735
|
+
| allianceId | string | 目标联盟 id。 |
|
|
13736
|
+
|
|
13737
|
+
**响应 data 字段**
|
|
13738
|
+
|
|
13739
|
+
| 字段 | 类型 | 说明 |
|
|
13740
|
+
| --- | --- | --- |
|
|
13741
|
+
| (同 GET_ALLIANCE_DIPLOMACY) | object | 返回最新外交全貌。 |
|
|
13742
|
+
|
|
13743
|
+
**可能错误**:`INVALID_PARAMS`、`ALLIANCE_NOT_IN`、`ALLIANCE_FORBIDDEN`(处置建议见第 4 节)
|
|
13744
|
+
|
|
13745
|
+
**Agent 提示**:解除友好不等于立刻能打:24 小时冷却内攻击仍会被拒(ALLY_NOT_ATTACKABLE)。
|
|
13746
|
+
|
|
13747
|
+
**示例**
|
|
13748
|
+
|
|
13749
|
+
**解除与洛阳盟的友好(24 小时内仍不能互相攻击)**
|
|
13750
|
+
|
|
13751
|
+
请求:
|
|
13752
|
+
|
|
13753
|
+
```json
|
|
13754
|
+
{
|
|
13755
|
+
"op": 130,
|
|
13756
|
+
"seq": 53,
|
|
13757
|
+
"data": {
|
|
13758
|
+
"allianceId": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70"
|
|
13759
|
+
}
|
|
13760
|
+
}
|
|
13761
|
+
```
|
|
13762
|
+
|
|
13763
|
+
成功响应:
|
|
13764
|
+
|
|
13765
|
+
```json
|
|
13766
|
+
{
|
|
13767
|
+
"op": 130,
|
|
13768
|
+
"seq": 53,
|
|
13769
|
+
"ok": true,
|
|
13770
|
+
"data": {
|
|
13771
|
+
"allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
|
|
13772
|
+
"friends": [],
|
|
13773
|
+
"hostiles": [],
|
|
13774
|
+
"invites": [],
|
|
13775
|
+
"limits": {
|
|
13776
|
+
"friends": 2,
|
|
13777
|
+
"hostiles": 5
|
|
13778
|
+
}
|
|
13779
|
+
}
|
|
13780
|
+
}
|
|
13781
|
+
```
|
|
13782
|
+
|
|
13783
|
+
### op 131 · ALLIANCE_DIPLOMACY_HOSTILE — 宣布敌对(v77,AISLG-195)
|
|
13784
|
+
|
|
13785
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
13786
|
+
|
|
13787
|
+
联盟之间有三种关系:**中立**(默认)/ **友好**(一方发邀请、另一方同意,邀请 48 小时过期)/ **敌对**(一方单方面宣布,不需要对方同意)。友盟双方成员互不攻击(掠夺、抢野地、占分城、侦察都返回 ALLY_NOT_ATTACKABLE),可以互相协防;地图上显示友军色。敌对只在地图上标红、来袭预警标出「敌对联盟」,不改变战斗与收益规则(不等于宣战)。上限:每个联盟最多 2 个友盟、5 个敌对。解除友好后 24 小时内双方仍不能互相攻击,72 小时内不能再次结好。管理操作仅限玩家连接的盟主 / 副盟主(Agent 返回 AGENT_FORBIDDEN);关系变化在双方联盟频道发系统消息,结友 / 宣布敌对另发全服播报;换季关系保留、邀请清空。 本协议由盟主 / 副盟主单方面把目标联盟标为敌对(不需要对方同意,最多 5 个),地图上对方成员的城与野地标红、对方来袭时预警标出「敌对联盟」。若原是友盟,保留 24 小时不可攻击冷却。仅玩家连接。
|
|
13788
|
+
|
|
13789
|
+
**请求字段**
|
|
13790
|
+
|
|
13791
|
+
| 字段 | 类型 | 说明 |
|
|
13792
|
+
| --- | --- | --- |
|
|
13793
|
+
| allianceId | string | 目标联盟 id。 |
|
|
13794
|
+
|
|
13795
|
+
**响应 data 字段**
|
|
13796
|
+
|
|
13797
|
+
| 字段 | 类型 | 说明 |
|
|
13798
|
+
| --- | --- | --- |
|
|
13799
|
+
| (同 GET_ALLIANCE_DIPLOMACY) | object | 返回最新外交全貌。 |
|
|
13800
|
+
|
|
13801
|
+
**可能错误**:`INVALID_PARAMS`、`ALLIANCE_NOT_IN`、`ALLIANCE_FORBIDDEN`、`DIPLOMACY_LIMIT`、`DIPLOMACY_EXISTS`(处置建议见第 4 节)
|
|
13802
|
+
|
|
13803
|
+
**Agent 提示**:敌对只是标记,不改变战斗与收益;可以随时单方面解除回到中立。
|
|
13804
|
+
|
|
13805
|
+
**示例**
|
|
13806
|
+
|
|
13807
|
+
**把洛阳盟标为敌对**
|
|
13808
|
+
|
|
13809
|
+
请求:
|
|
13810
|
+
|
|
13811
|
+
```json
|
|
13812
|
+
{
|
|
13813
|
+
"op": 131,
|
|
13814
|
+
"seq": 54,
|
|
13815
|
+
"data": {
|
|
13816
|
+
"allianceId": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70"
|
|
13817
|
+
}
|
|
13818
|
+
}
|
|
13819
|
+
```
|
|
13820
|
+
|
|
13821
|
+
成功响应:
|
|
13822
|
+
|
|
13823
|
+
```json
|
|
13824
|
+
{
|
|
13825
|
+
"op": 131,
|
|
13826
|
+
"seq": 54,
|
|
13827
|
+
"ok": true,
|
|
13828
|
+
"data": {
|
|
13829
|
+
"allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
|
|
13830
|
+
"friends": [],
|
|
13831
|
+
"hostiles": [
|
|
13832
|
+
{
|
|
13833
|
+
"alliance": {
|
|
13834
|
+
"id": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70",
|
|
13835
|
+
"name": "洛阳盟",
|
|
13836
|
+
"leader": {
|
|
13837
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
13838
|
+
"username": "bob"
|
|
13839
|
+
},
|
|
13840
|
+
"memberCount": 18,
|
|
13841
|
+
"maxMembers": 30,
|
|
13842
|
+
"createdAt": "2026-09-25T08:00:00.000Z"
|
|
13843
|
+
},
|
|
13844
|
+
"relation": "hostile",
|
|
13845
|
+
"since": "2026-09-25T08:00:00.000Z",
|
|
13846
|
+
"noAttackUntil": null,
|
|
13847
|
+
"refriendAfter": null
|
|
13848
|
+
}
|
|
13849
|
+
],
|
|
13850
|
+
"invites": [
|
|
13851
|
+
{
|
|
13852
|
+
"id": "12",
|
|
13853
|
+
"alliance": {
|
|
13854
|
+
"id": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70",
|
|
13855
|
+
"name": "洛阳盟",
|
|
13856
|
+
"leader": {
|
|
13857
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
13858
|
+
"username": "bob"
|
|
13859
|
+
},
|
|
13860
|
+
"memberCount": 18,
|
|
13861
|
+
"maxMembers": 30,
|
|
13862
|
+
"createdAt": "2026-09-25T08:00:00.000Z"
|
|
13863
|
+
},
|
|
13864
|
+
"inviter": {
|
|
13865
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
13866
|
+
"username": "bob"
|
|
13867
|
+
},
|
|
13868
|
+
"direction": "received",
|
|
13869
|
+
"createdAt": "2026-09-25T08:00:00.000Z",
|
|
13870
|
+
"expiresAt": "2026-09-27T08:00:00.000Z"
|
|
13871
|
+
}
|
|
13872
|
+
],
|
|
13873
|
+
"limits": {
|
|
13874
|
+
"friends": 2,
|
|
13875
|
+
"hostiles": 5
|
|
13876
|
+
}
|
|
13877
|
+
}
|
|
13878
|
+
}
|
|
13879
|
+
```
|
|
13880
|
+
|
|
13881
|
+
### op 132 · GET_ALLIANCE_DIPLOMACY — 查询联盟外交(v77,AISLG-195)
|
|
13882
|
+
|
|
13883
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
13884
|
+
|
|
13885
|
+
联盟之间有三种关系:**中立**(默认)/ **友好**(一方发邀请、另一方同意,邀请 48 小时过期)/ **敌对**(一方单方面宣布,不需要对方同意)。友盟双方成员互不攻击(掠夺、抢野地、占分城、侦察都返回 ALLY_NOT_ATTACKABLE),可以互相协防;地图上显示友军色。敌对只在地图上标红、来袭预警标出「敌对联盟」,不改变战斗与收益规则(不等于宣战)。上限:每个联盟最多 2 个友盟、5 个敌对。解除友好后 24 小时内双方仍不能互相攻击,72 小时内不能再次结好。管理操作仅限玩家连接的盟主 / 副盟主(Agent 返回 AGENT_FORBIDDEN);关系变化在双方联盟频道发系统消息,结友 / 宣布敌对另发全服播报;换季关系保留、邀请清空。 本协议返回本联盟的友盟名单、敌对名单与待处理邀请(发出 / 收到);玩家与 Agent 通用。没有联盟返回 ALLIANCE_NOT_IN。
|
|
13886
|
+
|
|
13887
|
+
**请求字段**
|
|
13888
|
+
|
|
13889
|
+
无请求字段(`data` 可省略)。
|
|
13890
|
+
|
|
13891
|
+
**响应 data 字段**
|
|
13892
|
+
|
|
13893
|
+
| 字段 | 类型 | 说明 |
|
|
13894
|
+
| --- | --- | --- |
|
|
13895
|
+
| allianceId | string | 我的联盟 id。 |
|
|
13896
|
+
| friends | array | 友盟名单(最多 2 个):{ alliance 联盟概要 { id, name, leader, memberCount, maxMembers, createdAt }, relation: friendly, since, noAttackUntil, refriendAfter }。 |
|
|
13897
|
+
| hostiles | array | 敌对名单(最多 5 个):结构同 friends,relation: hostile。 |
|
|
13898
|
+
| invites | array | 待处理友好邀请:{ id, alliance 对方联盟, inviter 发起人, direction: sent\|received, createdAt, expiresAt }。 |
|
|
13899
|
+
| limits | object | 上限:{ friends: 2, hostiles: 5 }。 |
|
|
13900
|
+
|
|
13901
|
+
**可能错误**:`ALLIANCE_NOT_IN`(处置建议见第 4 节)
|
|
13902
|
+
|
|
13903
|
+
**Agent 提示**:外交是盟主 / 副盟主的玩家操作,Agent 只能查。友盟成员不能互相攻击,规划进攻前先查 friendships;解除友好有 24 小时不可攻击 + 72 小时不可再结好的冷却。
|
|
13904
|
+
|
|
13905
|
+
**示例**
|
|
13906
|
+
|
|
13907
|
+
**有一个友盟,并收到洛阳盟的邀请**
|
|
13908
|
+
|
|
13909
|
+
请求:
|
|
13910
|
+
|
|
13911
|
+
```json
|
|
13912
|
+
{
|
|
13913
|
+
"op": 132,
|
|
13914
|
+
"seq": 50,
|
|
13915
|
+
"data": {}
|
|
13916
|
+
}
|
|
13917
|
+
```
|
|
13918
|
+
|
|
13919
|
+
成功响应:
|
|
13920
|
+
|
|
13921
|
+
```json
|
|
13922
|
+
{
|
|
13923
|
+
"op": 132,
|
|
13924
|
+
"seq": 50,
|
|
13925
|
+
"ok": true,
|
|
13926
|
+
"data": {
|
|
13927
|
+
"allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
|
|
13928
|
+
"friends": [
|
|
13929
|
+
{
|
|
13930
|
+
"alliance": {
|
|
13931
|
+
"id": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70",
|
|
13932
|
+
"name": "洛阳盟",
|
|
13933
|
+
"leader": {
|
|
13934
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
13935
|
+
"username": "bob"
|
|
13936
|
+
},
|
|
13937
|
+
"memberCount": 18,
|
|
13938
|
+
"maxMembers": 30,
|
|
13939
|
+
"createdAt": "2026-09-25T08:00:00.000Z"
|
|
13940
|
+
},
|
|
13941
|
+
"relation": "friendly",
|
|
13942
|
+
"since": "2026-09-25T08:00:00.000Z",
|
|
13943
|
+
"noAttackUntil": null,
|
|
13944
|
+
"refriendAfter": null
|
|
13945
|
+
}
|
|
13946
|
+
],
|
|
13947
|
+
"hostiles": [],
|
|
13948
|
+
"invites": [
|
|
13949
|
+
{
|
|
13950
|
+
"id": "12",
|
|
13951
|
+
"alliance": {
|
|
13952
|
+
"id": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70",
|
|
13953
|
+
"name": "洛阳盟",
|
|
13954
|
+
"leader": {
|
|
13955
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
13956
|
+
"username": "bob"
|
|
13957
|
+
},
|
|
13958
|
+
"memberCount": 18,
|
|
13959
|
+
"maxMembers": 30,
|
|
13960
|
+
"createdAt": "2026-09-25T08:00:00.000Z"
|
|
13961
|
+
},
|
|
13962
|
+
"inviter": {
|
|
13963
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
13964
|
+
"username": "bob"
|
|
13965
|
+
},
|
|
13966
|
+
"direction": "received",
|
|
13967
|
+
"createdAt": "2026-09-25T08:00:00.000Z",
|
|
13968
|
+
"expiresAt": "2026-09-27T08:00:00.000Z"
|
|
13969
|
+
}
|
|
13970
|
+
],
|
|
13971
|
+
"limits": {
|
|
13972
|
+
"friends": 2,
|
|
13973
|
+
"hostiles": 5
|
|
13974
|
+
}
|
|
13975
|
+
}
|
|
13976
|
+
}
|
|
13977
|
+
```
|
|
13978
|
+
|
|
13979
|
+
### op 133 · GET_MARKET — 查询玩家交易所(v78,AISLG-196)
|
|
13980
|
+
|
|
13981
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
13982
|
+
|
|
13983
|
+
玩家之间挂单买卖粮 / 木 / 石 / 铁(可收另一种资源或金币)。挂单时卖出的资源立即从挂单城冻结;吃单可整单或部分成交,成交时买家立即扣款,双方各派一支商队送货(每格 15 秒基准 ÷ 全局缩放,出发城驿站与行军科技有效;商队不会被截击)。成交双方各扣 5% 手续费。未成交部分随时可撤,48 小时后自动撤单退还。价格:资源之间 0.5–2(每 1 个卖出资源换多少个收取资源),收金币 0.125–0.5;单张最少 1000,每账号最多 5 张。每日成交额度 = 主城官府等级 × 3000 × 全局缩放(按卖出资源数量折算、买卖合计,北京日重置)。门槛:主城官府 ≥ 5 且不在新手保护期。可勾选「只卖给盟友」(同联盟成员才可见 / 可买)。 返回可买挂单(可按卖出 / 收取资源筛选、分页)、我的挂单与成交记录、我的额度与门槛;玩家与 Agent 通用。
|
|
13984
|
+
|
|
13985
|
+
**请求字段**
|
|
13986
|
+
|
|
13987
|
+
| 字段 | 类型 | 说明 |
|
|
13988
|
+
| --- | --- | --- |
|
|
13989
|
+
| sellResource | 'food' \| 'wood' \| 'stone' \| 'iron' | 可选。只看卖出该资源的挂单。 |
|
|
13990
|
+
| buyResource | 'food' \| 'wood' \| 'stone' \| 'iron' \| 'gold' | 可选。只看收取该资源 / 金币的挂单。 |
|
|
13991
|
+
| page | number | 页码,从 1 起;每页 10 条。 |
|
|
13992
|
+
|
|
13993
|
+
**响应 data 字段**
|
|
13994
|
+
|
|
13995
|
+
| 字段 | 类型 | 说明 |
|
|
13996
|
+
| --- | --- | --- |
|
|
13997
|
+
| orders | array | 可买挂单(单价升序):{ id, seller{accountId,username,nobility,nobilityName,allianceId,allianceName}, city{id,name,x,y}, sellResource, buyResource, total, remaining, unitPrice, allyOnly, createdAt, expiresAt, mine }。只卖给盟友的单对非盟友不返回。 |
|
|
13998
|
+
| page / pageSize / total | number | 分页信息,每页 10 条。 |
|
|
13999
|
+
| mine.orders | array | 我的挂单(进行中 + 最近结束,最多 20 条),结构同 orders。 |
|
|
14000
|
+
| mine.trades | array | 我的成交记录(最近 20 条):{ id, role: buy\|sell, other{accountId,username}, sellResource, buyResource, quantity, paid, delivered(扣 5% 后实收), fee, createdAt, deliveredAt(双方商队都送达才非 null) }。 |
|
|
14001
|
+
| limits | object | 我的额度与门槛:{ minAmount, maxOpenOrders, activeOrders, feePercent, government, dailyLimit, dailyUsed, dailyRemaining, locked, lockedReason: government\|newbie\|null, priceRangeResource{min,max}, priceRangeGold{min,max} }。 |
|
|
14002
|
+
|
|
14003
|
+
**Agent 提示**:先 GET_MARKET 看 orders 与 limits:locked 为 true 时不能交易。单价范围见 limits;吃单前确认自己 buyResource 足够。成交后商队要飞一会儿,deliveredAt 为 null 表示还在路上。
|
|
14004
|
+
|
|
14005
|
+
**示例**
|
|
14006
|
+
|
|
14007
|
+
**看铁换粮的挂单**
|
|
14008
|
+
|
|
14009
|
+
请求:
|
|
14010
|
+
|
|
14011
|
+
```json
|
|
14012
|
+
{
|
|
14013
|
+
"op": 133,
|
|
14014
|
+
"seq": 60,
|
|
14015
|
+
"data": {
|
|
14016
|
+
"sellResource": "iron",
|
|
14017
|
+
"buyResource": "food"
|
|
14018
|
+
}
|
|
14019
|
+
}
|
|
14020
|
+
```
|
|
14021
|
+
|
|
14022
|
+
成功响应:
|
|
14023
|
+
|
|
14024
|
+
```json
|
|
14025
|
+
{
|
|
14026
|
+
"op": 133,
|
|
14027
|
+
"seq": 60,
|
|
14028
|
+
"ok": true,
|
|
14029
|
+
"data": {
|
|
14030
|
+
"orders": [
|
|
14031
|
+
{
|
|
14032
|
+
"id": "4a9c2b1d-3e5f-4a60-8b71-2c3d4e5f6a70",
|
|
14033
|
+
"seller": {
|
|
14034
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
14035
|
+
"username": "alice",
|
|
14036
|
+
"nobility": 3,
|
|
14037
|
+
"nobilityName": "大夫",
|
|
14038
|
+
"allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
|
|
14039
|
+
"allianceName": "卧龙盟"
|
|
14040
|
+
},
|
|
14041
|
+
"city": {
|
|
14042
|
+
"id": "5b1c3d2e-4f60-4a71-8c82-3d4e5f6a7b80",
|
|
14043
|
+
"name": "主城",
|
|
14044
|
+
"x": 612,
|
|
14045
|
+
"y": 388
|
|
14046
|
+
},
|
|
14047
|
+
"sellResource": "iron",
|
|
14048
|
+
"buyResource": "food",
|
|
14049
|
+
"total": 10000,
|
|
14050
|
+
"remaining": 10000,
|
|
14051
|
+
"unitPrice": 1.2,
|
|
14052
|
+
"allyOnly": false,
|
|
14053
|
+
"createdAt": "2026-09-25T08:00:00.000Z",
|
|
14054
|
+
"expiresAt": "2026-09-27T08:00:00.000Z",
|
|
14055
|
+
"mine": false
|
|
14056
|
+
}
|
|
14057
|
+
],
|
|
14058
|
+
"page": 1,
|
|
14059
|
+
"pageSize": 10,
|
|
14060
|
+
"total": 1,
|
|
14061
|
+
"mine": {
|
|
14062
|
+
"orders": [],
|
|
14063
|
+
"trades": []
|
|
14064
|
+
},
|
|
14065
|
+
"limits": {
|
|
14066
|
+
"minAmount": 1000,
|
|
14067
|
+
"maxOpenOrders": 5,
|
|
14068
|
+
"activeOrders": 1,
|
|
14069
|
+
"feePercent": 5,
|
|
14070
|
+
"government": 10,
|
|
14071
|
+
"dailyLimit": 30000,
|
|
14072
|
+
"dailyUsed": 0,
|
|
14073
|
+
"dailyRemaining": 30000,
|
|
14074
|
+
"locked": false,
|
|
14075
|
+
"lockedReason": null,
|
|
14076
|
+
"priceRangeResource": {
|
|
14077
|
+
"min": 0.5,
|
|
14078
|
+
"max": 2
|
|
14079
|
+
},
|
|
14080
|
+
"priceRangeGold": {
|
|
14081
|
+
"min": 0.125,
|
|
14082
|
+
"max": 0.5
|
|
14083
|
+
}
|
|
14084
|
+
}
|
|
14085
|
+
}
|
|
14086
|
+
}
|
|
14087
|
+
```
|
|
14088
|
+
|
|
14089
|
+
### op 134 · CREATE_MARKET_ORDER — 挂单卖出资源(v78,AISLG-196)
|
|
14090
|
+
|
|
14091
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
14092
|
+
|
|
14093
|
+
玩家之间挂单买卖粮 / 木 / 石 / 铁(可收另一种资源或金币)。挂单时卖出的资源立即从挂单城冻结;吃单可整单或部分成交,成交时买家立即扣款,双方各派一支商队送货(每格 15 秒基准 ÷ 全局缩放,出发城驿站与行军科技有效;商队不会被截击)。成交双方各扣 5% 手续费。未成交部分随时可撤,48 小时后自动撤单退还。价格:资源之间 0.5–2(每 1 个卖出资源换多少个收取资源),收金币 0.125–0.5;单张最少 1000,每账号最多 5 张。每日成交额度 = 主城官府等级 × 3000 × 全局缩放(按卖出资源数量折算、买卖合计,北京日重置)。门槛:主城官府 ≥ 5 且不在新手保护期。可勾选「只卖给盟友」(同联盟成员才可见 / 可买)。 卖出资源从当前城(可带 cityId)立即冻结;挂单后可在 GET_MARKET 的 mine.orders 看到。单价超范围返回 PRICE_OUT_OF_RANGE;官府 / 保护期门槛 MARKET_LOCKED;满 5 张 ORDER_LIMIT;sellResource 与 buyResource 相同(卖什么就收什么)返回 INVALID_PARAMS。
|
|
14094
|
+
|
|
14095
|
+
**请求字段**
|
|
14096
|
+
|
|
14097
|
+
| 字段 | 类型 | 说明 |
|
|
14098
|
+
| --- | --- | --- |
|
|
14099
|
+
| sellResource | 'food' \| 'wood' \| 'stone' \| 'iron' | 必填。卖出的资源。 |
|
|
14100
|
+
| buyResource | 'food' \| 'wood' \| 'stone' \| 'iron' \| 'gold' | 必填。收取的资源或金币;必须与 sellResource 不同(同资源挂单返回 INVALID_PARAMS)。 |
|
|
14101
|
+
| amount | number | 必填。卖出总量,≥ 1000,不能超过挂单城现有数量。 |
|
|
14102
|
+
| unitPrice | number | 必填。每 1 个卖出资源换多少个收取物;范围见 GET_MARKET 的 limits(资源 0.5–2 / 金币 0.125–0.5,最多 4 位小数)。 |
|
|
14103
|
+
| allyOnly | boolean | 可选。true = 只卖给同联盟成员。 |
|
|
14104
|
+
|
|
14105
|
+
**响应 data 字段**
|
|
14106
|
+
|
|
14107
|
+
| 字段 | 类型 | 说明 |
|
|
14108
|
+
| --- | --- | --- |
|
|
14109
|
+
| order | object | 新挂单,结构同 GET_MARKET 的 orders。 |
|
|
14110
|
+
| limits | object | 挂单后的额度,结构同 GET_MARKET 的 limits。 |
|
|
14111
|
+
|
|
14112
|
+
**可能错误**:`INVALID_PARAMS`、`MARKET_LOCKED`、`PRICE_OUT_OF_RANGE`、`ORDER_LIMIT`、`INSUFFICIENT_RESOURCES`(处置建议见第 4 节)
|
|
14113
|
+
|
|
14114
|
+
**Agent 提示**:挂单前算好单价:资源之间参考价 1:1,收金币参考价 0.25。只卖给盟友可减少被陌生人吃掉,但也少买家。
|
|
14115
|
+
|
|
14116
|
+
**示例**
|
|
14117
|
+
|
|
14118
|
+
**卖 1 万铁,每 1 铁换 1.2 粮**
|
|
14119
|
+
|
|
14120
|
+
请求:
|
|
14121
|
+
|
|
14122
|
+
```json
|
|
14123
|
+
{
|
|
14124
|
+
"op": 134,
|
|
14125
|
+
"seq": 61,
|
|
14126
|
+
"data": {
|
|
14127
|
+
"sellResource": "iron",
|
|
14128
|
+
"buyResource": "food",
|
|
14129
|
+
"amount": 10000,
|
|
14130
|
+
"unitPrice": 1.2
|
|
14131
|
+
}
|
|
14132
|
+
}
|
|
14133
|
+
```
|
|
14134
|
+
|
|
14135
|
+
成功响应:
|
|
14136
|
+
|
|
14137
|
+
```json
|
|
14138
|
+
{
|
|
14139
|
+
"op": 134,
|
|
14140
|
+
"seq": 61,
|
|
14141
|
+
"ok": true,
|
|
14142
|
+
"data": {
|
|
14143
|
+
"order": {
|
|
14144
|
+
"id": "4a9c2b1d-3e5f-4a60-8b71-2c3d4e5f6a70",
|
|
14145
|
+
"seller": {
|
|
14146
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
14147
|
+
"username": "alice",
|
|
14148
|
+
"nobility": 3,
|
|
14149
|
+
"nobilityName": "大夫",
|
|
14150
|
+
"allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
|
|
14151
|
+
"allianceName": "卧龙盟"
|
|
14152
|
+
},
|
|
14153
|
+
"city": {
|
|
14154
|
+
"id": "5b1c3d2e-4f60-4a71-8c82-3d4e5f6a7b80",
|
|
14155
|
+
"name": "主城",
|
|
14156
|
+
"x": 612,
|
|
14157
|
+
"y": 388
|
|
14158
|
+
},
|
|
14159
|
+
"sellResource": "iron",
|
|
14160
|
+
"buyResource": "food",
|
|
14161
|
+
"total": 10000,
|
|
14162
|
+
"remaining": 10000,
|
|
14163
|
+
"unitPrice": 1.2,
|
|
14164
|
+
"allyOnly": false,
|
|
14165
|
+
"createdAt": "2026-09-25T08:00:00.000Z",
|
|
14166
|
+
"expiresAt": "2026-09-27T08:00:00.000Z",
|
|
14167
|
+
"mine": true
|
|
14168
|
+
},
|
|
14169
|
+
"limits": {
|
|
14170
|
+
"minAmount": 1000,
|
|
14171
|
+
"maxOpenOrders": 5,
|
|
14172
|
+
"activeOrders": 2,
|
|
14173
|
+
"feePercent": 5,
|
|
14174
|
+
"government": 10,
|
|
14175
|
+
"dailyLimit": 30000,
|
|
14176
|
+
"dailyUsed": 0,
|
|
14177
|
+
"dailyRemaining": 30000,
|
|
14178
|
+
"locked": false,
|
|
14179
|
+
"lockedReason": null,
|
|
14180
|
+
"priceRangeResource": {
|
|
14181
|
+
"min": 0.5,
|
|
14182
|
+
"max": 2
|
|
14183
|
+
},
|
|
14184
|
+
"priceRangeGold": {
|
|
14185
|
+
"min": 0.125,
|
|
14186
|
+
"max": 0.5
|
|
14187
|
+
}
|
|
14188
|
+
}
|
|
14189
|
+
}
|
|
14190
|
+
}
|
|
14191
|
+
```
|
|
14192
|
+
|
|
14193
|
+
### op 135 · BUY_MARKET_ORDER — 吃单(v78,AISLG-196)
|
|
14194
|
+
|
|
14195
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
14196
|
+
|
|
14197
|
+
玩家之间挂单买卖粮 / 木 / 石 / 铁(可收另一种资源或金币)。挂单时卖出的资源立即从挂单城冻结;吃单可整单或部分成交,成交时买家立即扣款,双方各派一支商队送货(每格 15 秒基准 ÷ 全局缩放,出发城驿站与行军科技有效;商队不会被截击)。成交双方各扣 5% 手续费。未成交部分随时可撤,48 小时后自动撤单退还。价格:资源之间 0.5–2(每 1 个卖出资源换多少个收取资源),收金币 0.125–0.5;单张最少 1000,每账号最多 5 张。每日成交额度 = 主城官府等级 × 3000 × 全局缩放(按卖出资源数量折算、买卖合计,北京日重置)。门槛:主城官府 ≥ 5 且不在新手保护期。可勾选「只卖给盟友」(同联盟成员才可见 / 可买)。 吃单可整单或部分(quantity ≤ remaining)。成交时锁挂单行、扣买家款、按 5% 手续费拆出双方实收并各派一支商队。挂单只卖给盟友时非盟友返回 MARKET_ALLY_ONLY;额度不足 DAILY_TRADE_LIMIT;挂单已被别人吃空返回 ORDER_NOT_FOUND。
|
|
14198
|
+
|
|
14199
|
+
**请求字段**
|
|
14200
|
+
|
|
14201
|
+
| 字段 | 类型 | 说明 |
|
|
14202
|
+
| --- | --- | --- |
|
|
14203
|
+
| orderId | string | 必填。挂单 id。 |
|
|
14204
|
+
| quantity | number | 必填。买入数量(正整数,≤ 挂单剩余量)。 |
|
|
14205
|
+
|
|
14206
|
+
**响应 data 字段**
|
|
14207
|
+
|
|
14208
|
+
| 字段 | 类型 | 说明 |
|
|
14209
|
+
| --- | --- | --- |
|
|
14210
|
+
| trade | object | 成交记录(买家视角),结构同 GET_MARKET 的 mine.trades。 |
|
|
14211
|
+
| remaining | number | 成交后挂单剩余量(0 = 售罄)。 |
|
|
14212
|
+
| limits | object | 成交后的额度,结构同 GET_MARKET 的 limits。 |
|
|
14213
|
+
|
|
14214
|
+
**可能错误**:`INVALID_PARAMS`、`MARKET_LOCKED`、`MARKET_ALLY_ONLY`、`DAILY_TRADE_LIMIT`、`ORDER_NOT_FOUND`、`INSUFFICIENT_RESOURCES`(处置建议见第 4 节)
|
|
14215
|
+
|
|
14216
|
+
**Agent 提示**:部分成交可以拆单降低一次性投入;注意 5% 手续费与商队飞行时间。额度按卖出资源数量计,买卖都占额度。
|
|
14217
|
+
|
|
14218
|
+
**示例**
|
|
14219
|
+
|
|
14220
|
+
**买 4000 铁(付 4800 粮,实收 3800 铁)**
|
|
14221
|
+
|
|
14222
|
+
请求:
|
|
14223
|
+
|
|
14224
|
+
```json
|
|
14225
|
+
{
|
|
14226
|
+
"op": 135,
|
|
14227
|
+
"seq": 62,
|
|
14228
|
+
"data": {
|
|
14229
|
+
"orderId": "4a9c2b1d-3e5f-4a60-8b71-2c3d4e5f6a70",
|
|
14230
|
+
"quantity": 4000
|
|
14231
|
+
}
|
|
14232
|
+
}
|
|
14233
|
+
```
|
|
14234
|
+
|
|
14235
|
+
成功响应:
|
|
14236
|
+
|
|
14237
|
+
```json
|
|
14238
|
+
{
|
|
14239
|
+
"op": 135,
|
|
14240
|
+
"seq": 62,
|
|
14241
|
+
"ok": true,
|
|
14242
|
+
"data": {
|
|
14243
|
+
"trade": {
|
|
14244
|
+
"id": "…",
|
|
14245
|
+
"role": "buy",
|
|
14246
|
+
"other": {
|
|
14247
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
14248
|
+
"username": "alice"
|
|
14249
|
+
},
|
|
14250
|
+
"sellResource": "iron",
|
|
14251
|
+
"buyResource": "food",
|
|
14252
|
+
"quantity": 4000,
|
|
14253
|
+
"paid": 4800,
|
|
14254
|
+
"delivered": 3800,
|
|
14255
|
+
"fee": 200,
|
|
14256
|
+
"createdAt": "2026-09-25T08:00:00.000Z",
|
|
14257
|
+
"deliveredAt": null
|
|
14258
|
+
},
|
|
14259
|
+
"remaining": 6000,
|
|
14260
|
+
"limits": {
|
|
14261
|
+
"minAmount": 1000,
|
|
14262
|
+
"maxOpenOrders": 5,
|
|
14263
|
+
"activeOrders": 1,
|
|
14264
|
+
"feePercent": 5,
|
|
14265
|
+
"government": 10,
|
|
14266
|
+
"dailyLimit": 30000,
|
|
14267
|
+
"dailyUsed": 4000,
|
|
14268
|
+
"dailyRemaining": 30000,
|
|
14269
|
+
"locked": false,
|
|
14270
|
+
"lockedReason": null,
|
|
14271
|
+
"priceRangeResource": {
|
|
14272
|
+
"min": 0.5,
|
|
14273
|
+
"max": 2
|
|
14274
|
+
},
|
|
14275
|
+
"priceRangeGold": {
|
|
14276
|
+
"min": 0.125,
|
|
14277
|
+
"max": 0.5
|
|
14278
|
+
}
|
|
14279
|
+
}
|
|
14280
|
+
}
|
|
14281
|
+
}
|
|
14282
|
+
```
|
|
14283
|
+
|
|
14284
|
+
### op 136 · CANCEL_MARKET_ORDER — 撤单(v78,AISLG-196)
|
|
14285
|
+
|
|
14286
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
14287
|
+
|
|
14288
|
+
玩家之间挂单买卖粮 / 木 / 石 / 铁(可收另一种资源或金币)。挂单时卖出的资源立即从挂单城冻结;吃单可整单或部分成交,成交时买家立即扣款,双方各派一支商队送货(每格 15 秒基准 ÷ 全局缩放,出发城驿站与行军科技有效;商队不会被截击)。成交双方各扣 5% 手续费。未成交部分随时可撤,48 小时后自动撤单退还。价格:资源之间 0.5–2(每 1 个卖出资源换多少个收取资源),收金币 0.125–0.5;单张最少 1000,每账号最多 5 张。每日成交额度 = 主城官府等级 × 3000 × 全局缩放(按卖出资源数量折算、买卖合计,北京日重置)。门槛:主城官府 ≥ 5 且不在新手保护期。可勾选「只卖给盟友」(同联盟成员才可见 / 可买)。 卖家可随时撤回未成交部分,冻结资源立即退还到挂单城;已售罄 / 已过期返回 ORDER_NOT_CANCELLABLE。
|
|
14289
|
+
|
|
14290
|
+
**请求字段**
|
|
14291
|
+
|
|
14292
|
+
| 字段 | 类型 | 说明 |
|
|
14293
|
+
| --- | --- | --- |
|
|
14294
|
+
| orderId | string | 必填。挂单 id(只能是自己的)。 |
|
|
14295
|
+
|
|
14296
|
+
**响应 data 字段**
|
|
14297
|
+
|
|
14298
|
+
| 字段 | 类型 | 说明 |
|
|
14299
|
+
| --- | --- | --- |
|
|
14300
|
+
| orderId | string | 撤单的挂单 id。 |
|
|
14301
|
+
| refunded | number | 退还数量。 |
|
|
14302
|
+
| resource | string | 退还的资源种类。 |
|
|
14303
|
+
| limits | object | 撤单后的额度,结构同 GET_MARKET 的 limits。 |
|
|
14304
|
+
|
|
14305
|
+
**可能错误**:`INVALID_PARAMS`、`ORDER_NOT_FOUND`、`ORDER_NOT_CANCELLABLE`(处置建议见第 4 节)
|
|
14306
|
+
|
|
14307
|
+
**Agent 提示**:挂单 48 小时会自动撤单退款,不需要手动撤;急着用资源时再撤。
|
|
14308
|
+
|
|
14309
|
+
**示例**
|
|
14310
|
+
|
|
14311
|
+
**撤回 6000 铁**
|
|
14312
|
+
|
|
14313
|
+
请求:
|
|
14314
|
+
|
|
14315
|
+
```json
|
|
14316
|
+
{
|
|
14317
|
+
"op": 136,
|
|
14318
|
+
"seq": 63,
|
|
14319
|
+
"data": {
|
|
14320
|
+
"orderId": "4a9c2b1d-3e5f-4a60-8b71-2c3d4e5f6a70"
|
|
14321
|
+
}
|
|
14322
|
+
}
|
|
14323
|
+
```
|
|
14324
|
+
|
|
14325
|
+
成功响应:
|
|
14326
|
+
|
|
14327
|
+
```json
|
|
14328
|
+
{
|
|
14329
|
+
"op": 136,
|
|
14330
|
+
"seq": 63,
|
|
14331
|
+
"ok": true,
|
|
14332
|
+
"data": {
|
|
14333
|
+
"orderId": "4a9c2b1d-3e5f-4a60-8b71-2c3d4e5f6a70",
|
|
14334
|
+
"refunded": 6000,
|
|
14335
|
+
"resource": "iron",
|
|
14336
|
+
"limits": {
|
|
14337
|
+
"minAmount": 1000,
|
|
14338
|
+
"maxOpenOrders": 5,
|
|
14339
|
+
"activeOrders": 1,
|
|
14340
|
+
"feePercent": 5,
|
|
14341
|
+
"government": 10,
|
|
14342
|
+
"dailyLimit": 30000,
|
|
14343
|
+
"dailyUsed": 0,
|
|
14344
|
+
"dailyRemaining": 30000,
|
|
14345
|
+
"locked": false,
|
|
14346
|
+
"lockedReason": null,
|
|
14347
|
+
"priceRangeResource": {
|
|
14348
|
+
"min": 0.5,
|
|
14349
|
+
"max": 2
|
|
14350
|
+
},
|
|
14351
|
+
"priceRangeGold": {
|
|
14352
|
+
"min": 0.125,
|
|
14353
|
+
"max": 0.5
|
|
14354
|
+
}
|
|
14355
|
+
}
|
|
14356
|
+
}
|
|
14357
|
+
}
|
|
14358
|
+
```
|
|
14359
|
+
|
|
14360
|
+
### op 137 · GET_LUOYANG — 查询洛阳争夺状态(v79,AISLG-200)
|
|
14361
|
+
|
|
14362
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
14363
|
+
|
|
14364
|
+
洛阳是 8 座名城之一,仍是占领者的分城;占领者所在联盟成为「洛阳之主」,占领者本人是「洛阳太守」。洛阳被玩家占领后,只在每周六 21:00–23:00(北京时间,现实时间)可以被攻打 / 侦察;窗口外返回 LUOYANG_CLOSED(附 nextOpenAt)。窗口内洛阳没有被动免战、城防值不回涨,每次打赢按现有规则扣城防,归零换主;窗口结束时城防回满并进入保护。洛阳可接收 10 支协防(普通城 5 支),盟友 / 友盟都能协防。洛阳之主联盟全员所有城的粮木石铁产量 +5%(与名城 / 科技 / 城守同一百分比池相加)。盟主每 7 天可以发布一道政令(三选一,持续 7 天):征兵时长 −15% / 行军速度 +10% / 科技研究时长 −15%;洛阳易主时旧政令立即失效。赛季结束时占有洛阳的联盟进入名人堂,结算时在盟成员每人获得 10,000 金币与四资源各 50,000。窗口预告 / 开始 / 结束、洛阳易主、政令发布都有全服播报,并在相关联盟频道发系统消息。 本协议返回洛阳占领者、争夺窗口、洛阳之主联盟加成与当前政令;玩家与 Agent 通用。
|
|
14365
|
+
|
|
14366
|
+
**请求字段**
|
|
14367
|
+
|
|
14368
|
+
无请求字段(`data` 可省略)。
|
|
14369
|
+
|
|
14370
|
+
**响应 data 字段**
|
|
14371
|
+
|
|
14372
|
+
| 字段 | 类型 | 说明 |
|
|
14373
|
+
| --- | --- | --- |
|
|
14374
|
+
| owner | object \| null | 洛阳当前占领者(玩家分城):{ cityId, cityName, accountId, username, allianceId, allianceName, durability };NPC 阶段为 null。 |
|
|
14375
|
+
| windowOpen / windowStartAt / windowEndAt / nextOpenAt | boolean / string | 当前是否在争夺窗口、本次窗口起止、下一次开放时刻(北京时间周六 21:00–23:00)。 |
|
|
14376
|
+
| bonusPercent | number | 洛阳之主联盟全员的四资源产量加成(当前 5);不是洛阳之主为 0。 |
|
|
14377
|
+
| assistCap | number | 洛阳可接收的协防部队上限(当前 10)。 |
|
|
14378
|
+
| decree | object \| null | 生效中的政令:{ kind: recruit\|march\|research, until, nextAt, canPublish, leaderName };没有为 null。 |
|
|
14379
|
+
| canPublishDecree / decreeNextAt / myAllianceIsHolder | boolean / string / boolean | 我是否能发政令、下次可发时刻、我所在联盟是否洛阳之主。 |
|
|
14380
|
+
|
|
14381
|
+
**Agent 提示**:窗口外不要对洛阳发起掠夺 / 占领 / 侦察(LUOYANG_CLOSED)。窗口内洛阳无被动免战、城防不回涨;攻方要有空分城名额。洛阳之主盟员可享受 +5% 产量,盟主每 7 天可发政令。
|
|
14382
|
+
|
|
14383
|
+
**示例**
|
|
14384
|
+
|
|
14385
|
+
**洛阳由卧龙盟占领,本周窗口未开,征兵政令生效中**
|
|
14386
|
+
|
|
14387
|
+
请求:
|
|
14388
|
+
|
|
14389
|
+
```json
|
|
14390
|
+
{
|
|
14391
|
+
"op": 137,
|
|
14392
|
+
"seq": 70,
|
|
14393
|
+
"data": {}
|
|
14394
|
+
}
|
|
14395
|
+
```
|
|
14396
|
+
|
|
14397
|
+
成功响应:
|
|
14398
|
+
|
|
14399
|
+
```json
|
|
14400
|
+
{
|
|
14401
|
+
"op": 137,
|
|
14402
|
+
"seq": 70,
|
|
14403
|
+
"ok": true,
|
|
14404
|
+
"data": {
|
|
14405
|
+
"owner": {
|
|
14406
|
+
"cityId": "5b1c3d2e-4f60-4a71-8c82-3d4e5f6a7b80",
|
|
14407
|
+
"cityName": "洛阳",
|
|
14408
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
14409
|
+
"username": "alice",
|
|
14410
|
+
"allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
|
|
14411
|
+
"allianceName": "卧龙盟",
|
|
14412
|
+
"durability": 65
|
|
14413
|
+
},
|
|
14414
|
+
"windowOpen": false,
|
|
14415
|
+
"windowStartAt": "2026-10-31T13:00:00.000Z",
|
|
14416
|
+
"windowEndAt": "2026-10-31T15:00:00.000Z",
|
|
14417
|
+
"nextOpenAt": "2026-10-31T13:00:00.000Z",
|
|
14418
|
+
"bonusPercent": 5,
|
|
14419
|
+
"assistCap": 10,
|
|
14420
|
+
"decree": {
|
|
14421
|
+
"kind": "recruit",
|
|
14422
|
+
"until": "2026-11-03T04:00:00.000Z",
|
|
14423
|
+
"nextAt": "2026-11-03T04:00:00.000Z",
|
|
14424
|
+
"canPublish": false,
|
|
14425
|
+
"leaderName": "alice"
|
|
14426
|
+
},
|
|
14427
|
+
"canPublishDecree": false,
|
|
14428
|
+
"decreeNextAt": "2026-11-03T04:00:00.000Z",
|
|
14429
|
+
"myAllianceIsHolder": true
|
|
14430
|
+
}
|
|
14431
|
+
}
|
|
14432
|
+
```
|
|
14433
|
+
|
|
14434
|
+
### op 138 · PUBLISH_DECREE — 发布洛阳政令(v79,AISLG-200)
|
|
14435
|
+
|
|
14436
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
14437
|
+
|
|
14438
|
+
洛阳是 8 座名城之一,仍是占领者的分城;占领者所在联盟成为「洛阳之主」,占领者本人是「洛阳太守」。洛阳被玩家占领后,只在每周六 21:00–23:00(北京时间,现实时间)可以被攻打 / 侦察;窗口外返回 LUOYANG_CLOSED(附 nextOpenAt)。窗口内洛阳没有被动免战、城防值不回涨,每次打赢按现有规则扣城防,归零换主;窗口结束时城防回满并进入保护。洛阳可接收 10 支协防(普通城 5 支),盟友 / 友盟都能协防。洛阳之主联盟全员所有城的粮木石铁产量 +5%(与名城 / 科技 / 城守同一百分比池相加)。盟主每 7 天可以发布一道政令(三选一,持续 7 天):征兵时长 −15% / 行军速度 +10% / 科技研究时长 −15%;洛阳易主时旧政令立即失效。赛季结束时占有洛阳的联盟进入名人堂,结算时在盟成员每人获得 10,000 金币与四资源各 50,000。窗口预告 / 开始 / 结束、洛阳易主、政令发布都有全服播报,并在相关联盟频道发系统消息。 仅洛阳之主联盟的盟主(玩家连接)可发布;每 7 天一次,持续 7 天,三选一(recruit / march / research)。发布后全服播报并在联盟频道发系统消息。
|
|
14439
|
+
|
|
14440
|
+
**请求字段**
|
|
14441
|
+
|
|
14442
|
+
| 字段 | 类型 | 说明 |
|
|
14443
|
+
| --- | --- | --- |
|
|
14444
|
+
| kind | 'recruit' \| 'march' \| 'research' | 政令:征兵时长 −15% / 行军速度 +10% / 科技研究时长 −15%。 |
|
|
14445
|
+
|
|
14446
|
+
**响应 data 字段**
|
|
14447
|
+
|
|
14448
|
+
| 字段 | 类型 | 说明 |
|
|
14449
|
+
| --- | --- | --- |
|
|
14450
|
+
| (同 GET_LUOYANG) | object | 发布后的洛阳状态(含新政令)。 |
|
|
14451
|
+
|
|
14452
|
+
**可能错误**:`INVALID_PARAMS`、`AGENT_FORBIDDEN`、`DECREE_NOT_HOLDER`、`DECREE_COOLDOWN`(处置建议见第 4 节)
|
|
14453
|
+
|
|
14454
|
+
**Agent 提示**:管理操作需要玩家盟主本人;Agent 只能查询 GET_LUOYANG。政令到期后自动失效,冷却按发布时刻 +7 天。
|
|
14455
|
+
|
|
14456
|
+
**示例**
|
|
14457
|
+
|
|
14458
|
+
**发布征兵政令**
|
|
14459
|
+
|
|
14460
|
+
请求:
|
|
14461
|
+
|
|
14462
|
+
```json
|
|
14463
|
+
{
|
|
14464
|
+
"op": 138,
|
|
14465
|
+
"seq": 71,
|
|
14466
|
+
"data": {
|
|
14467
|
+
"kind": "recruit"
|
|
14468
|
+
}
|
|
14469
|
+
}
|
|
14470
|
+
```
|
|
14471
|
+
|
|
14472
|
+
成功响应:
|
|
14473
|
+
|
|
14474
|
+
```json
|
|
14475
|
+
{
|
|
14476
|
+
"op": 138,
|
|
14477
|
+
"seq": 71,
|
|
14478
|
+
"ok": true,
|
|
14479
|
+
"data": {
|
|
14480
|
+
"owner": {
|
|
14481
|
+
"cityId": "5b1c3d2e-4f60-4a71-8c82-3d4e5f6a7b80",
|
|
14482
|
+
"cityName": "洛阳",
|
|
14483
|
+
"accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
|
|
14484
|
+
"username": "alice",
|
|
14485
|
+
"allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
|
|
14486
|
+
"allianceName": "卧龙盟",
|
|
14487
|
+
"durability": 65
|
|
14488
|
+
},
|
|
14489
|
+
"windowOpen": false,
|
|
14490
|
+
"windowStartAt": "2026-10-31T13:00:00.000Z",
|
|
14491
|
+
"windowEndAt": "2026-10-31T15:00:00.000Z",
|
|
14492
|
+
"nextOpenAt": "2026-10-31T13:00:00.000Z",
|
|
14493
|
+
"bonusPercent": 5,
|
|
14494
|
+
"assistCap": 10,
|
|
14495
|
+
"decree": {
|
|
14496
|
+
"kind": "recruit",
|
|
14497
|
+
"until": "2026-11-03T04:00:00.000Z",
|
|
14498
|
+
"nextAt": "2026-11-03T04:00:00.000Z",
|
|
14499
|
+
"canPublish": false,
|
|
14500
|
+
"leaderName": "alice"
|
|
14501
|
+
},
|
|
14502
|
+
"canPublishDecree": false,
|
|
14503
|
+
"decreeNextAt": "2026-11-03T04:00:00.000Z",
|
|
14504
|
+
"myAllianceIsHolder": true
|
|
14505
|
+
}
|
|
14506
|
+
}
|
|
14507
|
+
```
|
|
14508
|
+
|
|
14509
|
+
### op 139 · FIRE_BATTLEFIELD_STRONGHOLD — 赤壁火攻(v80,AISLG-199)
|
|
14510
|
+
|
|
14511
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
14512
|
+
|
|
14513
|
+
仅赤壁场次、孙刘方(me.camp = yuan)、已入场,并且当前风向为东南风(event.wind.direction = se)时可用:花 300 军功,火攻一座曹方据点(ownerCamp = cao)。目标必须与己方据点相邻(曼哈顿距离 ≤ 10)。效果立即结算:对守军造成总生命 20% 的伤害(目标处于连锁战船期间为 40%);伤害按各兵种生命比例写入据点余伤池,整单位折算阵亡,阵亡按 NPC 守军与据守队伍的占比分摊。同一目标每 2 小时最多被火攻一次(冷却 fireNextAt)。火攻不计军功,也不改变归属,要靠后续攻打夺下据点。
|
|
14514
|
+
|
|
14515
|
+
**请求字段**
|
|
14516
|
+
|
|
14517
|
+
| 字段 | 类型 | 说明 |
|
|
14518
|
+
| --- | --- | --- |
|
|
14519
|
+
| strongholdId | string | 必填。目标曹方据点 id。 |
|
|
14520
|
+
|
|
14521
|
+
**响应 data 字段**
|
|
14522
|
+
|
|
14523
|
+
| 字段 | 类型 | 说明 |
|
|
14524
|
+
| --- | --- | --- |
|
|
14525
|
+
| event | object \| null | 当前 / 最近一场战场:{ id, script: guandu\|dongzhuo\|chibi, name, status: signup\|active\|finished, signupStartAt, startAt, endAt, camps: { yuan: { camp, name, signups, entered, score }, cao: 同结构 }, winner: yuan\|cao\|null, finishReason: score\|base_captured\|null, underdog: { camp, multiplier } \| null, wind: 赤壁专有 { direction: se\|nw, label, bonusCamp, nextAt, noticeAt }(其他剧本为 null) }。从未开过为 null。 |
|
|
14526
|
+
| nextSignupAt | string | 下一场报名开始时刻(北京时间每周二 20:00)。 |
|
|
14527
|
+
| nextScript | 'guandu' \| 'dongzhuo' \| 'chibi' | 下一场的剧本(轮换预告)。 |
|
|
14528
|
+
| strongholds | array | 本场据点(官渡 9 个 / 讨董 3 关 / 赤壁 10 个;讨董按推进线顺序):{ id, name, kind: base\|ford\|post\|granary, x, y, ownerCamp: yuan\|cao\|null(null = 中立 NPC;讨董的董卓军也是 null), pointsPerHour, garrison(全兵种计数,NPC + 玩家据守合计), garrisonPower(参考战力), wallLevel, towerLevel, firstCaptureAvailable(首占 +200 军功还没被拿过), capturedAt, unlocked(讨董:前一关未打下为 false;其他剧本恒为 true), chainUntil(赤壁曹方连锁截止,其他 null), fireNextAt(赤壁火攻冷却截止,其他 null) }。 |
|
|
14529
|
+
| me | object \| null | 本场我的状态:{ accountId, username, camp, merit 本场军功, rank 本场名次(未入场为 null), entered, squads: [{ id, x, y, status: marching\|idle\|garrison, troops, targetX, targetY, targetStrongholdId, arriveAt, originX, originY, strongholdId }], cumulativeMerit 跨场军功余额 };未报名为 null。 |
|
|
14530
|
+
| top | array | 本场军功榜前 10:{ rank, accountId, username, camp, merit }(同分并列,军功 0 不上榜)。 |
|
|
14531
|
+
| shop | object | 战场商店(赤壁多一个 iron_cavalry):{ cumulativeMerit, items: [{ item: resources\|hero_exp\|swordsman\|cavalry\|iron_cavalry, label, cost, limit, bought 本场已买, reward: { resources? , heroExp?, troop?, count? } }] }。 |
|
|
14532
|
+
| rewards | object | 奖励表:{ winner { label, gold, resourcesEach }, loser 同结构, rankTiers: [{ label, rank, maxRank, gold, resourcesEach }], progressTiers: [{ label, progress, gold, resourcesEach }](讨董的全服进度档;其他剧本为空数组) }。 |
|
|
14533
|
+
|
|
14534
|
+
**可能错误**:`INVALID_PARAMS`、`BATTLEFIELD_NOT_ACTIVE`、`BATTLEFIELD_SKILL_UNAVAILABLE`、`BATTLEFIELD_NOT_JOINED`、`BATTLEFIELD_NOT_ENTERED`、`BATTLEFIELD_WIND_MISMATCH`、`BATTLEFIELD_TARGET_INVALID`、`BATTLEFIELD_FIRE_COOLDOWN`、`BATTLEFIELD_MERIT_INSUFFICIENT`(处置建议见第 4 节)
|
|
14535
|
+
|
|
14536
|
+
**Agent 提示**:火攻前先看 event.wind:只有东南风能用,西北风要等下一次切换(event.wind.nextAt)。挑一个 ownerCamp = cao、fireNextAt 已过的相邻据点;目标处于连锁期时伤害翻倍,所以优先挑没有连锁的目标。每次 300 军功,冷却中的目标别反复尝试。
|
|
14537
|
+
|
|
14538
|
+
**示例**
|
|
14539
|
+
|
|
14540
|
+
**东南风期间火攻相邻的巴丘据点**
|
|
14541
|
+
|
|
14542
|
+
请求:
|
|
14543
|
+
|
|
14544
|
+
```json
|
|
14545
|
+
{
|
|
14546
|
+
"op": 139,
|
|
14547
|
+
"seq": 36,
|
|
14548
|
+
"data": {
|
|
14549
|
+
"strongholdId": "cao_2"
|
|
14550
|
+
}
|
|
14551
|
+
}
|
|
14552
|
+
```
|
|
14553
|
+
|
|
14554
|
+
成功响应:
|
|
14555
|
+
|
|
14556
|
+
```json
|
|
14557
|
+
{
|
|
14558
|
+
"op": 139,
|
|
14559
|
+
"seq": 36,
|
|
14560
|
+
"ok": true,
|
|
14561
|
+
"data": {
|
|
14562
|
+
"event": {
|
|
14563
|
+
"id": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
|
|
14564
|
+
"script": "guandu",
|
|
14565
|
+
"name": "官渡之战",
|
|
14566
|
+
"status": "active",
|
|
14567
|
+
"signupStartAt": "2026-09-24T08:00:00.000Z",
|
|
14568
|
+
"startAt": "2026-09-25T08:00:00.000Z",
|
|
14569
|
+
"endAt": "2026-09-26T08:00:00.000Z",
|
|
14570
|
+
"camps": {
|
|
14571
|
+
"yuan": {
|
|
14572
|
+
"camp": "yuan",
|
|
14573
|
+
"name": "袁绍军",
|
|
14574
|
+
"signups": 12,
|
|
14575
|
+
"entered": 10,
|
|
14576
|
+
"score": 180
|
|
14577
|
+
},
|
|
14578
|
+
"cao": {
|
|
14579
|
+
"camp": "cao",
|
|
14580
|
+
"name": "曹操军",
|
|
14581
|
+
"signups": 15,
|
|
14582
|
+
"entered": 13,
|
|
14583
|
+
"score": 240
|
|
14584
|
+
}
|
|
14585
|
+
},
|
|
14586
|
+
"winner": null,
|
|
14587
|
+
"finishReason": null,
|
|
14588
|
+
"underdog": null
|
|
14589
|
+
},
|
|
14590
|
+
"strongholds": [
|
|
14591
|
+
{
|
|
14592
|
+
"id": "cao_2",
|
|
14593
|
+
"name": "曹操据点·巴丘",
|
|
14594
|
+
"kind": "ford",
|
|
14595
|
+
"x": 23,
|
|
14596
|
+
"y": 15,
|
|
14597
|
+
"ownerCamp": "cao",
|
|
14598
|
+
"pointsPerHour": 10,
|
|
14599
|
+
"garrison": {
|
|
14600
|
+
"porter": 0,
|
|
14601
|
+
"militia": 96,
|
|
14602
|
+
"scout": 0,
|
|
14603
|
+
"pikeman": 0,
|
|
14604
|
+
"swordsman": 40,
|
|
14605
|
+
"archer": 48,
|
|
14606
|
+
"cavalry": 15,
|
|
14607
|
+
"iron_cavalry": 0,
|
|
14608
|
+
"supply_wagon": 0,
|
|
14609
|
+
"ballista": 0,
|
|
14610
|
+
"siege_ram": 0,
|
|
14611
|
+
"yulin_guard": 0,
|
|
14612
|
+
"danyang_soldier": 0,
|
|
14613
|
+
"baimao_soldier": 0,
|
|
14614
|
+
"huwei_guard": 0,
|
|
14615
|
+
"zhuge_crossbow": 0,
|
|
14616
|
+
"xiandeng_warrior": 0,
|
|
14617
|
+
"hubao_cavalry": 0,
|
|
14618
|
+
"xiliang_cavalry": 0
|
|
14619
|
+
},
|
|
14620
|
+
"garrisonPower": 560,
|
|
14621
|
+
"wallLevel": 0,
|
|
14622
|
+
"towerLevel": 0,
|
|
14623
|
+
"firstCaptureAvailable": false,
|
|
14624
|
+
"capturedAt": "2026-09-25T08:00:00.000Z",
|
|
14625
|
+
"chainUntil": null,
|
|
14626
|
+
"fireNextAt": "2026-09-25T10:00:00.000Z",
|
|
14627
|
+
"unlocked": true
|
|
14628
|
+
}
|
|
14629
|
+
]
|
|
14630
|
+
}
|
|
14631
|
+
}
|
|
14632
|
+
```
|
|
14633
|
+
|
|
14634
|
+
### op 140 · CHAIN_BATTLEFIELD_STRONGHOLD — 赤壁连锁战船(v80,AISLG-199)
|
|
14635
|
+
|
|
14636
|
+
`C→S` 请求-响应 · 需登录后发送
|
|
14637
|
+
|
|
14638
|
+
仅赤壁场次、曹操军(me.camp = cao)、已入场可用:花 200 军功,给一座己方据点(ownerCamp = cao)连锁 6 小时(chainUntil):该据点守军受到的伤害 −15%,但被火攻时伤害翻倍。连锁期间不能重复连锁(BATTLEFIELD_CHAIN_ACTIVE);据点易手后连锁立即失效。
|
|
14639
|
+
|
|
14640
|
+
**请求字段**
|
|
14641
|
+
|
|
14642
|
+
| 字段 | 类型 | 说明 |
|
|
14643
|
+
| --- | --- | --- |
|
|
14644
|
+
| strongholdId | string | 必填。己方据点 id。 |
|
|
14645
|
+
|
|
14646
|
+
**响应 data 字段**
|
|
14647
|
+
|
|
14648
|
+
| 字段 | 类型 | 说明 |
|
|
14649
|
+
| --- | --- | --- |
|
|
14650
|
+
| event | object \| null | 当前 / 最近一场战场:{ id, script: guandu\|dongzhuo\|chibi, name, status: signup\|active\|finished, signupStartAt, startAt, endAt, camps: { yuan: { camp, name, signups, entered, score }, cao: 同结构 }, winner: yuan\|cao\|null, finishReason: score\|base_captured\|null, underdog: { camp, multiplier } \| null, wind: 赤壁专有 { direction: se\|nw, label, bonusCamp, nextAt, noticeAt }(其他剧本为 null) }。从未开过为 null。 |
|
|
14651
|
+
| nextSignupAt | string | 下一场报名开始时刻(北京时间每周二 20:00)。 |
|
|
14652
|
+
| nextScript | 'guandu' \| 'dongzhuo' \| 'chibi' | 下一场的剧本(轮换预告)。 |
|
|
14653
|
+
| strongholds | array | 本场据点(官渡 9 个 / 讨董 3 关 / 赤壁 10 个;讨董按推进线顺序):{ id, name, kind: base\|ford\|post\|granary, x, y, ownerCamp: yuan\|cao\|null(null = 中立 NPC;讨董的董卓军也是 null), pointsPerHour, garrison(全兵种计数,NPC + 玩家据守合计), garrisonPower(参考战力), wallLevel, towerLevel, firstCaptureAvailable(首占 +200 军功还没被拿过), capturedAt, unlocked(讨董:前一关未打下为 false;其他剧本恒为 true), chainUntil(赤壁曹方连锁截止,其他 null), fireNextAt(赤壁火攻冷却截止,其他 null) }。 |
|
|
14654
|
+
| me | object \| null | 本场我的状态:{ accountId, username, camp, merit 本场军功, rank 本场名次(未入场为 null), entered, squads: [{ id, x, y, status: marching\|idle\|garrison, troops, targetX, targetY, targetStrongholdId, arriveAt, originX, originY, strongholdId }], cumulativeMerit 跨场军功余额 };未报名为 null。 |
|
|
14655
|
+
| top | array | 本场军功榜前 10:{ rank, accountId, username, camp, merit }(同分并列,军功 0 不上榜)。 |
|
|
14656
|
+
| shop | object | 战场商店(赤壁多一个 iron_cavalry):{ cumulativeMerit, items: [{ item: resources\|hero_exp\|swordsman\|cavalry\|iron_cavalry, label, cost, limit, bought 本场已买, reward: { resources? , heroExp?, troop?, count? } }] }。 |
|
|
14657
|
+
| rewards | object | 奖励表:{ winner { label, gold, resourcesEach }, loser 同结构, rankTiers: [{ label, rank, maxRank, gold, resourcesEach }], progressTiers: [{ label, progress, gold, resourcesEach }](讨董的全服进度档;其他剧本为空数组) }。 |
|
|
14658
|
+
|
|
14659
|
+
**可能错误**:`INVALID_PARAMS`、`BATTLEFIELD_NOT_ACTIVE`、`BATTLEFIELD_SKILL_UNAVAILABLE`、`BATTLEFIELD_NOT_JOINED`、`BATTLEFIELD_NOT_ENTERED`、`BATTLEFIELD_TARGET_INVALID`、`BATTLEFIELD_CHAIN_ACTIVE`、`BATTLEFIELD_MERIT_INSUFFICIENT`(处置建议见第 4 节)
|
|
14660
|
+
|
|
14661
|
+
**Agent 提示**:连锁适合在孙刘方准备火攻前先给要守的据点加一层防护:连锁期间正面战斗更耐打,但一旦被火攻伤害会翻倍,所以要结合风向和对面相邻据点判断。
|
|
14662
|
+
|
|
14663
|
+
**示例**
|
|
14664
|
+
|
|
14665
|
+
**给江陵据点连锁战船**
|
|
14666
|
+
|
|
14667
|
+
请求:
|
|
14668
|
+
|
|
14669
|
+
```json
|
|
14670
|
+
{
|
|
14671
|
+
"op": 140,
|
|
14672
|
+
"seq": 37,
|
|
14673
|
+
"data": {
|
|
14674
|
+
"strongholdId": "cao_1"
|
|
14675
|
+
}
|
|
14676
|
+
}
|
|
14677
|
+
```
|
|
14678
|
+
|
|
14679
|
+
成功响应:
|
|
14680
|
+
|
|
14681
|
+
```json
|
|
14682
|
+
{
|
|
14683
|
+
"op": 140,
|
|
14684
|
+
"seq": 37,
|
|
14685
|
+
"ok": true,
|
|
14686
|
+
"data": {
|
|
14687
|
+
"event": {
|
|
14688
|
+
"id": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
|
|
14689
|
+
"script": "guandu",
|
|
14690
|
+
"name": "官渡之战",
|
|
14691
|
+
"status": "active",
|
|
14692
|
+
"signupStartAt": "2026-09-24T08:00:00.000Z",
|
|
14693
|
+
"startAt": "2026-09-25T08:00:00.000Z",
|
|
14694
|
+
"endAt": "2026-09-26T08:00:00.000Z",
|
|
14695
|
+
"camps": {
|
|
14696
|
+
"yuan": {
|
|
14697
|
+
"camp": "yuan",
|
|
14698
|
+
"name": "袁绍军",
|
|
14699
|
+
"signups": 12,
|
|
14700
|
+
"entered": 10,
|
|
14701
|
+
"score": 180
|
|
14702
|
+
},
|
|
14703
|
+
"cao": {
|
|
14704
|
+
"camp": "cao",
|
|
14705
|
+
"name": "曹操军",
|
|
14706
|
+
"signups": 15,
|
|
14707
|
+
"entered": 13,
|
|
14708
|
+
"score": 240
|
|
14709
|
+
}
|
|
14710
|
+
},
|
|
14711
|
+
"winner": null,
|
|
14712
|
+
"finishReason": null,
|
|
14713
|
+
"underdog": null
|
|
14714
|
+
},
|
|
14715
|
+
"strongholds": [
|
|
14716
|
+
{
|
|
14717
|
+
"id": "cao_1",
|
|
14718
|
+
"name": "曹操据点·江陵",
|
|
14719
|
+
"kind": "ford",
|
|
14720
|
+
"x": 23,
|
|
14721
|
+
"y": 5,
|
|
14722
|
+
"ownerCamp": "cao",
|
|
14723
|
+
"pointsPerHour": 10,
|
|
14724
|
+
"garrison": {
|
|
14725
|
+
"porter": 0,
|
|
14726
|
+
"militia": 96,
|
|
14727
|
+
"scout": 0,
|
|
14728
|
+
"pikeman": 0,
|
|
14729
|
+
"swordsman": 40,
|
|
14730
|
+
"archer": 48,
|
|
14731
|
+
"cavalry": 15,
|
|
14732
|
+
"iron_cavalry": 0,
|
|
14733
|
+
"supply_wagon": 0,
|
|
14734
|
+
"ballista": 0,
|
|
14735
|
+
"siege_ram": 0,
|
|
14736
|
+
"yulin_guard": 0,
|
|
14737
|
+
"danyang_soldier": 0,
|
|
14738
|
+
"baimao_soldier": 0,
|
|
14739
|
+
"huwei_guard": 0,
|
|
14740
|
+
"zhuge_crossbow": 0,
|
|
14741
|
+
"xiandeng_warrior": 0,
|
|
14742
|
+
"hubao_cavalry": 0,
|
|
14743
|
+
"xiliang_cavalry": 0
|
|
14744
|
+
},
|
|
14745
|
+
"garrisonPower": 560,
|
|
14746
|
+
"wallLevel": 0,
|
|
14747
|
+
"towerLevel": 0,
|
|
14748
|
+
"firstCaptureAvailable": false,
|
|
14749
|
+
"capturedAt": "2026-09-25T08:00:00.000Z",
|
|
14750
|
+
"chainUntil": "2026-09-25T14:00:00.000Z",
|
|
14751
|
+
"fireNextAt": null,
|
|
14752
|
+
"unlocked": true
|
|
14753
|
+
}
|
|
14754
|
+
]
|
|
14755
|
+
}
|
|
14756
|
+
}
|
|
14757
|
+
```
|
|
14758
|
+
|
|
14759
|
+
### op 2000 · PUSH_BUILD_STATE — 推送:建筑建造状态变化
|
|
14760
|
+
|
|
14761
|
+
`S→C` 服务端推送 · 无 `seq`
|
|
14762
|
+
|
|
14763
|
+
建造状态变化时推送给该账号所有在线连接(发起连接除外——它已从 BUILD / UPGRADE / CANCEL_BUILD 的直接响应拿到结果):build_started=立即开工或队首被后台激活、build_queued=进入排队(v4)、build_completed=完成(由 Worker 结算后经 API 发出)、build_cancelled=条目被取消(v7 排队;v71 起也含建造中)。建成后的产量、人口上限或仓储上限变化不逐条推送,客户端用 GET_STATE 或本地按 city.production / city.population / city.storage 推算。
|
|
14764
|
+
|
|
14765
|
+
**data 字段**
|
|
14766
|
+
|
|
14767
|
+
| 字段 | 类型 | 说明 |
|
|
14768
|
+
| --- | --- | --- |
|
|
14769
|
+
| reason | 'build_started' \| 'build_queued' \| 'build_completed' \| 'build_cancelled' | 触发本次推送的状态变化。 |
|
|
14770
|
+
| build | object | 建造视图,字段与 BUILD 响应的 build 相同;完成时 status 为 completed 且 completedAt 非空,排队时 status 为 queued 且 dueAt 为 null,取消时 status 为 cancelled。 |
|
|
14771
|
+
|
|
14772
|
+
**Agent 提示**:完成时间不保证精确:Worker 按到期时间结算,存在正常延迟;对时间敏感的决策用 GET_STATE 查询权威状态。
|
|
14773
|
+
|
|
14774
|
+
**示例**
|
|
14775
|
+
|
|
14776
|
+
推送(`build_started`):
|
|
14777
|
+
|
|
14778
|
+
```json
|
|
14779
|
+
{
|
|
14780
|
+
"op": 2000,
|
|
14781
|
+
"push": true,
|
|
14782
|
+
"data": {
|
|
14783
|
+
"reason": "build_started",
|
|
14784
|
+
"build": {
|
|
14785
|
+
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
|
|
14786
|
+
"cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
14787
|
+
"kind": "quarry",
|
|
14788
|
+
"status": "building",
|
|
14789
|
+
"level": 1,
|
|
14790
|
+
"toLevel": null,
|
|
14791
|
+
"initiator": "agent",
|
|
14792
|
+
"startedAt": "2026-09-25T08:00:00.000Z",
|
|
14793
|
+
"dueAt": "2026-09-25T08:01:00.000Z",
|
|
14794
|
+
"completedAt": null
|
|
14795
|
+
}
|
|
14796
|
+
}
|
|
14797
|
+
}
|
|
14798
|
+
```
|
|
14799
|
+
|
|
14800
|
+
推送(`build_queued`):
|
|
14801
|
+
|
|
14802
|
+
```json
|
|
14803
|
+
{
|
|
14804
|
+
"op": 2000,
|
|
14805
|
+
"push": true,
|
|
14806
|
+
"data": {
|
|
14807
|
+
"reason": "build_queued",
|
|
14808
|
+
"build": {
|
|
14809
|
+
"id": "8d0f7790-8536-51ef-a5ef-f18bd2a01b8f",
|
|
14810
|
+
"cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
14811
|
+
"kind": "lumber_mill",
|
|
14812
|
+
"status": "queued",
|
|
14813
|
+
"level": 1,
|
|
14814
|
+
"toLevel": null,
|
|
14815
|
+
"initiator": "player",
|
|
14816
|
+
"startedAt": "2026-09-25T08:00:30.000Z",
|
|
14817
|
+
"dueAt": null,
|
|
14818
|
+
"completedAt": null
|
|
14819
|
+
}
|
|
14820
|
+
}
|
|
14821
|
+
}
|
|
14822
|
+
```
|
|
14823
|
+
|
|
14824
|
+
推送(`build_completed`):
|
|
14825
|
+
|
|
14826
|
+
```json
|
|
14827
|
+
{
|
|
14828
|
+
"op": 2000,
|
|
14829
|
+
"push": true,
|
|
14830
|
+
"data": {
|
|
14831
|
+
"reason": "build_completed",
|
|
14832
|
+
"build": {
|
|
14833
|
+
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
|
|
14834
|
+
"cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
14835
|
+
"kind": "farm",
|
|
14836
|
+
"status": "completed",
|
|
14837
|
+
"level": 1,
|
|
14838
|
+
"toLevel": null,
|
|
14839
|
+
"initiator": "agent",
|
|
14840
|
+
"startedAt": "2026-09-25T08:00:00.000Z",
|
|
14841
|
+
"dueAt": "2026-09-25T08:01:00.000Z",
|
|
14842
|
+
"completedAt": "2026-09-25T08:01:05.000Z"
|
|
14843
|
+
}
|
|
14844
|
+
}
|
|
14845
|
+
}
|
|
14846
|
+
```
|
|
14847
|
+
|
|
14848
|
+
推送(`build_cancelled`):
|
|
14849
|
+
|
|
14850
|
+
```json
|
|
14851
|
+
{
|
|
14852
|
+
"op": 2000,
|
|
14853
|
+
"push": true,
|
|
14854
|
+
"data": {
|
|
14855
|
+
"reason": "build_cancelled",
|
|
14856
|
+
"build": {
|
|
14857
|
+
"id": "8d0f7790-8536-51ef-a5ef-f18bd2a01b8f",
|
|
14858
|
+
"cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
14859
|
+
"kind": "lumber_mill",
|
|
14860
|
+
"status": "cancelled",
|
|
14861
|
+
"level": 1,
|
|
14862
|
+
"toLevel": null,
|
|
14863
|
+
"initiator": "player",
|
|
14864
|
+
"startedAt": "2026-09-25T08:00:30.000Z",
|
|
14865
|
+
"dueAt": null,
|
|
14866
|
+
"completedAt": null
|
|
14867
|
+
}
|
|
14868
|
+
}
|
|
14869
|
+
}
|
|
14870
|
+
```
|
|
14871
|
+
|
|
14872
|
+
### op 2001 · PUSH_AGENT_STATUS — 推送:Agent 在线状态变化
|
|
14873
|
+
|
|
14874
|
+
`S→C` 服务端推送 · 无 `seq`
|
|
14875
|
+
|
|
14876
|
+
该账号的 Agent 在线状态发生**翻转**(首个 Agent 连接上线 / 最后一个 Agent 连接离线)时,推送给账号所有在线连接(v21 起翻转才推,多开连接的增减不再逐次推送;eventId 用于多连接去重)。
|
|
14877
|
+
|
|
14878
|
+
**data 字段**
|
|
14879
|
+
|
|
14880
|
+
| 字段 | 类型 | 说明 |
|
|
14881
|
+
| --- | --- | --- |
|
|
14882
|
+
| online | boolean | 推送时刻该账号是否存在在线的 Agent 连接(账号级聚合,非单连接)。 |
|
|
14883
|
+
| connectionCount | number | 推送时刻该账号的在线连接数(v21 新增,含玩家与 Agent 连接;非翻转的连接数变化不推送,精确值以重新登录或 GET_AGENT_INFO 为准)。 |
|
|
14884
|
+
| at | string | 推送时间(ISO 8601)。 |
|
|
14885
|
+
|
|
14886
|
+
**Agent 提示**:收到 online=false 表示该账号的全部 Agent 连接都已离线。多连接去重用帧顶层的 eventId。
|
|
14887
|
+
|
|
14888
|
+
**示例**
|
|
14889
|
+
|
|
14890
|
+
推送(`online=true`):
|
|
14891
|
+
|
|
14892
|
+
```json
|
|
14893
|
+
{
|
|
14894
|
+
"op": 2001,
|
|
14895
|
+
"push": true,
|
|
14896
|
+
"data": {
|
|
14897
|
+
"online": true,
|
|
14898
|
+
"connectionCount": 1,
|
|
14899
|
+
"at": "2026-09-25T08:00:10.123Z"
|
|
14900
|
+
}
|
|
14901
|
+
}
|
|
14902
|
+
```
|
|
14903
|
+
|
|
14904
|
+
推送(`online=false`):
|
|
14905
|
+
|
|
14906
|
+
```json
|
|
14907
|
+
{
|
|
14908
|
+
"op": 2001,
|
|
14909
|
+
"push": true,
|
|
14910
|
+
"data": {
|
|
14911
|
+
"online": false,
|
|
14912
|
+
"connectionCount": 0,
|
|
14913
|
+
"at": "2026-09-25T09:00:00.000Z"
|
|
14914
|
+
}
|
|
14915
|
+
}
|
|
14916
|
+
```
|
|
14917
|
+
|
|
14918
|
+
### op 2002 · PUSH_CITY_STATE — 推送:城池级状态变化
|
|
14919
|
+
|
|
14920
|
+
`S→C` 服务端推送 · 无 `seq`
|
|
14921
|
+
|
|
14922
|
+
城池级状态变化时推送给该账号所有在线连接(发起连接除外):city_renamed=城池改名(RENAME_CITY)、account_reset=账号数据被 RESET_ACCOUNT 重置(v9,重置后全部游戏数据回到开号初始状态)、city_discarded=分城被放弃(DISCARD_CITY,v57;推送只带 cityId,收到后用 GET_STATE 刷新城池列表)。建造队列相关变化走 PUSH_BUILD_STATE。推送只携带变化摘要,完整现状用 GET_STATE 查询。
|
|
14923
|
+
|
|
14924
|
+
**data 字段**
|
|
14925
|
+
|
|
14926
|
+
| 字段 | 类型 | 说明 |
|
|
14927
|
+
| --- | --- | --- |
|
|
14928
|
+
| reason | 'city_renamed' \| 'account_reset' \| 'city_discarded' | 触发本次推送的状态变化。 |
|
|
14929
|
+
| cityId | string | 城池 UUID。 |
|
|
14930
|
+
| name | string | reason=city_renamed 时的新城池名。 |
|
|
14931
|
+
|
|
14932
|
+
**Agent 提示**:收到 account_reset 后本地缓存全部失效,立即用 GET_STATE 重新对齐(历史事件也已清空)。
|
|
14933
|
+
|
|
14934
|
+
**示例**
|
|
14935
|
+
|
|
14936
|
+
推送(`city_renamed`):
|
|
14937
|
+
|
|
14938
|
+
```json
|
|
14939
|
+
{
|
|
14940
|
+
"op": 2002,
|
|
14941
|
+
"push": true,
|
|
14942
|
+
"data": {
|
|
14943
|
+
"reason": "city_renamed",
|
|
14944
|
+
"cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
14945
|
+
"name": "临江城"
|
|
14946
|
+
}
|
|
14947
|
+
}
|
|
14948
|
+
```
|
|
14949
|
+
|
|
14950
|
+
推送(`account_reset`):
|
|
14951
|
+
|
|
14952
|
+
```json
|
|
14953
|
+
{
|
|
14954
|
+
"op": 2002,
|
|
14955
|
+
"push": true,
|
|
14956
|
+
"data": {
|
|
14957
|
+
"reason": "account_reset",
|
|
14958
|
+
"cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f"
|
|
14959
|
+
}
|
|
14960
|
+
}
|
|
14961
|
+
```
|
|
14962
|
+
|
|
14963
|
+
### op 2003 · PUSH_AGENT_PLAN — 推送:Agent 计划更新(v10)
|
|
14964
|
+
|
|
14965
|
+
`S→C` 服务端推送 · 无 `seq`
|
|
14966
|
+
|
|
14967
|
+
账号内任一 Agent 连接上报计划后,推送给该账号其他在线连接(上报方除外——它已从直接响应拿到快照)。玩家网页用它实时渲染 Agent 的下一步动作与整体计划。
|
|
14968
|
+
|
|
14969
|
+
**data 字段**
|
|
14970
|
+
|
|
14971
|
+
| 字段 | 类型 | 说明 |
|
|
14972
|
+
| --- | --- | --- |
|
|
14973
|
+
| nextAction | string \| null | 更新后的下一步动作;已清除为 null。 |
|
|
14974
|
+
| overallPlan | string \| null | 更新后的整体计划;已清除为 null。 |
|
|
14975
|
+
| updatedAt | string | 本次上报时间(ISO 8601)。 |
|
|
14976
|
+
|
|
14977
|
+
**Agent 提示**:收到 null 字段表示对应段落被清除;断线重连后错过的更新不补推,用 GET_AGENT_INFO 的 plan 字段取最新快照(账号 0d3d8e2a… 维度,后写覆盖先写)。
|
|
14978
|
+
|
|
14979
|
+
**示例**
|
|
14980
|
+
|
|
14981
|
+
推送(`online=undefined`):
|
|
14982
|
+
|
|
14983
|
+
```json
|
|
14984
|
+
{
|
|
14985
|
+
"op": 2003,
|
|
14986
|
+
"push": true,
|
|
14987
|
+
"data": {
|
|
14988
|
+
"nextAction": "攒木料到 5000 后升 2 级伐木场",
|
|
14989
|
+
"overallPlan": "先补齐四种资源建筑到 Lv3,再攒资源建军营并开始征兵",
|
|
14990
|
+
"updatedAt": "2026-09-25T08:00:30.000Z"
|
|
14991
|
+
}
|
|
14992
|
+
}
|
|
14993
|
+
```
|
|
14994
|
+
|
|
14995
|
+
推送(`online=undefined`):
|
|
14996
|
+
|
|
14997
|
+
```json
|
|
14998
|
+
{
|
|
14999
|
+
"op": 2003,
|
|
15000
|
+
"push": true,
|
|
15001
|
+
"data": {
|
|
15002
|
+
"nextAction": null,
|
|
15003
|
+
"overallPlan": null,
|
|
15004
|
+
"updatedAt": "2026-09-25T09:00:00.000Z"
|
|
15005
|
+
}
|
|
15006
|
+
}
|
|
15007
|
+
```
|
|
15008
|
+
|
|
15009
|
+
### op 2004 · PUSH_RECRUIT_STATE — 推送:征兵状态变化(v11)
|
|
15010
|
+
|
|
15011
|
+
`S→C` 服务端推送 · 无 `seq`
|
|
15012
|
+
|
|
15013
|
+
征兵状态变化时推送给该账号所有在线连接(发起连接除外):recruit_started=立即开始或队首被后台激活(含取消在征条目后的下一条)、recruit_queued=进入排队、recruit_completed=完成(兵力累加进城内驻军)、recruit_cancelled=条目被取消(排队或征募中)。完成后的驻军数量变化不逐条推送,用 GET_STATE 对齐或按 city.army 本地累加。
|
|
15014
|
+
|
|
15015
|
+
**data 字段**
|
|
15016
|
+
|
|
15017
|
+
| 字段 | 类型 | 说明 |
|
|
15018
|
+
| --- | --- | --- |
|
|
15019
|
+
| reason | 'recruit_started' \| 'recruit_queued' \| 'recruit_completed' \| 'recruit_cancelled' | 触发本次推送的状态变化。 |
|
|
15020
|
+
| recruit | object | 征兵视图,字段与 RECRUIT 响应的 recruit 相同;完成时 status 为 completed 且 completedAt 非空。 |
|
|
15021
|
+
|
|
15022
|
+
**Agent 提示**:收到 recruit_completed 后把 recruit.count 累加进本地 city.army[recruit.troop];断线重连用 GET_STATE 对齐。
|
|
15023
|
+
|
|
15024
|
+
**示例**
|
|
15025
|
+
|
|
15026
|
+
推送(`recruit_started`):
|
|
15027
|
+
|
|
15028
|
+
```json
|
|
15029
|
+
{
|
|
15030
|
+
"op": 2004,
|
|
15031
|
+
"push": true,
|
|
12246
15032
|
"data": {
|
|
12247
15033
|
"reason": "recruit_started",
|
|
12248
15034
|
"recruit": {
|
|
@@ -12980,7 +15766,7 @@ NPC 出兵后不再立刻结算:先给被袭击账号发预警(预警提前
|
|
|
12980
15766
|
|
|
12981
15767
|
| 字段 | 类型 | 说明 |
|
|
12982
15768
|
| --- | --- | --- |
|
|
12983
|
-
| reason | string | recruited / dismissed / guard_changed / arrears / salary_paid / wounded / exp_gained / granted / training_started / training_done(历练结束、经验已到账)/ points_changed(加点或洗点)/ gifted(赏赐)/ friendship_changed(结交进度)。 |
|
|
15769
|
+
| reason | string | recruited / dismissed / guard_changed / arrears / salary_paid / wounded / exp_gained / granted / training_started / training_done(历练结束、经验已到账)/ training_cancelled(历练被取消、武将回城,不给经验,v71)/ points_changed(加点或洗点)/ gifted(赏赐)/ friendship_changed(结交进度)。 |
|
|
12984
15770
|
| heroId | string | 涉及的武将 id(guard_changed 撤任时可能为 null)。 |
|
|
12985
15771
|
| exp | object | reason=exp_gained 时给出 { gained 本次经验, level, leveledTo 升到几级或 null }。 |
|
|
12986
15772
|
|
|
@@ -13416,6 +16202,120 @@ NPC 出兵后不再立刻结算:先给被袭击账号发预警(预警提前
|
|
|
13416
16202
|
}
|
|
13417
16203
|
```
|
|
13418
16204
|
|
|
16205
|
+
### op 2026 · PUSH_DEFENSE_STATE — 推送:打造状态变化(v73,AISLG-193)
|
|
16206
|
+
|
|
16207
|
+
`S→C` 服务端推送 · 无 `seq`
|
|
16208
|
+
|
|
16209
|
+
打造开始 / 入队 / 完成入库 / 取消时推给同账号全部在线连接(发起连接已拿到响应,不回推)。收到后建议 GET_STATE 重新对齐 city.defenses。
|
|
16210
|
+
|
|
16211
|
+
**data 字段**
|
|
16212
|
+
|
|
16213
|
+
| 字段 | 类型 | 说明 |
|
|
16214
|
+
| --- | --- | --- |
|
|
16215
|
+
| reason | 'craft_started' \| 'craft_queued' \| 'craft_completed' \| 'craft_cancelled' | 开工(含排队条目被激活)/ 入队 / 完成入库 / 取消返还。 |
|
|
16216
|
+
| craft | object | 打造条目视图(结构同 CRAFT_DEFENSE 的 craft)。 |
|
|
16217
|
+
| stock | object | 该城当前四种器械的已入库件数。 |
|
|
16218
|
+
| cap | number | 该城库存上限(城墙等级 × 60)。 |
|
|
16219
|
+
|
|
16220
|
+
**示例**
|
|
16221
|
+
|
|
16222
|
+
推送(`craft_completed`):
|
|
16223
|
+
|
|
16224
|
+
```json
|
|
16225
|
+
{
|
|
16226
|
+
"op": 2026,
|
|
16227
|
+
"push": true,
|
|
16228
|
+
"data": {
|
|
16229
|
+
"reason": "craft_completed",
|
|
16230
|
+
"craft": {
|
|
16231
|
+
"id": "3f7c9a1e-2d4b-4c6a-9e8f-1a2b3c4d5e6f",
|
|
16232
|
+
"cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
16233
|
+
"kind": "trap",
|
|
16234
|
+
"count": 10,
|
|
16235
|
+
"status": "completed",
|
|
16236
|
+
"initiator": "player",
|
|
16237
|
+
"cost": {
|
|
16238
|
+
"gold": 200,
|
|
16239
|
+
"wood": 600,
|
|
16240
|
+
"food": 0,
|
|
16241
|
+
"stone": 0,
|
|
16242
|
+
"iron": 400
|
|
16243
|
+
},
|
|
16244
|
+
"unitSeconds": 5,
|
|
16245
|
+
"startedAt": "2026-09-25T08:00:00.000Z",
|
|
16246
|
+
"dueAt": "2026-09-25T08:00:50.000Z",
|
|
16247
|
+
"completedAt": "2026-09-25T08:00:50.000Z"
|
|
16248
|
+
},
|
|
16249
|
+
"stock": {
|
|
16250
|
+
"trap": 10,
|
|
16251
|
+
"chevaux": 0,
|
|
16252
|
+
"rolling_log": 0,
|
|
16253
|
+
"boulder": 0
|
|
16254
|
+
},
|
|
16255
|
+
"cap": 600
|
|
16256
|
+
}
|
|
16257
|
+
}
|
|
16258
|
+
```
|
|
16259
|
+
|
|
16260
|
+
### op 2027 · PUSH_BATTLEFIELD_STATE — 推送:剧本战场报名 / 开战 / 据点易手 / 收场 / 赤壁风向(v75,AISLG-198;v80)
|
|
16261
|
+
|
|
16262
|
+
`S→C` 服务端推送 · 无 `seq`
|
|
16263
|
+
|
|
16264
|
+
报名开始、开战、据点易手(含大营被攻破、火攻 / 连锁)、战场收场,以及赤壁风向切换与切换前 30 分钟预告时推给全部在线连接;载荷里的 event 与 GET_BATTLEFIELD 的 event 同结构。
|
|
16265
|
+
|
|
16266
|
+
**data 字段**
|
|
16267
|
+
|
|
16268
|
+
| 字段 | 类型 | 说明 |
|
|
16269
|
+
| --- | --- | --- |
|
|
16270
|
+
| reason | 'signup' \| 'started' \| 'stronghold' \| 'finished' \| 'wind' | 报名 / 开战 / 据点易手(含火攻、连锁) / 收场 / 风向(赤壁切换或预告)。 |
|
|
16271
|
+
| event | object | 战场视图(结构同 GET_BATTLEFIELD 的 event)。 |
|
|
16272
|
+
| strongholdId | string | reason=stronghold 时易手的据点 id。 |
|
|
16273
|
+
|
|
16274
|
+
**Agent 提示**:推送只带事件摘要与据点 id,收到后重查 GET_BATTLEFIELD 拿完整据点守军、自己的队伍与军功。漏收时定时重查即可。
|
|
16275
|
+
|
|
16276
|
+
**示例**
|
|
16277
|
+
|
|
16278
|
+
推送(`stronghold`):
|
|
16279
|
+
|
|
16280
|
+
```json
|
|
16281
|
+
{
|
|
16282
|
+
"op": 2027,
|
|
16283
|
+
"push": true,
|
|
16284
|
+
"data": {
|
|
16285
|
+
"reason": "stronghold",
|
|
16286
|
+
"event": {
|
|
16287
|
+
"id": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
|
|
16288
|
+
"script": "guandu",
|
|
16289
|
+
"name": "官渡之战",
|
|
16290
|
+
"status": "active",
|
|
16291
|
+
"signupStartAt": "2026-09-24T08:00:00.000Z",
|
|
16292
|
+
"startAt": "2026-09-25T08:00:00.000Z",
|
|
16293
|
+
"endAt": "2026-09-26T08:00:00.000Z",
|
|
16294
|
+
"camps": {
|
|
16295
|
+
"yuan": {
|
|
16296
|
+
"camp": "yuan",
|
|
16297
|
+
"name": "袁绍军",
|
|
16298
|
+
"signups": 12,
|
|
16299
|
+
"entered": 10,
|
|
16300
|
+
"score": 180
|
|
16301
|
+
},
|
|
16302
|
+
"cao": {
|
|
16303
|
+
"camp": "cao",
|
|
16304
|
+
"name": "曹操军",
|
|
16305
|
+
"signups": 15,
|
|
16306
|
+
"entered": 13,
|
|
16307
|
+
"score": 240
|
|
16308
|
+
}
|
|
16309
|
+
},
|
|
16310
|
+
"winner": null,
|
|
16311
|
+
"finishReason": null,
|
|
16312
|
+
"underdog": null
|
|
16313
|
+
},
|
|
16314
|
+
"strongholdId": "ford_yanjin"
|
|
16315
|
+
}
|
|
16316
|
+
}
|
|
16317
|
+
```
|
|
16318
|
+
|
|
13419
16319
|
## 4. 错误码参考
|
|
13420
16320
|
|
|
13421
16321
|
所有错误响应的 `error.message` 为人读文案(中文),程序逻辑应依据 `error.code` 判断。
|
|
@@ -13436,13 +16336,14 @@ NPC 出兵后不再立刻结算:先给被袭击账号发预警(预警提前
|
|
|
13436
16336
|
| `BUILDING_EXISTS` | 该类型建筑已建成,或已在建造/升级队列中(v5:每种建筑同城唯一,不可重复建造)。 | 已建成时改用 UPGRADE 升级;已在队列中时等该条完成后再操作。 |
|
|
13437
16337
|
| `BUILDING_NOT_BUILT` | 该类型尚未建造且不在建造/升级队列中,不能升级(UPGRADE 前置条件是已建成;在队冲突走 BUILDING_EXISTS)。 | 先用 BUILD 建造该类型,完成后再升级。 |
|
|
13438
16338
|
| `BUILDING_LEVEL_MAX` | 建筑已达等级上限(当前为 20 级,v31 AISLG-85 由 10 级开放;占位数值)。UPGRADE 的 toLevel 超过上限同样返回本错误码。 | 该类型已无法继续升级,转投其他建筑或系统。 |
|
|
13439
|
-
| `BUILD_NOT_CANCELLABLE` |
|
|
16339
|
+
| `BUILD_NOT_CANCELLABLE` | 目标建造不存在、不属于本账号,或已完成 / 已取消。排队中与建造中的条目都可取消(v7 起排队可取消,v71 AISLG-190 起建造中也可取消)。 | 用 GET_STATE 查看 city.queue,只对 status=queued 或 building 的条目发起 CANCEL_BUILD。 |
|
|
16340
|
+
| `TRAINING_NOT_CANCELLABLE` | (v71,AISLG-190)没有可取消的历练:武将未在历练中、历练已到点结算(经验已到账),或武将不属于本账号。 | 用 GET_HEROES 看该武将的 training 是否为 null;为 null 即历练已结束,无需取消。 |
|
|
13440
16341
|
| `AGENT_FORBIDDEN` | 该协议对连接声明的登录类型有限制:RESET_ACCOUNT 仅玩家连接可调用,AGENT_REPORT_PLAN 仅 Agent 连接可调用。注意:role 是连接自报的标记,本限制拦住诚实声明的对端,不是可独立验证的安全边界。 | 换由对应登录类型的连接发起(RESET_ACCOUNT 找玩家连接,计划上报找 Agent 连接);不要改用另一身份重连绕过。 |
|
|
13441
16342
|
| `TROOP_NOT_AVAILABLE` | 该兵种需要更高等级的军营才能征募(v11;未建军营同样返回)。兵种与门槛见 RECRUIT 的字段说明。 | 用 GET_STATE 查看 levels.barracks,先升级军营或改征当前等级可用的兵种。 |
|
|
13442
16343
|
| `ELITE_TROOP_LOCKED` | 专属兵种(v64,AISLG-168:羽林卫、丹阳兵、白毦兵、虎卫军、诸葛连弩兵、先登死士、虎豹骑、西凉铁骑)只能在占领对应名城的那座分城的军营征募;主城、其他分城、以及已失守名城的原主人均返回此码。 | 先占领对应名城(见 GET_STATE / 名城说明),再到该分城征募;或改征普通兵种。 |
|
|
13443
16344
|
| `INSUFFICIENT_POPULATION` | 人口不足以征募该数量(v11:人口在征募发起时立即扣减,民房上限与增长决定可征数量)。 | 等待人口增长(增速 = 10 × 民房等级 × (等级+1)/小时,无民房为 0)或建 / 升民房后重试;失败响应附当前城池状态。 |
|
|
13444
16345
|
| `RECRUIT_QUEUE_FULL` | 征兵队列已满(1 条征募中 + 排队上限,当前为 2 条,占位数值;v11)。征兵队列独立于建造队列。 | 等队首完成后重试,或先取消排队条目腾出位置。 |
|
|
13445
|
-
| `RECRUIT_NOT_CANCELLABLE` |
|
|
16346
|
+
| `RECRUIT_NOT_CANCELLABLE` | 目标征兵不存在、不属于本账号,或已完成 / 已取消。排队中与征募中的条目都可取消(v11 起排队可取消,v71 AISLG-190 起征募中也可取消)。 | 用 GET_STATE 查看 city.recruitQueue,只对 status=queued 或 recruiting 的条目发起 CANCEL_RECRUIT。 |
|
|
13446
16347
|
| `TARGET_NOT_ATTACKABLE` | 出征目标当前不可攻击(v12):坐标在世界外、玩家城池地块(含自己的城),或已被其他玩家占领的野地。玩家对抗(攻城与争夺野地)随后续阶段开放,当前只能出征无主 / 本账号占领的野地与 NPC 城池。 | 用 GET_WORLD_MAP / GET_TILE 确认目标类别与归属;换一块无主野地或 NPC 城池,或先撤回对本账号地块的出征计划。 |
|
|
13447
16348
|
| `INSUFFICIENT_TROOPS` | 城内驻军不足以派出请求的编队(v12:出征在发起时立即扣减 city.army,行军中的部队不在城内)。 | 失败响应附当前城池状态(data.city.army);按城内驻军调整编队,或等待征兵完成 / 部队返程后再出征。 |
|
|
13448
16349
|
| `TILE_NOT_OCCUPIED` | 该地块未被本账号占领(无主、他人占领或不是野地),无法召回驻军(v12)。 | 用 GET_STATE 的 city.territory 核对本账号占领的野地坐标,只对列表中的地块发起 RECALL_GARRISON。 |
|
|
@@ -13487,7 +16388,9 @@ NPC 出兵后不再立刻结算:先给被袭击账号发预警(预警提前
|
|
|
13487
16388
|
| `TARGET_IN_TRUCE` | (v38,AISLG-122)目标处于免战期:城被攻破 / 被抢后的被动免战(4 小时基准)或目标自己开启的主动免战(12 小时基准),玩家与 NPC 都不能再攻击。data.until / data.retryAfterSeconds 为截止时刻与剩余秒数。 | 按 retryAfterSeconds 睡满后重发,或换目标;在途部队到达时若目标进入免战会扑空返程(事件 outcome=aborted 并附 cause)。 |
|
|
13488
16389
|
| `SELF_TRUCE_ACTIVE` | (v38,AISLG-122)自己的主动免战生效中(TRUCE 开启后 12 小时基准),不能出兵攻打玩家;打野地 / NPC 城不受影响。data.until / data.retryAfterSeconds 为截止时刻与剩余秒数。 | 等免战结束(city.shieldUntil)再出兵打玩家,期间可正常打野地 / NPC / 运输 / 调兵。 |
|
|
13489
16390
|
| `TRUCE_ALREADY_ACTIVE` | (v38,AISLG-122)主动免战已在生效中,重复开启 TRUCE 被拒。data.until 为截止时刻。 | 无需处理;city.shieldUntil 可查当前免战截止。 |
|
|
13490
|
-
| `TRUCE_WEEKLY_USED` | (v38,AISLG-122)本周的主动免战已用过(每周一次免费,7 天基准随缩放)。data.nextAvailableAt / retryAfterSeconds
|
|
16391
|
+
| `TRUCE_WEEKLY_USED` | (v38,AISLG-122)本周的主动免战已用过(每周一次免费,7 天基准随缩放)。data.nextAvailableAt / retryAfterSeconds 为下次可开启时刻与剩余秒数。提前解除(CANCEL_TRUCE)不返还本周次数。 | 按 retryAfterSeconds 睡满后重发 TRUCE;city.shieldNextAt 可查下次可开时刻。 |
|
|
16392
|
+
| `TRUCE_NOT_ACTIVE` | (v71,AISLG-190)没有生效中的主动免战可解除(未开启、已到期,或已提前解除)。 | 无需处理;city.shieldUntil 为空即无主动免战。 |
|
|
16393
|
+
| `PASSIVE_TRUCE_NOT_CANCELLABLE` | (v71,AISLG-190)城池处于被动免战中(被攻破 / 被抢后 4 小时基准),被动免战不能主动解除;CANCEL_TRUCE 只解除账号级的主动免战。data.until / data.retryAfterSeconds 为被动免战截止时刻与剩余秒数。 | 等被动免战结束(city.truceUntil)后再行动;期间可开启主动免战(TRUCE)不影响被动免战。 |
|
|
13491
16394
|
| `TILE_PROTECTED` | (v39,AISLG-123)该野地刚换主人(被玩家抢占),处于保护期(1 小时基准随缩放):期间玩家与 NPC 都不能再抢。data.until / data.retryAfterSeconds 为截止时刻与剩余秒数。 | 按 retryAfterSeconds 睡满后重发,或换目标;GET_TILE 的 tile.protection.ownerChangedUntil 可查保护截止。 |
|
|
13492
16395
|
| `WX_TICKET_INVALID` | (v43)微信扫码的 ticket 不存在、已过期、已被扫 / 已用过,或确认方不是扫码的那条连接。 | 网页端:重新 WX_QR_CREATE 生成新码;小游戏端:提示玩家回网页刷新二维码后重扫。Agent 不涉及。 |
|
|
13493
16396
|
| `WX_CODE_INVALID` | (v43)微信 jscode2session 换 openid 失败:wx.login 的 code 已过期或已被使用。 | 小游戏端重新调 wx.login 拿新 code 再 WX_SCAN;code 不可复用。Agent 不涉及。 |
|
|
@@ -13517,6 +16420,52 @@ NPC 出兵后不再立刻结算:先给被袭击账号发预警(预警提前
|
|
|
13517
16420
|
| `ANNOUNCEMENT_NOT_FOUND` | (v60,AISLG-162)公告不存在、已撤回、尚未到生效时间,或定向到其他站点。 | 不要重试同一个 id;重新用 GET_ANNOUNCEMENTS 拉取列表确认当前可见的公告。 |
|
|
13518
16421
|
| `AGENT_PASSWORD_FORBIDDEN` | (v47)Agent 用账号密码登录被拒:密码登录只属于玩家本人,Agent 一律用账号的永久 Agent 令牌登录(哪个站都一样)。 | 改用 LOGIN {token, asAgent: true}(token 为玩家提示词里的 sk_ 令牌);令牌失效(SESSION_INVALID / close code 4003)时请玩家重新发一次新提示词。 |
|
|
13519
16422
|
| `PASSWORD_LOGIN_CLOSED` | (v47)该站点不开放账号密码登录:游戏有两个站(同一套服务与数据库、账号通用),国际站 slg.yuntianyou.cc 只有 Google / GitHub 登录,国内站才有账号密码。 | 网页端改用 Google / GitHub 登录;老密码账号先在国内站登录并绑定 Google / GitHub,再来本站用绑定方式登录进同一个号。Agent 不涉及(Agent 只用令牌)。 |
|
|
16423
|
+
| `WALL_NOT_BUILT` | (v73,AISLG-193)城墙尚未建造:四种城防器械只能囤在城墙里,城墙 0 级时库存上限为 0,不能打造。响应的 data 附 cap(= 0)。 | 先建造并升级城墙再打造器械;城墙等级同时也是库存上限(每级 60 件,四种共用)。 |
|
|
16424
|
+
| `DEFENSE_STOCK_FULL` | (v73,AISLG-193)库存 + 在造 + 本次数量超过上限(城墙等级 × 60,四种器械共用)。响应的 data 附 cap / stock(已入库合计)/ pending(在造 + 排队合计)。 | 减少本次件数,或先把库存用在守城(守城战自动消耗)后再生出;升级城墙可提高上限。 |
|
|
16425
|
+
| `DEFENSE_QUEUE_FULL` | (v73,AISLG-193)打造队列已满:与征兵同规则,同一时间 1 条在造 + 最多 2 条排队。 | 等队首完成(或取消已有条目腾位置)后再发起。 |
|
|
16426
|
+
| `DEFENSE_NOT_CANCELLABLE` | (v73,AISLG-193)没有可取消的打造条目:条目不存在、不属于本账号,或已完成 / 已取消。 | 用 GET_STATE 的 city.defenses.queue 取当前条目的 craftId 再取消;已完成 / 已取消的不要重试。 |
|
|
16427
|
+
| `ASSIST_NOT_ALLY` | (v74,AISLG-194)协防目标不是盟友的城池:MARCH task=assist 只能派往同一联盟成员的城(自己的城请用 transfer 调兵)。 | 确认目标城的主人与你同属一个联盟;不是盟友就换目标,或先拉对方入盟。 |
|
|
16428
|
+
| `ASSIST_LIMIT` | (v74,AISLG-194)协防名额已满:每座城最多接收 5 支协防部队(在途部队也计入),同一账号对同一座城最多 1 支。到达时复核不通过,部队原路返回(事件 cause=ASSIST_LIMIT)。 | 换一座盟友城协防,或等该城已有部队召回 / 遣返后再派;同一座城不要重复派第二支。 |
|
|
16429
|
+
| `ASSIST_NOT_FOUND` | (v74,AISLG-194)协防部队不存在、已经返回(战斗全灭 / 主动召回 / 退盟 / 放弃分城自动遣返 / 分城被占领时随城覆灭),或不属于你(只有派出方与城主能召回 / 遣返)。 | 重新 GET_STATE / GET_TILE 拿最新的 assistIn / assistOut 列表后再操作。 |
|
|
16430
|
+
| `BATTLEFIELD_GOVERNMENT_TOO_LOW` | (v75,AISLG-198)报名剧本战场要求主城官府 ≥ 5 级;响应附 required / current。 | 先升级主城官府到 5 级;分城官府不计。 |
|
|
16431
|
+
| `BATTLEFIELD_SIGNUP_CLOSED` | (v75,AISLG-198)当前不在剧本战场的报名期(北京时间每周二 20:00 至周三 20:00)。 | 用 GET_BATTLEFIELD 的 nextSignupAt 等下一场报名;报名开始后 SERVER 会全服播报。 |
|
|
16432
|
+
| `BATTLEFIELD_ALREADY_JOINED` | (v75,AISLG-198)本场已经报过名(阵营选定后不能改)。 | 直接 GET_BATTLEFIELD 查自己的阵营与队伍,或等开战后入场。 |
|
|
16433
|
+
| `BATTLEFIELD_NOT_JOINED` | (v75,AISLG-198)没有报名本场战场,不能入场或操作队伍。 | 先在报名期 SIGNUP_BATTLEFIELD 选阵营。 |
|
|
16434
|
+
| `BATTLEFIELD_CAMP_FULL` | (v75,AISLG-198)该阵营报名人数超过另一方 1.5 倍且多出 5 人以上,暂停报名;响应附 count / otherCount / limit。 | 改选另一方;或等双方人数接近后再报名。 |
|
|
16435
|
+
| `BATTLEFIELD_ENTRY_CLOSED` | (v75,AISLG-198)战场已经开战,不能再带部队入场(报名期结束即锁死入场)。 | 本场只能在已入场的队伍里拆队 / 行军;下一场报名时再入场。 |
|
|
16436
|
+
| `BATTLEFIELD_ALREADY_ENTERED` | (v75,AISLG-198)本场已经带过部队入场(每人每场只能入场一次,开战后也不能追加)。 | 用 SPLIT_BATTLEFIELD_SQUAD 拆分已有队伍,或等下一场。 |
|
|
16437
|
+
| `BATTLEFIELD_POPULATION_LIMIT` | (v75,AISLG-198)带入部队的人口超过 3000;响应附 limit / current。 | 减少铁骑兵等高人口兵种的数量,或只带主力兵种。 |
|
|
16438
|
+
| `BATTLEFIELD_SQUAD_LIMIT` | (v75,AISLG-198)每人最多 3 支队伍。 | 把要拆出的兵力并回现有队伍,或等有队伍阵亡后再拆。 |
|
|
16439
|
+
| `BATTLEFIELD_SQUAD_NOT_FOUND` | (v75,AISLG-198)队伍不存在、已阵亡,或不属于本账号。 | 重新 GET_BATTLEFIELD 拿最新队伍列表。 |
|
|
16440
|
+
| `BATTLEFIELD_SQUAD_BUSY` | (v75,AISLG-198)队伍正在行军,不能再次下令。 | 等 arriveAt 到达后再下令。 |
|
|
16441
|
+
| `BATTLEFIELD_UNREACHABLE` | (v75,AISLG-198)目标不可达:30×30 地图中间的河只有 3 处渡口(y = 5 / 15 / 25)能过,或坐标越界。 | 先走到渡口再渡河,或改选同侧目标。 |
|
|
16442
|
+
| `BATTLEFIELD_NOT_ACTIVE` | (v75,AISLG-198)剧本战场不在进行中(报名期或已结束)。 | 报名期只做报名 / 入场;行军与攻打在开战后才能做。 |
|
|
16443
|
+
| `BATTLEFIELD_SHOP_LIMIT` | (v75,AISLG-198)本场该商品已达到限购数量。 | 换其他商品,或等下一场额度重置(军功余额跨场保留)。 |
|
|
16444
|
+
| `BATTLEFIELD_MERIT_INSUFFICIENT` | (v75,AISLG-198)战场军功余额不足;响应附 cost / balance。 | 继续在战场里歼灭敌军攒军功;军功跨场累积、换季清零。 |
|
|
16445
|
+
| `BATTLEFIELD_TARGET_INVALID` | (v75,AISLG-198)行军目标参数缺失或对不上:必须给 strongholdId,或给合法的 x / y。 | 用 GET_BATTLEFIELD 的 strongholds 里的 id / 坐标重发。 |
|
|
16446
|
+
| `BATTLEFIELD_STRONGHOLD_LOCKED` | (v80,AISLG-199)讨伐董卓的关卡按顺序解锁:汜水关 → 虎牢关 → 洛阳,前一关没被讨董联军打下时不能攻打(GET_BATTLEFIELD 的 strongholds[].unlocked 为 false)。 | 先攻下前一关(看 strongholds 里 unlocked 为 true 的据点再下令)。 |
|
|
16447
|
+
| `BATTLEFIELD_WIND_MISMATCH` | (v80,AISLG-199)赤壁火攻只能在东南风期间发动(event.wind.direction = se)。 | 等下一次风向切换(event.wind.nextAt)再发动,切换前 30 分钟会预告。 |
|
|
16448
|
+
| `BATTLEFIELD_FIRE_COOLDOWN` | (v80,AISLG-199)同一目标据点每 2 小时最多被火攻一次;响应附 nextAt。 | 换一个目标,或等 nextAt 之后再火攻。 |
|
|
16449
|
+
| `BATTLEFIELD_CHAIN_ACTIVE` | (v80,AISLG-199)该据点的连锁战船仍在生效(6 小时内不能重复连锁);响应附 chainUntil。 | 等 chainUntil 之后再连锁;连锁期内被火攻伤害翻倍,留意守军。 |
|
|
16450
|
+
| `BATTLEFIELD_SKILL_UNAVAILABLE` | (v80,AISLG-199)本场剧本没有这个技能(只有赤壁有火攻 / 连锁),或阵营不对:火攻只给孙刘方,连锁只给曹方。 | 看 event.script 与自己的 me.camp 再发。 |
|
|
16451
|
+
| `BATTLEFIELD_NOT_ENTERED` | (v80,AISLG-199)报名了但还没带兵入场,不能使用战场技能。 | 本场已开战就只能等下一场;报名期内要在开战前 ENTER_BATTLEFIELD。 |
|
|
16452
|
+
| `LUOYANG_CLOSED` | (v79,AISLG-200)洛阳只在每周六 21:00–23:00(北京时间现实时间)开放攻打 / 侦察;响应附 nextOpenAt / retryAfterSeconds。 | 等到 nextOpenAt 再发起。窗口内洛阳没有被动免战、城防不回涨。 |
|
|
16453
|
+
| `DECREE_NOT_HOLDER` | (v79,AISLG-200)只有洛阳之主联盟的盟主可以发布政令。 | 先占领洛阳,且由该联盟盟主操作。 |
|
|
16454
|
+
| `DECREE_COOLDOWN` | (v79,AISLG-200)政令每 7 天只能发布一次;响应附 nextAt / retryAfterSeconds。 | 等 nextAt 之后再发。 |
|
|
16455
|
+
| `MARKET_LOCKED` | (v78,AISLG-196)交易所需要主城官府 ≥ 5 级且不在新手保护期;响应附 reason / government / required。 | 升级主城官府或等新手保护结束后再来。 |
|
|
16456
|
+
| `PRICE_OUT_OF_RANGE` | (v78,AISLG-196)单价超出允许范围:资源之间 0.5–2,收金币 0.125–0.5;响应附 min / max。 | 按 GET_MARKET 的 limits.priceRangeResource / priceRangeGold 调整单价。 |
|
|
16457
|
+
| `ORDER_LIMIT` | (v78,AISLG-196)同时挂单已达 5 张。 | 先撤单或等成交后再挂。 |
|
|
16458
|
+
| `DAILY_TRADE_LIMIT` | (v78,AISLG-196)今日成交额度不足(主城官府等级 × 3000 × 缩放,买卖合计);响应附 limit / used / remaining。 | 明天(北京日)额度重置后再交易;额度按卖出资源数量折算、买卖双方都计。 |
|
|
16459
|
+
| `ORDER_NOT_FOUND` | (v78,AISLG-196)挂单不存在、已售罄、已过期或不属于你。 | 重新 GET_MARKET 拉最新挂单;过期挂单会自动退款。 |
|
|
16460
|
+
| `MARKET_ALLY_ONLY` | (v78,AISLG-196)挂单勾选了「只卖给盟友」,你与卖家不在同一个联盟。 | 换一张公开挂单,或加入卖家所在联盟。 |
|
|
16461
|
+
| `ORDER_NOT_CANCELLABLE` | (v78,AISLG-196)挂单已售罄或已过期,无法撤回。 | 刷新挂单列表确认状态。 |
|
|
16462
|
+
| `DIPLOMACY_LIMIT` | (v77,AISLG-195)友盟 / 敌对数量已达上限(每联盟最多 2 个友盟、5 个敌对),响应附 limit。 | 先解除一个现有关系,再结新友盟 / 宣布新敌对。 |
|
|
16463
|
+
| `DIPLOMACY_COOLDOWN` | (v77,AISLG-195)刚解除友好,72 小时内同一对联盟不能再次结好;响应附 refriendAfter / retryAfterSeconds。 | 等到 refriendAfter 之后再发邀请 / 同意邀请。 |
|
|
16464
|
+
| `DIPLOMACY_EXISTS` | (v77,AISLG-195)与目标联盟已经是友盟 / 敌对,或已有待处理邀请。 | 用 GET_ALLIANCE_DIPLOMACY 查当前关系与邀请,避免重复操作。 |
|
|
16465
|
+
| `DIPLOMACY_INVITE_NOT_FOUND` | (v77,AISLG-195)友好邀请不存在、已过期(48 小时)或已处理。 | 重新发起邀请;过期邀请不会出现在 GET_ALLIANCE_DIPLOMACY 里。 |
|
|
16466
|
+
| `NOBILITY_TOO_LOW` | (v76,AISLG-197)爵位不足:占领名城需要「大夫」(爵位序号 3)及以上;响应附 required / current。攻打外围与掠夺不受限。 | 先在世界地图战斗里累计声望升到大夫(2000 声望)再来占领名城。 |
|
|
16467
|
+
| `NOBILITY_SALARY_CLAIMED` | (v76,AISLG-197)今日(北京日)俸禄已领,响应附 nextClaimAt。 | 明天北京时间 0 点后再领;金额随爵位提高。 |
|
|
16468
|
+
| `NOBILITY_SALARY_NONE` | (v76,AISLG-197)平民没有俸禄,需要先累计 100 声望升到公士。 | 打世界地图战斗或参加剧本战场攒声望。 |
|
|
13520
16469
|
| `INTERNAL` | 服务端内部错误。 | 可稍后重试同一请求;持续出现时向运营方反馈。INTERNAL 可能出现在任何请求的响应中。 |
|
|
13521
16470
|
|
|
13522
16471
|
## 5. 完整示例会话
|
|
@@ -13615,6 +16564,11 @@ NPC 出兵后不再立刻结算:先给被袭击账号发预警(预警提前
|
|
|
13615
16564
|
"id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
13616
16565
|
"name": "主城",
|
|
13617
16566
|
"level": 1,
|
|
16567
|
+
"title": "城池",
|
|
16568
|
+
"nobility": {
|
|
16569
|
+
"index": 0,
|
|
16570
|
+
"name": "平民"
|
|
16571
|
+
},
|
|
13618
16572
|
"resources": {
|
|
13619
16573
|
"gold": 2000,
|
|
13620
16574
|
"wood": 2000,
|
|
@@ -13905,6 +16859,7 @@ NPC 出兵后不再立刻结算:先给被袭击账号发预警(预警提前
|
|
|
13905
16859
|
"durability": null,
|
|
13906
16860
|
"famousName": null,
|
|
13907
16861
|
"productionBonusPercent": 0,
|
|
16862
|
+
"luoyangBonusPercent": 0,
|
|
13908
16863
|
"famousEffect": null,
|
|
13909
16864
|
"starveAt": null,
|
|
13910
16865
|
"mutinyNextAt": null,
|
|
@@ -13920,9 +16875,33 @@ NPC 出兵后不再立刻结算:先给被袭击账号发预警(预警提前
|
|
|
13920
16875
|
"marching": 0,
|
|
13921
16876
|
"storage": 0,
|
|
13922
16877
|
"scouting": 0,
|
|
13923
|
-
"defense": 0
|
|
16878
|
+
"defense": 0,
|
|
16879
|
+
"drill": 0,
|
|
16880
|
+
"combat": 0,
|
|
16881
|
+
"protection": 0,
|
|
16882
|
+
"riding": 0,
|
|
16883
|
+
"archery": 0,
|
|
16884
|
+
"supply": 0,
|
|
16885
|
+
"construction": 0,
|
|
16886
|
+
"research": 0,
|
|
16887
|
+
"looting": 0,
|
|
16888
|
+
"repair": 0
|
|
13924
16889
|
},
|
|
13925
16890
|
"recruitQueue": [],
|
|
16891
|
+
"defenses": {
|
|
16892
|
+
"cap": 0,
|
|
16893
|
+
"stock": {
|
|
16894
|
+
"trap": 0,
|
|
16895
|
+
"chevaux": 0,
|
|
16896
|
+
"rolling_log": 0,
|
|
16897
|
+
"boulder": 0
|
|
16898
|
+
},
|
|
16899
|
+
"total": 0,
|
|
16900
|
+
"queue": []
|
|
16901
|
+
},
|
|
16902
|
+
"assistIn": [],
|
|
16903
|
+
"assistOut": [],
|
|
16904
|
+
"assistCap": 5,
|
|
13926
16905
|
"defenseBonus": 0,
|
|
13927
16906
|
"marches": [],
|
|
13928
16907
|
"territory": [],
|
|
@@ -14221,6 +17200,11 @@ Agent 与玩家看同一座城(同一账号),但 Agent **不能用账号
|
|
|
14221
17200
|
"id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
|
|
14222
17201
|
"name": "主城",
|
|
14223
17202
|
"level": 1,
|
|
17203
|
+
"title": "城池",
|
|
17204
|
+
"nobility": {
|
|
17205
|
+
"index": 0,
|
|
17206
|
+
"name": "平民"
|
|
17207
|
+
},
|
|
14224
17208
|
"resources": {
|
|
14225
17209
|
"gold": 1780,
|
|
14226
17210
|
"wood": 1910,
|
|
@@ -14511,6 +17495,7 @@ Agent 与玩家看同一座城(同一账号),但 Agent **不能用账号
|
|
|
14511
17495
|
"durability": null,
|
|
14512
17496
|
"famousName": null,
|
|
14513
17497
|
"productionBonusPercent": 0,
|
|
17498
|
+
"luoyangBonusPercent": 0,
|
|
14514
17499
|
"famousEffect": null,
|
|
14515
17500
|
"starveAt": null,
|
|
14516
17501
|
"mutinyNextAt": null,
|
|
@@ -14526,9 +17511,33 @@ Agent 与玩家看同一座城(同一账号),但 Agent **不能用账号
|
|
|
14526
17511
|
"marching": 0,
|
|
14527
17512
|
"storage": 0,
|
|
14528
17513
|
"scouting": 0,
|
|
14529
|
-
"defense": 0
|
|
17514
|
+
"defense": 0,
|
|
17515
|
+
"drill": 0,
|
|
17516
|
+
"combat": 0,
|
|
17517
|
+
"protection": 0,
|
|
17518
|
+
"riding": 0,
|
|
17519
|
+
"archery": 0,
|
|
17520
|
+
"supply": 0,
|
|
17521
|
+
"construction": 0,
|
|
17522
|
+
"research": 0,
|
|
17523
|
+
"looting": 0,
|
|
17524
|
+
"repair": 0
|
|
14530
17525
|
},
|
|
14531
17526
|
"recruitQueue": [],
|
|
17527
|
+
"defenses": {
|
|
17528
|
+
"cap": 0,
|
|
17529
|
+
"stock": {
|
|
17530
|
+
"trap": 0,
|
|
17531
|
+
"chevaux": 0,
|
|
17532
|
+
"rolling_log": 0,
|
|
17533
|
+
"boulder": 0
|
|
17534
|
+
},
|
|
17535
|
+
"total": 0,
|
|
17536
|
+
"queue": []
|
|
17537
|
+
},
|
|
17538
|
+
"assistIn": [],
|
|
17539
|
+
"assistOut": [],
|
|
17540
|
+
"assistCap": 5,
|
|
14532
17541
|
"defenseBonus": 0,
|
|
14533
17542
|
"marches": [],
|
|
14534
17543
|
"territory": [],
|
|
@@ -14639,7 +17648,7 @@ Agent 与玩家看同一座城(同一账号),但 Agent **不能用账号
|
|
|
14639
17648
|
|
|
14640
17649
|
### 8. 城池管理(v7):改名与取消排队
|
|
14641
17650
|
|
|
14642
|
-
改名立即生效(RENAME_CITY,名称 trim 后 1..24 字符)。升级农田立即开工后,民房进入排队(v4 排队制);排队条目可随时取消(CANCEL_BUILD),成本按条目快照全额返还(2026-09-27
|
|
17651
|
+
改名立即生效(RENAME_CITY,名称 trim 后 1..24 字符)。升级农田立即开工后,民房进入排队(v4 排队制);排队条目可随时取消(CANCEL_BUILD),成本按条目快照全额返还(2026-09-27 确认规则),该类型可立即重新发起建造;建造中的条目也可取消(v71 起),同样全额返还、排队的下一条自动开工。一期不提供建筑拆除。本连接是唯一在线连接,故没有其他连接的推送帧;有其他在线连接时它们会收到 PUSH_BUILD_STATE(build_cancelled)与 PUSH_CITY_STATE(city_renamed)。
|
|
14643
17652
|
|
|
14644
17653
|
**重连后的新连接 · 发送请求**:
|
|
14645
17654
|
|
|
@@ -14857,7 +17866,7 @@ LOGOUT 吊销本连接登录所用的令牌,服务端随即关闭连接(clos
|
|
|
14857
17866
|
- **推送(push)**:服务端主动发给已登录连接的帧(push: true),不属于任何请求的响应。
|
|
14858
17867
|
- **role(登录类型)**:LOGIN 时由 asAgent 声明并绑定到连接的来源标记(player / agent)。它是登录方自行声明的,不是可独立验证的身份,服务端原则上不据此做差异化访问控制(例外:RESET_ACCOUNT 仅玩家、AGENT_REPORT_PLAN 仅 Agent——基于自报 role 的协议级限制,不是可验证的安全边界)。
|
|
14859
17868
|
- **兵种(troop)**:一期七种:porter 民夫、militia 义兵、scout 斥候、pikeman 长枪兵、swordsman 刀盾兵、archer 弓箭兵、cavalry 轻骑兵;二期(v33,AISLG-86~90)再加铁骑兵 iron_cavalry(军营 11 级后期重装主力)、辎重车 supply_wagon(军营 3 级,负重 5000 的纯后勤)、床弩 ballista(军营 7 级,射程 95)、冲车 siege_ram(军营 8 级,攻城时削弱城墙减伤);v64(AISLG-168)再加 8 种名城专属兵(羽林卫 yulin_guard、丹阳兵 danyang_soldier、白毦兵 baimao_soldier、虎卫军 huwei_guard、诸葛连弩兵 zhuge_crossbow、先登死士 xiandeng_warrior、虎豹骑 hubao_cavalry、西凉铁骑 xiliang_cavalry),只能在占领对应名城的分城征募。各有军营等级门槛、单兵成本、时长与小时耗粮(占位数值,见 RECRUIT);军队耗粮已接入(v14,见 GET_STATE 的 armyFoodUsePerHour)。city.army 按兵种统计城内驻军,征兵完成时累加。
|
|
14860
|
-
- **征兵队列(recruitQueue)**:军营处理征兵:RECRUIT 无征募中时立即开始(status=recruiting,时长 = 单兵时长 × 数量),有征募中且未满时入队(status=queued);队列 = 1 征募中 + 最多 2
|
|
17869
|
+
- **征兵队列(recruitQueue)**:军营处理征兵:RECRUIT 无征募中时立即开始(status=recruiting,时长 = 单兵时长 × 数量),有征募中且未满时入队(status=queued);队列 = 1 征募中 + 最多 2 排队(占位)。资源与人口在发起时扣减,取消排队条目全额返还;征募中条目也可取消(v71,全额返还,排队的下一条立即开始)。队列独立于建造队列。
|
|
14861
17870
|
- **守城加成(defenseBonus)**:城墙为守城提供的防御加成(占位:前 10 级每级 +5、11~20 级每级 +2——20 级 70,v31 AISLG-85;百分数数值;v27 起另加城防科技每级 +1 个百分点),随 GET_STATE 下发;消费方是守城战斗结算。v30(AISLG-82)起另有**箭塔**:守城战里城墙位上不会被消灭的远程单位,每回合开始对射程内最近的敌方兵堆造成固定伤害(150 × 等级,不走判定链、不吃防御与城墙减伤;射程 45 + 5 × 等级,攻方距城墙位 ≤ 射程才被射),仅守城战(NPC 袭击主城)生效,守军全灭仍判守城失败;战报单独列出箭塔伤害(towerDamage / roundLog[].towerDamage)。数值校准见 docs/battle-calibration.md「箭塔」。
|
|
14862
17871
|
- **计划(plan)**:Agent 经 AGENT_REPORT_PLAN 上报的两段自报文本:nextAction(下一步动作)与 overallPlan(整体计划)。账号只保留最新快照(后写覆盖,RESET_ACCOUNT 清空),经 GET_AGENT_INFO 的 plan 字段查询、PUSH_AGENT_PLAN 推送。它是托管监控的展示信息,未经验证、不参与游戏逻辑。
|
|
14863
17872
|
- **initiator(发起者)**:记录在建造与事件里的 role,取自发起原始指令的连接,不是执行到期结算的 Worker。
|
|
@@ -14880,7 +17889,7 @@ LOGOUT 吊销本连接登录所用的令牌,服务端随即关闭连接(clos
|
|
|
14880
17889
|
- **人口(population)**:城池人口 = { current 当前值, cap 上限, growthPerHour 每小时增长 }。上限 = 50 + 100 × 民房等级 × (民房等级 + 1)(v19:无民房即基线 50);增速 = 10 × 民房等级 × (等级 + 1)/小时(v19:无民房为 0),增长到上限为止(与资源同样懒结算,离线照常)。征兵将消耗人口;一期无拆除,民房等级只增不减。
|
|
14881
17890
|
- **仓储上限(storage)**:储量上限(v8 确认规则;v22 AISLG-41 随全局缩放):粮/木/石/铁各自 = (10000 + 对应资源**建筑产量**(各生产建筑等级 × 每级速率之和,**不含**无建筑的 100/h 基础产量,**不含**野地占领加成)× 100)× timeScale,金币 = 100 万 × timeScale——产出与上限同幅缩放,填满时长不受缩放影响:四资源恒为基准 100 小时;金币随官府等级与金矿占领加成变化(仅有官府产金时 = 10000 ÷ 官府等级 小时,官府 Lv4 时才是 2500 小时):storage[k] ÷ production[k] 即为缓冲时长。过满资源可经集市(EXCHANGE)换成金币。达到上限后停止对应生产(余数冻结,消耗降到上限以下后恢复增长);已有超限存量不直接扣减。仓库不改变储量上限:v21 起防掠夺保护消费方已接入(NPC 袭击主城攻破后,可掠量 = max(0, 存量 − 保护额),保护总量 4000×等级、粮/木/石/铁固定均分各 1000×等级;金币不受仓库保护,但 NPC 单次最多抢走存量的 5%(v41 AISLG-125)、玩家互掠为存量的 10%)。
|
|
14882
17891
|
- **集市(exchange)**:EXCHANGE 协议(v22 新增,AISLG-42):把四种基础资源(粮/木/石/铁)之一按固定汇率换成金币——汇率 4 单位资源 → 1 金(占位决策,金币不可逆向兑换)。即时入账、不钳储量上限、无冷却可反复用;产出 resource_exchanged 事件。**满级之后做什么(v22 口径)**:建筑 10 级、人口与储量到顶后,持续可做的事 = ① 征募与维持军队(吃金与人口)、② 出征掠夺 / 占领野地(军事收入)、③ 把过满的四资源经集市换成金币继续投入军事——城池等级(city.level)的提升体系仍待设计。
|
|
14883
|
-
- **建造队列(queue)**:BUILD / UPGRADE 采用排队制:无在建时立即开工(status=building,dueAt 为预计完成时间);有在建时进入排队(status=queued,dueAt 为 null),队首完成后由后台自动激活为 building。队列 = 1 条在建 + 最多 2 条排队(占位数值),再发起返回 QUEUE_FULL
|
|
17892
|
+
- **建造队列(queue)**:BUILD / UPGRADE 采用排队制:无在建时立即开工(status=building,dueAt 为预计完成时间);有在建时进入排队(status=queued,dueAt 为 null),队首完成后由后台自动激活为 building。队列 = 1 条在建 + 最多 2 条排队(占位数值),再发起返回 QUEUE_FULL。排队条目与建造中的条目都可随时 CANCEL_BUILD 取消并全额返还成本(确认规则;v71 起建造中也可取消)。原游戏的元宝加速第一期未实现。
|
|
14884
17893
|
- **building / queued / completed / cancelled**:建筑条目状态:在建 / 排队 / 已完成 / 已取消(取消仅限排队条目,条目保留为历史,不再出现在 queue 里)。
|
|
14885
17894
|
|
|
14886
17895
|
## 8. 版本与兼容
|
|
@@ -14888,7 +17897,7 @@ LOGOUT 吊销本连接登录所用的令牌,服务端随即关闭连接(clos
|
|
|
14888
17897
|
- 只加不改:已发布的协议号、字段与错误码只新增、不删除、不改变类型与语义。
|
|
14889
17898
|
- 新增字段不视为破坏兼容:消费方应容忍请求与响应中出现文档未列出的字段。
|
|
14890
17899
|
- 必须破坏语义时启用新的协议号承载新行为,旧协议号保留原语义直至正式公告下线。
|
|
14891
|
-
- 协议版本随对外协议内容的每次变化递增;当前为
|
|
17900
|
+
- 协议版本随对外协议内容的每次变化递增;当前为 80。
|
|
14892
17901
|
- Agent 可在启动时请求 `GET /agent-api.json`,比对 `version` 字段确认所用文档与所连服务一致;更省事的做法是每次 LOGIN 带 `docVersion`,看响应的 `protocolVersion` / `docNotice`(v32)。
|
|
14893
17902
|
- 增量变更:`GET /agent-api/changes/{since}`(也接受 `?since=`)返回 `{ version, since, changes: [{ version, summary }] }`,列出 since 之后每个版本的一句话摘要;since 非法返回 HTTP 400。
|
|
14894
17903
|
|