给游戏增加能力

完成推球小游戏后，按实际需求选择一个专题，不必按编号顺序阅读。

先从你遇到的问题选一篇，每次完成一个可观察的结果。第一次写 Lua 请走10 课连续主线；正在排错请直接查按现象排错。

专题编号沿用能力分类，不代表必修顺序。每页开头写明前置、安装范围与可观察结果；代码另标为独立实验、完整模块、解释片段或沙盒接入片段。不要把不同专题的 main.lua 全部追加到同一个工程。

查语言、工程与对象

我现在要做什么	打开哪篇
想知道编辑器、Lua 和双端分别负责什么时	决定哪些规则交给 Lua
新增文件后不知道应该放在哪里，或遇到 require 失败时	整理脚本目录并加载模块
需要移动、旋转、改色，或分不清 table 与引擎值类型时	修改对象属性、坐标和枚举
逻辑在错误的一端执行，或需要安排每帧和计时任务时	选择运行端并理解逻辑帧
知道想做什么，但不知道从哪个 GetService 入口开始时	按需求找到 Game 服务
查找不到对象，或需要组合、挂载、移动与销毁一组对象时	找到场景对象并管理父子关系
需要响应碰撞、延后执行、重复任务或取消旧任务时	用事件和计时器组织动作

增加玩家、通信与界面能力

我现在要做什么	打开哪篇
需要把碰撞归给玩家，或给本地输入绑定动作时	识别玩家、读取输入并处理角色重生
服务端有了状态，需要让客户端显示或发出合法请求时	用请求和快照同步双端状态
要扩展 HUD、动态创建控件或管理系统 UI 时	让 EUI 显示状态并响应按钮
开始反复修改分值、时长或资源 URI，希望一处修改即可生效时	把参数和资源引用集中到配置

扩展玩法与表现

我现在要做什么	打开哪篇
推球原型完成后，需要做检测区域、探测或移动机关时	选择碰撞、触发器、射线和运动机关
需要处理角色加载、重生、位置或 NPC 外观时	取得角色并选择蛋仔或人形 NPC
要做角色状态反馈，或已准备人形 NPC 的模型和动画时	控制角色动作并播放人形动画
需要准星检测、目标标记或了解相机入口时	读取相机并用射线选择目标
已有正确的玩法判定，希望让命中与结算更容易感知时	加入声音、特效与场景氛围
要给地图生成完整模型，或区分 preset 和单个 mesh 时	加载官方预设并放进场景
官方资源不能满足外观需求，已经有自己的 Unit preset 时	加载自定义预设并处理下载失败

保存、组织与交付项目

我现在要做什么	打开哪篇
小游戏已经能正常完成一局，确实需要跨对局记录成绩时	在结算后保存最高分并查询排行
main.lua 已经承载多个功能，希望独立修改或重复初始化时	把稳定玩法拆成可清理的模块
已完成玩法，需要聊天、跨服消息、传送、社交、商品或分析服务时	按需要接入聊天、跨服和平台能力
玩法或界面与预期不同，或准备交给其他作者安装时	从现象定位问题并做回归
完成推球撞方块后，想增加一个能力或开始下一个作品时	完成小游戏后选择扩展挑战

没有专题环境时怎么继续

普通碰撞、回合、HUD 和重开都不依赖存档、交易、传送或自定义上传。平台服务需要另行确认测试地图、账号和配置，先保留接入设计，不影响完成主线。

专题页面给出的独立实验也不是每个版本都已重新实跑。兼容状态与已验证范围集中在运行与兼容说明；需要真实资产、多人或平台环境的用例只有实际通过后才能标记行为通过。