游戏叙事与剧情 / 系统课时
避免状态初始化和命名混乱
避免状态初始化和命名混乱
剧情变量一多,最危险的问题往往不是条件写错,而是同一个状态在多个 Passage 被重复初始化、用不同名字表示,或在展示页面顺手修改。本节用 SugarCube 2 建立一套可执行的变量约定,让状态来源、命名和修改位置都能快速追踪。
学习目标
- 把持久剧情状态集中到唯一初始化入口。
- 用稳定命名表达对象、含义和作用域。
- 限制状态修改位置,减少重复进入剧情节点造成的副作用。
只保留一个初始化入口
SugarCube 2 提供特殊 Passage StoryInit,适合集中设置故事开始时就必须存在的变量。不要在普通剧情 Passage 中反复写“如果变量不存在就赋默认值”,因为玩家再次进入这些 Passage 时,很容易把已经推进的状态覆盖回初始值。
下面是片段示例,依赖 SugarCube 2;把这段放入名为 StoryInit 的 Passage。
<<set $playerName to "旅人">>
<<set $npcMiraFavor to 0>>
<<set $questOldMineStage to 0>>
<<set $flags to {
metMira: false,
deliveryRewarded: false,
hasMineKey: false
}>>预期结果:
故事开始后,这些变量立即存在:
$playerName = "旅人"
$npcMiraFavor = 0
$questOldMineStage = 0
$flags.metMira = false
$flags.deliveryRewarded = false
$flags.hasMineKey = false验证时可以临时在测试 Passage 输出这些变量,确认新开故事后的默认值正确。完成验证后删除调试文本,避免把内部状态暴露给正式剧情页面。
让变量名直接表达业务含义
名字要回答“谁的什么状态”,而不是只写一个模糊名词。比如 $npcMiraFavor 明确表示米拉的好感度,$questOldMineStage 明确表示旧矿井任务阶段。相比之下,$favor、$stage、$state1 在故事规模扩大后几乎无法搜索和区分。
同一类变量应保持同一种命名方式。角色关系统一使用 $npc角色名Favor,任务阶段统一使用 $quest任务名Stage,一次性开关可以集中放进 $flags。关键不是采用哪套英文,而是项目内只有一套规则,并且新变量能按规则预测出名字。
把修改动作放在真正发生事件的位置
显示状态的 Passage 应尽量只读取变量;真正发生“接任务、交付、获得钥匙、关系变化”的 Passage 才修改变量。这样排查错误时,只需要搜索少量事件节点,而不是检查每一个展示页面。
下面的片段示例展示一次性交付奖励。它依赖前面已经在 StoryInit 初始化 $npcMiraFavor、$questOldMineStage 和 $flags.deliveryRewarded。
:: 完成交付
<<if !$flags.deliveryRewarded>>
<<set $npcMiraFavor += 2>>
<<set $questOldMineStage to 2>>
<<set $flags.deliveryRewarded to true>>
<</if>>
你把调查记录交给了米拉。
[[返回任务面板->任务面板]]
:: 任务面板
旧矿井任务阶段:$questOldMineStage
米拉好感度:$npcMiraFavor预期结果:
第一次进入“完成交付”:
任务阶段变为 2,好感度增加 2。
再次进入“完成交付”:
任务阶段仍为 2,好感度不再重复增加。
进入“任务面板”:
只显示状态,不修改任何变量。把“写状态”和“读状态”分开后,重新进入任务面板不会产生副作用,回退到旧 Passage 也更容易判断哪些节点可能再次触发修改。

发现混乱时怎么整理
如果项目已经出现大量状态变量,先不要边写新剧情边重构。先搜索所有赋值位置,把同义变量合并成一个名字,再把默认值移到 StoryInit,最后检查每个修改点是否真的对应一个玩家行为或剧情事件。
重构完成后,新开故事验证默认值,再按主要任务路径走一遍,确认阶段不会倒退、一次性奖励不会重复、展示 Passage 不会修改状态。变量命名是否漂亮是次要的,最重要的是任何一个状态都能回答三个问题:在哪里初始化、在哪里修改、在哪里读取。