到第8章为止，我们已经看过了配置、ID、规则设计、TypeScript、UI、SFX、FX 的基本思路。
不过，这些内容分散在不同章节里时，真正动手制作时的顺序仍然不容易看清。

本章会把前面反复使用的最小循环，整理成一个名为 Checkpoint Rush 的小模式。
这里不会增加新的机制，而是把第4章到第8章的部件，按发布前的制作顺序重新排列。

0　本章要制作的内容

Checkpoint Rush 是只有下面流程的小型体验。

1. 按下大厅中央的开始按钮。
2. 隐藏入口侧的 WorldIcon，显示目的地侧的 WorldIcon。
3. 进入目的地的 AreaTrigger。
4. 防守 10 秒。
5. 只显示一次成功消息、SFX 和 FX。

本章的完成条件不是按下发布按钮。
下面 5 项都准备好，并确认到可以注册到 Portal Web Builder 之前的状态，就算完成。

本章不是“总集篇”。它是用来固定动手顺序的实践篇。

1　先把设计整理成一张表

首先，要能用短句说明这个模式。

接着，把 Godot 侧放置的对象和 TypeScript 侧调用的对象放进同一张表。

如果没有这张表就开始制作，之后一定会迷惑“500 是什么”“21 和 22 哪个是入口”。
这里直接把第4章的台账当作制作检查表来使用。

2　在 Godot 侧放置对象

在 Godot 侧，先放置游戏流程需要的对象，再考虑细节装饰。

1. 在大厅中央放置 InteractPoint，ObjId 设为 500。
2. 在入口侧放置 WorldIcon，ObjId 设为 21。
3. 在目的地稍前方放置 WorldIcon，ObjId 设为 22。
4. 在目的地放置 AreaTrigger，ObjId 设为 11。
5. 在目的地放置成功用的 FX 和 SFX，ObjId 设为 901 / 951。

具体配置步骤请使用第4章的实务流程。
本章重要的是，放置完成后一定要更新台账中的“测试结果”。

AreaTrigger 很容易因为高度不足而失败。
请给它足够的厚度，让玩家跳跃或从斜坡进入时也能触发判定。

3　TypeScript 侧的最小结构

代码不要一开始就全部塞进巨大的 Script.ts。
按照第7章的思路，分成下面 5 个文件。

ids.ts 只是把数字换成名字。

export const IP_START = 500;
export const ICON_ENTRANCE = 21;
export const ICON_TARGET = 22;
export const AREA_TARGET = 11;
export const FX_GOAL = 901;
export const SFX_GOAL = 951;

config.ts 收集之后可能调整的数字。

export const DEFEND_SECONDS = 10;
export const MESSAGE_SECONDS = 2;
export const SFX_COOLDOWN_SECONDS = 2;

Strings.json 只放画面上显示的文案。
不要把日语、中文等多字节文字直接写进代码。

{
  "start": "Go to the checkpoint.",
  "defend": "Defend for {} seconds.",
  "success": "Checkpoint secured."
}

Script.ts 只保留容易阅读的事件入口。

export function OnGameModeStarted(): void {
  game.reset();
  ui.guide(undefined, ICON_ENTRANCE);
}

export function OnPlayerInteract(player: mod.Player, interactPoint: mod.InteractPoint): void {
  const objectId = mod.GetObjId(interactPoint);

  if (game.startGate.update(game.canStart(objectId))) {
    game.markStarted();
    mod.EnableInteractPoint(interactPoint, false);
    ui.say(mod.Message(mod.stringkeys.start));
    ui.guide(ICON_ENTRANCE, ICON_TARGET);
  }
}

export async function OnPlayerEnterAreaTrigger(player: mod.Player, area: mod.AreaTrigger): Promise<void> {
  const objectId = mod.GetObjId(area);

  if (game.targetGate.update(game.canReachTarget(objectId))) {
    game.markDefending();
    ui.say(mod.Message(mod.stringkeys.defend, DEFEND_SECONDS));
    await mod.Wait(DEFEND_SECONDS);
    game.markReached();
    ui.guide(ICON_TARGET, undefined);
    ui.celebrate(FX_GOAL, SFX_GOAL);
    ui.say(mod.Message(mod.stringkeys.success));
  }
}

这段代码只是摘录出各文件职责的核心形状。
如果直接把它贴进 Script.ts，会因为缺少必要的 import 和辅助函数而无法运行。
放入实际模板时，请按照第6章和第7章的形式补上 import、modlib.ConditionState、SFX 冷却和日志输出。

4　分阶段确认动作

不要一口气检查到最后，那样反而慢。
Checkpoint Rush 按下面 3 个阶段确认。

4.1 按下按钮后 WorldIcon 会切换

只看两点。

• 开始时能看到 WorldIcon 21。
• 按下 InteractPoint 500 后，21 消失，22 出现。

如果这里失败，就不用看 FX 或防守秒数。
请先修正 ObjId、初始显示、OnPlayerInteract 的判定。

4.2 AreaTrigger 只触发一次 FX/SFX

接着进入目的地。

• 进入 AreaTrigger 11 的瞬间才有反应。
• SFX 951 不会被连续触发。
• FX 901 会作为成功演出出现。
• 如果使用循环 FX，必要时在退出时停止。

如果这里失败，请检查 AreaTrigger 的高度、ObjId，以及 ConditionState 的使用方式。

4.3 确认 10 秒防守和日志

最后确认防守计时和日志。

checkpoint:start
checkpoint:defend
checkpoint:success

如果 PortalLog.txt 中按这个顺序出现，就能读出事件流程。
如果同一行出现很多次，说明还没有阻止重复触发。
请确认应该用 startGate、targetGate、game.started、game.reached 中的哪一个来挡住。

5　注册前检查

注册到 Portal Web Builder 前，请按下面顺序在本地执行。

注册的不是开发中的 mods/Script.ts。
交给 Portal Web Builder 的是构建后的 dist/Script.ts 和 dist/Strings.json。

进入第9章之前，至少确认下面这些内容。

这张表填完后，就可以进入发布和运营的话题。

6　本章不添加的内容

如果 Checkpoint Rush 变得太大，这个实践章的作用就会变模糊。
本章不处理下面这些话题。

• 大规模招募玩家、缩略图、公告、运营日志：第9章处理。
• 官方示例的详细阅读：附录B处理。
• modlib 的函数列表和细节用法：附录C处理。

这里制作的不是华丽的成品，而是不容易坏的小型项目。
先把小循环跑通，看日志，通过注册前检查。
然后再进入第9章的发布、托管、运营。

结论

• Checkpoint Rush 是把第4〜8章的部件按制作顺序排列的小型实践项目。
• 先准备设计表和 ObjId 台账，Godot 侧和 TypeScript 侧的对应关系就不容易崩。
• 分成 ids.ts、config.ts、ui.ts、game.ts、Script.ts 后，发布前修正会轻松很多。
• lint、test、build、单人 / 双人 / 重新部署 / 中途加入检查完成后，就可以进入第9章的发布准备。

📘 下一章《发布、托管、运营》 会整理说明文、缩略图、测试会、更新步骤，让这个小模式变成可以给别人游玩的状态。