游戏叙事与剧情 / 系统课时
避免分支脚本越写越乱
避免分支脚本越写越乱
多分支剧情最容易失控的原因,不是条件语法复杂,而是一个节点同时负责选项、状态判断、长段对白和多次跳转。这里会把这些职责拆开,用“小节点 + 清晰条件 + 汇合跳转”整理 Yarn Spinner 脚本。
学习目标
- 识别应该拆分的条件、对白和跳转职责
- 用复用节点减少重复对白和重复条件
- 建立可阅读、可测试的跳转结构,避免分支形成迷宫
先拆掉巨型节点
一个节点如果同时包含多个选择、嵌套条件和大量重复对白,修改一个条件时很容易影响别的路径。更稳妥的结构是让节点各自承担单一职责:入口节点负责分流,结果节点负责一类对白,共享节点负责公共内容。
例如“守卫是否放行”可以拆成三个层次:Gate 判断条件,GateAllowed 与 GateDenied 分别负责结果,最后都跳到需要继续的节点。这样每个节点的目的从标题就能看懂。

下面是一种可维护的片段示例,假设 $hasPass 已由游戏代码或前置节点设置:
title: Gate
---
<<if $hasPass>>
<<jump GateAllowed>>
<<else>>
<<jump GateDenied>>
<<endif>>
===
title: GateAllowed
---
Guard: 通行证有效,你可以进去。
<<jump TownSquare>>
===
title: GateDenied
---
Guard: 没有通行证,我不能让你进去。
<<jump OutsideGate>>
===
title: TownSquare
---
Narrator: 你穿过城门,来到广场。
===
title: OutsideGate
---
Narrator: 你仍然站在城门外。
===预期结果:
当 $hasPass 为 true:
Guard: 通行证有效,你可以进去。
Narrator: 你穿过城门,来到广场。
当 $hasPass 为 false:
Guard: 没有通行证,我不能让你进去。
Narrator: 你仍然站在城门外。这段脚本没有嵌套多层对白。条件只决定“去哪里”,真正的内容放在目标节点里,因此后续新增放行理由或拒绝理由时,不需要继续把 Gate 节点拉长。
把公共内容提取成复用节点
分支多起来后,最常见的重复是“不同路径最后都说同一段话”。不要把这段话复制到每个分支,否则以后改一句台词,要同步修改多个位置。
例如多个选择最后都需要进入任务说明,可以把公共内容放进独立节点,再统一跳过去。片段示例,假设前面的分支已经决定是否允许继续:
title: ExplainMission
---
Captain: 不管你从哪条路来到这里,接下来都要先调查旧码头。
<<jump MissionChoice>>
===
title: MissionChoice
---
-> 立即出发
Captain: 好,注意安全。
-> 先准备一下
Captain: 我会在这里等你。
===预期结果:
进入 ExplainMission 后,两条上游路径都会先看到同一段任务说明,
随后在 MissionChoice 中选择“立即出发”或“先准备一下”。复用节点适合放公共说明、固定过场和共享任务入口。它不适合承载与某条分支强绑定的状态修改,否则其他路径复用时可能意外改变变量。
控制条件和跳转的复杂度
当一个 if 里又套多个 if,再夹着选项和 jump,阅读成本会迅速上升。可以用两个原则降低复杂度:条件只做分流,状态修改尽量靠近产生它的选项。
例如玩家在选项中答应任务,就在那里设置 $acceptedQuest = true;后面的节点只读取这个状态,而不是重新推导“玩家之前到底选了哪句话”。这能减少隐式依赖,也让存档恢复后的状态更可靠。
用固定规则整理跳转关系
多人协作或长剧情中,建议约定稳定的节点职责和跳转方向。例如入口节点只判断,结果节点只播放对应对白,公共节点负责汇合,只有少数节点修改关键变量。
检查一段复杂脚本时,可以从任意节点开始,连续跟随 jump,确认每次跳转的目标名称都准确、不会误入不相关剧情,也不会形成没有出口的循环。随后分别设置关键变量的典型值,验证每个条件分支都至少能命中一次。
当脚本被拆成“分流节点、结果节点、公共节点”后,阅读者不需要一次追踪所有对白和条件。每次只理解一个节点的职责,再沿跳转关系查看下一步,分支规模扩大后仍然能定位、修改和测试。