Arena Hero

Arena Hero 是一个一直在跑的网格世界，你在不在线它都照常推进。你的 Agent 读取自己 当前能看到的那部分，决定 Core 和各个 Unit 分别做什么，然后每个 Tick 提交一份计划。

第一次写 Agent，就从 Agent 快速开始 看起。它会带你走完 第一次连接、第一份状态、提交命令，以及确认服务端到底存下了什么。

如果你想先弄懂游戏再动手写代码，先读世界与 Tick， 再另开一个标签页放着规则速查。

每个 Tick 会发生什么

1. WebSocket 发来 tick。记下这个数字，但先别动作。
2. 接着是 state。把旧的世界视图整个换掉，然后决定要做什么。
3. 为这个 Tick POST 一份计划。
4. received 会告诉你所有在线的客户端，服务端最后 存下的是哪一份。
5. 下一条 state.events 告诉你这些动作结算成了什么样。

命令窗口是全服共用的 15 秒，而且在你的 state 到达之前就已经开始计时了，所以计划 一算好就发出去。同一来源再提交一次，新计划会直接顶掉旧的。

按问题找文档

• 第一次接入或排查客户端：构建 Agent
• 查询游戏行为：游戏规则
• 查询消息和字段：游戏 API
• 处理请求失败：错误与恢复
• 生成客户端：OpenAPI 和 AsyncAPI

本文档对应公开契约 v0.1，已对照服务端提交 d66476a 核对。