第一阶段第3周
基础场景搭建与首次发布流程
本周目标是将前两周的逻辑基础与工具操作能力整合为完整交付流程:完成基础训练场景搭建、通关交互验证、体验参数修正、首次发布与版本留档。学习重点从“单点知识”转向“完整流程执行”。
通过本周训练,将建立从工程结构整理到对外发布的标准动作,为第二阶段脚本进阶与多人玩法开发提供稳定项目框架。
3.1 场景搭建目标与最小可玩标准
第一阶段第3周要求交付“最小可玩地图”:玩家可进入、可移动、可到达终点,并获得明确反馈。
基础场景搭建不以“规模大”为目标,而以“结构清晰、逻辑完整、可稳定复现”为标准。场景至少应包含出生点、主路径、障碍区、终点触发区四个模块。每个模块必须在对象树中独立命名,便于后续脚本挂载与版本迭代。
最小可玩标准(MVP)
- 进入地图后玩家可正常落地与移动,无悬空、穿模、卡死问题。
- 路径连续可达,障碍区逻辑明确,存在失败与重试机制。
- 终点触发后显示反馈(文本或日志),完成一次闭环流程。
- 场景资源命名规范,关键对象参数可追踪。
3.2 基础场景搭建流程
分步执行
步骤1:建立工程骨架
创建 `Map_Week3`,配置 `SpawnPoint_Main`、`FinishZone`、`ObstacleGroup` 三个核心容器。
创建 `Map_Week3`,配置 `SpawnPoint_Main`、`FinishZone`、`ObstacleGroup` 三个核心容器。
步骤2:搭建路径与障碍
先完成主路径,再叠加跳台、旋转杆、坑洞等单一障碍,确保逐段可测试。
先完成主路径,再叠加跳台、旋转杆、坑洞等单一障碍,确保逐段可测试。
步骤3:设置终点交互
创建透明触发区,接入触碰事件,输出通关提示。
创建透明触发区,接入触碰事件,输出通关提示。
步骤4:统一参数校验
核对 Anchored、CanCollide、Transparency、Size、Position 等关键字段。
核对 Anchored、CanCollide、Transparency、Size、Position 等关键字段。
步骤5:Play 模式联调
从出生点完整跑图,记录问题坐标并按模块修复。
从出生点完整跑图,记录问题坐标并按模块修复。
步骤6:发布前封版
确认版本号、场景名称、封面信息与可见性设置,执行首次发布。
确认版本号、场景名称、封面信息与可见性设置,执行首次发布。
对象树建议结构
Workspace
├─ Map_Week3
│ ├─ SpawnPoint_Main
│ ├─ Path_Main
│ ├─ ObstacleGroup
│ │ ├─ JumpBlock_01
│ │ ├─ Spinner_01
│ │ └─ Pit_01
│ └─ FinishZone
└─ UI_Hint
3.3 首次发布流程与配置规范
发布流程是项目交付能力的起点。首次发布的关键是:信息完整、版本清晰、可回滚。若发布流程无规范,后续多人协作和版本迭代会产生大量追溯成本。
发布前检查清单
| 检查项 | 标准 | 结果记录 |
|---|---|---|
| 场景可通关 | 从出生点到终点一次通过 | 记录通过视频 |
| 对象命名规范 | 无 `Part(1)` 等默认命名残留 | 截图存档 |
| 关键参数正确 | Anchored/碰撞/透明度符合设计 | 参数表勾选 |
| 描述信息完整 | 标题、简介、版本号齐全 | 发布页截图 |
| 可见性策略 | 先私有测试,再按计划开放 | 权限记录 |
版本命名规则
- `v0.1.0`:第一版可玩原型(本周目标)。
- `v0.1.1`:修复关键卡点与参数错误。
- `v0.2.0`:新增机制或结构性更新。
通过版本命名可以清晰区分“修复更新”与“功能更新”,便于课程评审与回滚定位。
3.4 通关交互脚本与调试
本周脚本要求维持简单稳定:完成终点触发并反馈通关结果。脚本不追求复杂逻辑,重点是正确挂载、正确识别玩家对象、正确输出日志。
local finishZone = workspace.Map_Week3.FinishZone
finishZone.Touched:Connect(function(hit)
local character = hit.Parent
if not character then
return
end
local humanoid = character:FindFirstChild("Humanoid")
if humanoid then
print("[PASS] 玩家已到达终点")
end
end)
调试标准动作
- 先验证脚本是否执行(打印初始化日志)。
- 验证触碰对象是否正确(打印 `hit.Name`)。
- 验证角色识别是否成功(检查 `Humanoid` 是否存在)。
- 记录异常点坐标并回到对应对象参数进行修正。
3.5 本周交付要求
- 提交一张可通关基础地图(包含出生点、主路径、障碍、终点)。
- 提交对象树与关键参数截图,满足命名规范。
- 提交终点触发脚本与一次完整通关视频。
- 完成首次发布并记录版本号与发布设置。
验收口径
验收按“可运行、可复现、可维护、可发布”四项执行。任一项不满足则判定为待修复版本,不进入下一阶段。