主题
发布说明、适用环境与验证范围
开发系列的维护基线、真实编辑器验证范围、完整工程下载与反馈方式。
本系列通过 23 章独立实验介绍 SE Lua 开发能力，第 22 章提供完整推球项目。想按一个小游戏逐步入门，也可以选择推球实战系列。两套教程独立维护，按自己的目标选择即可。
当前维护基线
| 项目 | 2026-09-05 复核结果 |
|---|---|
| 教程规模 | 23 章、131 个 Lua 代码块 |
| 公开契约 | 363 个 Meta JSON；工作副本 revision 4253166；Meta tree SHA-256 bc77f26627bc668329e0bc216e8f935430c9763f7c41edc7f07d4a4387a5de36 |
| 全量静态检查 | 79 块 pass、52 块 unproven；分析 1032 个调用，其中 213 个动态或跨文件调用需人工补证；0 确定违规 |
| 全量真实 Editor VM 编译 | 131/131 compile_pass；本轮全部重新执行，无缓存复用 |
| 双端代表性片段 | server 14 + client 12，共 26 项执行完成；结论以各项实际观测为限 |
| 运行环境 | Editor CLI 0.16.5、SE 测试地图；环境指纹 c782c13946015b0720507d0a5059084854456c5d662a51f4be286665049cb29e |
“unproven”表示静态分析不能证明该动态调用，不等于发现了错误，也不能用编译通过代替其行为验证。代码块前分别注明完整模块、配套入口、独立实验、函数片段或错误对照；只有定义的模块需要由入口加载和调用，不能把所有代码块依次粘在一起运行。
本轮逐章补齐安装范围、实验结果、练习参考和失败恢复说明；修正了服务端回合到期收尾、HUD 就绪重试、特效延迟相互干扰、诊断代码意外加分、异常交付盲目重试等问题。完整工程的特效改为可选，先完成基础计分闭环再添加表现。
如何理解实测结论
| 检查 | 本轮能证明的范围 |
|---|---|
| 编译 | 当前 131 个代码块均能被真实 SE Lua VM 解析；错误对照也可能语法合法，不能据此安装运行 |
| 代表性执行 | 对象与服务查询、角色就绪、射线查询、相机读取和日志监听等片段完成执行；Jump 实际记录到 Idle → Jumping |
| 保护分支 | Animator 尚未创建的片段安全返回；这不证明人形动画能够加载或播放 |
| 视觉边界 | 灯光、天空等属性调用完成不等于目标设备上的最终视觉效果通过；需在自己的地图检查画面 |
| UI 恢复 | 已验证错误快照被拒绝、重复 Destroy 安全、缺少标签时拒绝初始化、恢复标签并请求后显示当前快照 |
第 22 章下载工程的系统验收另行覆盖真实角色触球、物理碰撞、服务端计分、客户端快照、到期结算及自动重开。它不替代多人、中途加入、角色重生、弱网或压力测试；这些仍须在目标地图按第 21、22 章的清单验证。
Editor 协议未返回可绑定的编辑器 build ID，因此以上结论绑定到列出的 Meta、CLI、模式及环境指纹。API 页面与教程冲突时，以目标版本的正式 API 页面和 Meta 为准。升级运行包后，应重新完成相关实验和核心回归。
尚未完成行为验证的能力
- DataStore、OrderedDataStore 的真实持久化、并发与存档迁移。
- MessageService 跨服送达、TeleportService 传送和预留服务器。
- 商品交付、社交动作、正式分析埋点。
- 需要真实授权资源的人形动画、相机震动及自定义资产下载链路。
- 多客户端同步、玩家离开与重生、弱网乱序以及移动端输入和表现。
这些章节提供公开接口与接入思路；函数定义、日志完成或保护分支不能当成业务成功。实际接入时使用专用测试账号、隔离数据和目标资源，分别记录成功、失败或缺少条件。
下载完整项目
ZIP 由第 22 章六个路径化代码块确定性生成，包含 data/capstone_config.lua、common/remote_events.lua、server/round_manager.lua、server/main.lua、client/hud.lua、client/main.lua 和安装说明。
解压后把四个目录复制到专用实验地图的 SE Lua 工程根目录。场景和 UI 不在 ZIP 内：按第 22 章创建“球体”“方块”两个 WorldUnit 及 label_time、label_point 两个 EUITextLabel，确认物理设置与布局；HitEffect 为可选 EffectUnit。不要与前文同名但接口不同的模块混装。
反馈问题
通过文档发布方的反馈入口或项目 issue 提供：章节与代码块位置、Editor/CLI 版本、Meta revision、运行端、最小复现步骤、当前 play session 日志，以及期望与实际结果。截图能补充场景和 UI 状态；涉及账号、存储或资源时，隐去身份凭据并说明测试条件。
历史说明
2026-09-05 完成两套独立教程的入口整理，并对开发系列进行本轮逐章勘误及全量编译。2026-08-23、08-26、09-03 的审查属于对应源码和环境的历史记录，已由上面的当前范围取代，不累计为本轮通过次数。
内容使用与转载边界
本教程页面没有单独授予转载、改编、商用或再许可授权。对外引用、整章转载、二次出版或把下载包纳入其它作品前，请先取得文档权利方的明确授权，并保留来源、日期和本页适用范围。