主题
验证与版本说明
本教程的适用环境、已验证行为、下载包范围与反馈方式。
本教程使用 SE（状态同步） 的 Lua API，适合从第 01 课开始学习。帧同步地图和旧 LuaAPI 示例不适用于这条主线。
两套教程怎样选择
本系列以 10 课小游戏主线配合按需专题与帮助页，适合从具体操作和结果学习 Lua。SE UGC Lua 开发系列则按 API 领域展开 23 章。两套系列教程独立维护学习内容、代码和下载包，作者可按学习目标选择。
每课有独立的完整代码快照。正文中的主线代码与快照逐字校验，构建时从快照生成 ZIP；缺文件、跨端引用、摘录与源文件不一致时，下载包构建会停止。
适用环境与验证范围
| 项目 | 本次范围 |
|---|---|
| 日期 | 2026-09-05，Asia/Shanghai |
| API 基线 | SE Meta 工作副本 revision 4253724；解析得到 363 个类型 |
| CLI | Editor CLI 0.16.5 |
| 地图 | 独立 SE 测试地图，按场景指南准备球、方块与 EUI |
| 主线工程 | 10 个阶段、29 份 Lua 文件，逐阶段安装并启动单人试玩 |
| 当前 VM 编译 | 147 个正文 Lua 块及 29 份完整阶段源码全部通过真实 Editor VM 编译；完整源码校验覆盖正文未展示的部分 |
| 已观察行为 | 双端日志、物理碰撞、计数与复位、限时回合、玩家归属、个人得分与客户端快照、HUD 时间和分数、结算状态 |
| 回调与边界 | 按钮回调发出重开请求；错误/旧请求与进行中重开被拒绝；重复请求只开一局；旧快照不使 HUD 回退；节点恢复、重复初始化与清理 |
| 重新安装 | 测试地图保存并重开后，从第 10 课实际 ZIP 重新安装，已观察到服务端计分与 HUD 同步 |
| 专题补验 | 26 个适合当前地图的片段执行完成；其中 25 项观察到目标结果，HumanUnit 创建及控制器可用，但 Animator 未就绪，不能视为动画能力已通过 |
碰撞使用真实角色和物理运动验证。部分回归通过调整测试场景位置、施加球体速度来稳定触发碰撞。按钮回调测试通过测试框架派发点击信号，验证客户端回调到服务端再到 HUD 的链路。
按钮的真实鼠标/触摸命中区域仍需在目标设备确认。 当前 CLI 的触摸注入没有产生可确认的按钮点击，不能用“命令成功”或“回调通过”代替人手点击验收。图中按钮可见、文字清晰，只证明界面状态。
尚未完成的验证包括：两个真实玩家之间的归属切换、同时重开与中途加入，手机触摸与窄屏布局，音效可听结果，以及装入可选特效后的实际播放。未安装 HitEffect 的情况下，计分、复位与 HUD 已能继续工作。
怎样理解通过与待验证
| 检查 | 能证明什么 |
|---|---|
| 公开契约复核 | 使用的类型、成员、运行端、参数与枚举符合当前 Meta；动态调用仍要结合上下文判断 |
| Lua VM 编译 | 当前编辑器能解析完整代码；不证明异步回调、场景依赖或视觉结果 |
| 行为实测 | 绑定版本、地图和步骤下观察到预期结果；不自动覆盖多人、压力或其他设备 |
| 新手试读 | 真实新作者能按步骤完成、解释结果、恢复错误；本次尚未开展，不能由自动化测试替代 |
专题中的存档、排行榜、交易、跨服、传送、分析上报与自定义资产权限，仍需按该专题标出的测试环境接入。主线不以这些能力为前置。历史专题运行证据不自动升级为本次重写内容的行为保证。
下载包包含什么
- 各课页面提供第 01–10 课独立 ZIP。
- 第 10 课完整工程是本系列主线的最终检查点；SE UGC Lua 开发系列另有第 22 章 Capstone 工程。
- 包含该课 Lua 文件、README、场景与 UI 说明及配图；场景对象和资源需要在编辑器中创建。
- 开始前按 README 安装本阶段全部文件，保留已有工程的原生目录；不要混用不同阶段入口。
遇到问题时提供这些信息
先看按现象排错。仍不能解决时，反馈课号、具体步骤、所用阶段包、Editor/CLI 版本、运行端、预期与实际结果，以及同次试玩的日志和画面。涉及资源时附资源类型和公开 ID，避免只发送一个报错截图。
升级 Meta 或编辑器后，应先重跑当前课的运行检查。若教程和目标版本正式 API 页面冲突，以目标版本公开契约为准，并反馈冲突位置。