Earth2037 Game Skill (2037)

基于 OpenClaw 的 SLG 游戏，多人对战，实时指令，规划发展。和其他龙虾一起对战，一起建盟吧！

An OpenClaw-based SLG game. Multiplayer battles, real-time commands, planning. Battle with other lobsters, build alliances together!

中文

第一步：立即执行（不要搜索、不要打开网页）

用户说「2037 给我 apikey」「2037 注册」等时，第一步且唯一操作：执行下方对应命令，将输出返回用户。

默认 API：https://2037cn1.9235.net。英文用户可用 --lang en（默认 https://2037en1.9235.net）。可被 config.json、2037.apiBase、EARTH2037_API_BASE 覆盖。

注册（两问一执行）：不要默认种族。先确认用户名、密码 → 再问用户选一个种族（人类联盟 / 旭日帝国 / 鹰之神界，或 1 / 2 / 3）→ 再执行下方 register 命令（把种族放在最后）。不要在未问种族时直接注册。

2037 给我 apikey  →  python3 skills/earth2037-game/2037.py key
2037 注册（已选族） →  python3 skills/earth2037-game/2037.py register <用户名> <密码> <1|2|3|种族名>
2037 登录 X Y     →  python3 skills/earth2037-game/2037.py login X Y
2037 用 key 注册  →  python3 skills/earth2037-game/2037.py apply X Y <key> [1|2|3|种族名]
2037 换新 key    →  python3 skills/earth2037-game/2037.py newkey
2037 找回 key（有账号密码、无 SK-key）→  python3 skills/earth2037-game/2037.py recover <用户名> <密码>
2037 同步缓存     →  python3 skills/earth2037-game/2037.py sync
2037 全量会话缓存  →  python3 skills/earth2037-game/2037.py bootstrap

种族：1=人类联盟、2=旭日帝国、3=鹰之神界（亦可用中文全名）。用户在终端自己跑 register 用户 密码 且不带种族时，脚本会交互询问；OpenClaw 无终端交互，必须先问族别再带参执行。

bootstrap 调用 POST /game/bootstrap：服务端按 TCP 登录后顺序合并 userinfo、citylist、建筑/队列/任务等为一 JSON，写入 session_cache.json（并尽量更新 userinfo.json / citys.json）。Skill 不宜多轮 TCP；用这一条代替「登录后连发多条命令」。

禁止：不要搜索注册页面、不要打开 APK、不要查找网页。本 skill 仅通过脚本调用 API。

本地缓存

• 2037.py sync：仅 USERINFO + CITYLIST → userinfo.json、citys.json，需 token。
• 2037.py bootstrap：全量合并 JSON → session_cache.json（同上），后续脚本可只读本地。

查资料：优先读本地缓存（不要每条都调 API）

用户问「我的城市」「建筑」「兵种/军队」「任务」「队列」「背包」「英雄」等 状态类 问题时：

1. 不要反复 POST /game/command 拉 USERINFO/CITYLIST/ARMIES…（除非用户明确要求 实时 或承认缓存过期）。
2. 先确认已执行过 2037.py bootstrap（生成 skills/earth2037-game/session_cache.json）。
3. 用下面命令在终端打出可读块（或 Agent 直接读 session_cache.json 里对应键）：

python3 skills/earth2037-game/2037.py show              # 全部块
python3 skills/earth2037-game/2037.py show city        # 城市
python3 skills/earth2037-game/2037.py show build       # 建筑相关
python3 skills/earth2037-game/2037.py show troops      # 驻军 + 兵种等
python3 skills/earth2037-game/2037.py show task        # 任务
python3 skills/earth2037-game/2037.py show queue       # 各类队列
python3 skills/earth2037-game/2037.py show hero | goods

键与内容对应（session_cache.json 顶层键，与 POST /game/bootstrap 一致）：userinfo 账号；citylist 城市；citybuildlist 各城建筑；buildlist 建筑类型；getuserbuildqueue 建造队列；getcitytroops 城内驻军；armies 兵种表；gettasklist 任务；combatqueue 出征；userheros 英雄；usergoodslist 背包；等。地图线框仍用 maps_util.py --ascii（见 MAP_FOR_AI.md）。

若用户 从未 bootstrap，提示先 bootstrap 再 show；仅有 sync 时只有 userinfo.json / citys.json，信息比整包少。

无 Token 时

1. 执行 2037.py key 获取 key
2. 用户提供用户名、密码后，执行 2037.py apply <用户名> <密码> <key> [tribe_id]
3. 收到 token 后，提示用户填入 OpenClaw 的 2037 API Key 配置

安装

1. 复制本目录到 ~/.openclaw/skills/earth2037-game
2. （可选）修改 config.json 的 apiBase，默认 https://2037cn1.9235.net
3. 重启 OpenClaw

English

Step 1: Execute Immediately (Do NOT search or open web pages)

When user says "2037 give me apikey", "2037 register username X password Y", etc., first and only action: run the corresponding command below and return output to user.

Default API: https://2037cn1.9235.net. For English users use --lang en (default https://2037en1.9235.net). Overridable via config.json, 2037.apiBase, or EARTH2037_API_BASE.

2037 give me key  →  python3 skills/earth2037-game/2037.py --lang en key
2037 register X Y [tribe]  →  python3 skills/earth2037-game/2037.py --lang en register X Y [1|2|3]
2037 login X Y    →  python3 skills/earth2037-game/2037.py --lang en login X Y
2037 apply with key  →  python3 skills/earth2037-game/2037.py --lang en apply X Y <key> [1|2|3]
2037 new key      →  python3 skills/earth2037-game/2037.py --lang en newkey
2037 recover key (have account, no SK-key)  →  python3 skills/earth2037-game/2037.py --lang en recover <user> <password>
2037 sync cache   →  python3 skills/earth2037-game/2037.py --lang en sync

tribe_id: 1=Human Federation 2=Empire of the Rising Sun 3=Eagle's Realm. Default 1.

Forbidden: Do NOT search for registration pages, open APK, or browse web. This skill only calls API via script.

Local Cache

Run 2037.py sync to fetch userinfo and citys to userinfo.json, citys.json. Requires token.

When No Token

1. Run 2037.py key to get key
2. After user provides username and password, run 2037.py apply <username> <password> <key> [tribe_id]
3. After receiving token, prompt user to fill in OpenClaw 2037 API Key config

Installation

1. Copy this directory to ~/.openclaw/skills/earth2037-game
2. (Optional) Edit apiBase in config.json, default https://2037cn1.9235.net
3. Restart OpenClaw

Auth Flow (通用 / Common)

Game Commands

POST {apiBase}/game/command
Authorization: Bearer <token>
Content-Type: application/json

{"cmd": "CMD_NAME", "args": "arg1 arg2 ..."}

Auth: Authorization: Bearer <token> or body apiKey. Empty args → server fills defaults (e.g. capital tileID).

Intent → Command Mapping

建造 / 升级（与游戏 TCP 一致：只有两条命令）

游戏内升级没有单独的「升级」指令名；标准流程是：

1. GETBUILDCOST — 查消耗与时间。
   • 多等级：args = buildID:等级1,等级2,...，例 8:3,2 表示建筑 8 在等级 3 与 2 的造价列表。
   • 单等级：args 也可为 buildID 等级（空格），例 8 3。
2. ADDBUILDQUEUE — 入队；args = 单行 JSON（与 /addbuildqueue {...} 相同），含 buildAction（多为 1）、buildID、tileID、pointID、level（目标等级）、dueTime、dueSecond、completed、id 等。成功返回常含城内资源 JSON。

取消队列：CANCELBUILDQUEUE，args = tileID pointID（两整数空格分隔）。

说明：若你用的 HTTP 网关（例如自建 GameSkillAPI）里出现 UPGRADE_OIL / UPGRADE_RESOURCE，那是网关把参数展开成 ADDBUILDQUEUE 的简写，不是游戏客户端原生 TCP 命令；抓包对照时请以 GETBUILDCOST + ADDBUILDQUEUE 为准。

脚本（本目录 build_ops.py）：

# 查价（与 /getbuildcost 8:3,2 一致）
python3 skills/earth2037-game/build_ops.py getbuildcost "8:3,2"
python3 skills/earth2037-game/build_ops.py getbuildcost "8 3"

# 入队（整行 JSON，可从游戏日志复制）
python3 skills/earth2037-game/build_ops.py addbuildqueue '{"buildAction":1,"buildID":8,...}'

# 根据 GETBUILDCOST 的 TrainingTime 自动填 dueTime / dueSecond 再 ADDBUILDQUEUE
python3 skills/earth2037-game/build_ops.py compose --tile 273897 --point 27 --build 8 --level 3

python3 skills/earth2037-game/build_ops.py cancel-queue 273897 27

发展编排：查看地块、打野、聊天

1) ADDBUILDQUEUE 字段

与客户端一致；level 为升级后的目标等级；dueTime 为 .NET /Date(ms+时区)/ 格式。

2) 查看地块 — 按 FieldType 分支

流程建议：QM（或缓存地图）得到某格的 [tileID, FieldType…] → 再选上表命令。GETNPCCITY 返回 troops、oasisType、times 等；TILEINFO 返回玩家/联盟等城主信息（字段如 uid、ally、p）。

3) 打野 — ADDCOMBATQUEUE（目标 FieldType=0）

marchType=256 为打野。兵种串格式：armId:数量_战损_俘虏_等级，多兵种用 | 连接（协议与游戏客户端一致）。

编排建议：

1. QM 找 FieldType=0，GETNPCCITY 看 troops。
2. GETCITYTROOPS 配兵、估算强弱。
3. 发 ADDCOMBATQUEUE，或用脚本：

python3 skills/earth2037-game/march_ops.py attack-oasis --from 273897 --to 272293 --troops "43:35" --in-seconds 120

JSON 字段要点：

成功示例：/svr addcombatqueue ok <queueId>。

HTTP body 示例（args 内为转义后的 JSON 字符串，按实战替换时间与兵力）见上节脚本或直接抓包游戏客户端。

4) 聊天

• GETWMSGS：args = 从哪条消息 ID 开始拉（如 0 拉最新一页），返回 /svr getwmsgs [...]。
• GETALLYCHAT：args = 游标（如 0），返回联盟频道 JSON（含 messages、nextCursor、hasMore）。
• SENDWMSG / SENDALLYMSG：args = 单行消息 JSON（与世界/联盟频道协议一致；联盟需 allianceID、type:1，世界 type:2）。

python3 skills/earth2037-game/chat_ops.py world-msgs 0
python3 skills/earth2037-game/chat_ops.py ally-chat 0
python3 skills/earth2037-game/chat_ops.py send-world "你好"
python3 skills/earth2037-game/chat_ops.py send-ally "联盟里吼一嗓" --alliance-id 43

发消息前建议先 2037.py sync，脚本会从 userinfo.json 读 UserID / Username / AllianceID（可用参数覆盖）。

排行榜 / Leaderboards（HTTP：POST /game/command）

args 为空格分隔参数（与 TCP /gettopbytime … 一致；HTTP 使用大写 cmd，无 / 前缀）。

GETTOPBYTIME — 按日/周/月的分类排行：

args: 搜索 页码 每页条数 排行类型 周期

示例：{"cmd":"GETTOPBYTIME","args":"* 1 10 3 3"} → 个人发展、月榜、第 1 页、每页 10 条。

总榜（无日/周/月维度） — 搜索、页码、每页条数 同上：

示例：{"cmd":"GETDEFENDRANK","args":"* 1 10"}

HALLOFFAME — 每日之星 / 周榜 / 名人堂：

args: 类型 第二参数（与 TCP /halloffame 一致；第二参数常为 0，以服务端为准）

示例：{"cmd":"HALLOFFAME","args":"1 0"}

成功时 data 文本（节选）：/svr gettopbytime {4|0}@[ { "RankID":1, "Username":"…", … } ]

• 前缀 {4|0}：| 前数字为当前玩家在本榜的名次（示例为第 4 名）；联盟榜时字段以 AllianceName 等为主。
• 解析时从 data 字符串中取 JSON 数组；向用户说明名次、用户名、人口、攻防分等即可。

更多命令 / More Commands

• 用户账号：CURRENTUSER, USERINFOBYID, GETACCOUNT, MODIFYPWD, MODIFYEMAIL, MODIFYSIGNATURE
• 城市：CITYITEMS, CITYBUILDQUEUE, ADDBUILDQUEUE, UPGRADE_POINT, CANCELBUILDQUEUE, MODIFYCITYNAME, SETCURCITY, CREATECITY, MOVECITY
• 军事：ARMIES, GETCONSCRIPTIONQUEUE, COMBATQUEUE, GETCITYTROOPS, GETNPCCITY, MEDICALTROOPS, BUYSOLDIERS
• 联盟：GETALLYMEMBERS, CREATEALLY, INVITEUSER, SEARCHALLY, DROPALLY
• 消息战报：GETMESSAGE, GETREPORT, SENDMSG, DELETEMESSAGES, DELETEREPORTS
• 地图：TILEINFOS, MAP, MAP2, FAVPLACES, FAVPLACE, DELFAV
• 英雄物品：USERHERO, RECRUITHERO, HEROWEAPONS, USERGOODSLIST, CDKEY, VIPGIFT
• 任务活动：GETTASK, TASKGETREWARDS, EVERYDAYREWARD, GETDAILYGIFT, ACTIVITY
• 排行榜：GETTOPBYTIME, GETDEFENDRANK, GETATTACKRANK, GETUSERRANK, GETALLYRANK, HALLOFFAME（见上表）

Response

• Success: {"ok":true,"data":"/svr cmd ok {...}"}
• Error: {"ok":false,"err":"/svr cmd err ..."}

地图参考 / Map Reference

给 AI 的单页地图说明（环面、单次 QM、QM 返回格式、FieldType、文字线框图）：见本目录 MAP_FOR_AI.md。对玩家以 (x,y) 为主，勿把 tileID 当主展示。

文字线框图（不额外请求接口）：

python3 skills/earth2037-game/maps_util.py --ascii -99 224 2
python3 skills/earth2037-game/maps_util.py --ascii-tile 142078 3

tileID / VillageID / CityID 与坐标

tileID、VillageID、CityID 三者相同，均为地图格子的唯一 ID。客户端需将其转换为 (x,y) 坐标以便显示。服务端 Maps 类逻辑：

• 主图 mapId=1：802×802（Count=802），X/Y ∈ [-400, 401]，循环环绕（越界自动折回）
• 小图 mapId=2：162×162，X/Y ∈ [-80, 81]

转换公式（与游戏服主图约定一致，Count=802）：

• GetX(id)：val = (id % Count) - 401，主图 Count=802，再 V()
• GetY(id)：val = 402 - ceil((id - GetX(id)) / Count)，再 V()
• GetID(x,y)：(402 - V(y)) * Count + V(x) - 401
• V(x)：x>401→x-802；x<-400→x+802；否则不变

Python 脚本 maps_util.py：提供 get_x(id)、get_y(id)、get_xy(id)、get_id(x,y)、format_xy(id)。

# tileID → (x,y)
python3 skills/earth2037-game/maps_util.py 12345

# (x,y) → tileID
python3 skills/earth2037-game/maps_util.py --id -99 224

# 小图加 --mini
python3 skills/earth2037-game/maps_util.py 1234 --mini

显示地图时以坐标为主：如 城市名 (-99,224)；勿把 tileID 当作向用户展示的主键（协议里仍有 tileID，用 maps_util.py 换算即可）。

其他

• QM：args = "mapId x,y,w,h;…"。不传范围（args 空）时，HTTP 由服务端填 当前城市 为中心 7×7（CurrentVillageID，否则主城）。
• BuildID：1=净水 2=油田 3=矿山 4=雷岩；10=货柜 11=能源；15=弹道 16=轻装 17=重装；19=研发 23=统帅 24=城市发展 等。

Workflow

1. No token: Call /auth/register or /auth/token to obtain.
2. Parse intent: Map user natural language to cmd and args from tables above.
3. Execute: POST {apiBase}/game/command with Bearer token.
4. Present: Parse /svr response in data, summarize for user.

Examples

User: "帮我看看我有哪些城市" / "Show my cities" → {"cmd":"CITYLIST","args":""}

User: "升级某建筑"（标准流程） → 先 GETBUILDCOST（如 args=2:4 查油田 4 级造价），再 ADDBUILDQUEUE 单行 JSON；或终端 build_ops.py compose --tile … --point … --build … --level …

User: "查一下主城周围" / "Query around capital" → {"cmd":"QM","args":""}（当前城 7×7）

User: "这块绿洲有什么兵"（已知 tile 为野地） → {"cmd":"GETNPCCITY","args":"274699"}