游戏叙事与剧情 / 系统课时
用脚本处理连续状态操作
用脚本处理连续状态操作
当一个剧情节点要同时修改任务、资源、关系值和下一步去向时,把操作散在多个 Passage 中会很快失控。本节用 SugarCube 2 演示把一组状态变更收进单个函数,并通过一次调用完成、验证和防重复执行。
学习目标
- 判断哪些连续状态操作应该集中到脚本函数中。
- 用 SugarCube 2 的
setup与State.variables封装一次剧情状态变更。 - 通过幂等保护避免玩家返回 Passage 时重复领取奖励。
为什么要集中连续状态更新
假设玩家完成“搜索房间”后,需要同时把搜索标记设为完成、线索数加一、声望加二,并指定下一节点。如果四个动作分别散落在正文宏、链接和后续 Passage 中,修改其中一个条件时很容易漏掉另外几个。
集中处理的目标不是“少写几行”,而是让一次剧情事件对应一次明确的状态提交。调用者只负责表达“搜索完成”,具体改哪些变量由同一个函数维护。

把状态变更封装成一个函数
以下示例以 SugarCube 2 为例。把函数放进 Twine 的 Story JavaScript,这样任意 Passage 都可以调用它;Harlowe 的变量和宏机制不同,不能直接照搬这段 API。
setup.completeSearch = function () {
const vars = State.variables;
// 防止玩家回退或再次进入 Passage 时重复结算。
if (vars.searchCompleted === true) {
return;
}
vars.searchCompleted = true;
vars.clueCount = Number(vars.clueCount || 0) + 1;
vars.reputation = Number(vars.reputation || 0) + 2;
vars.nextScene = "hallway";
};这段函数把“完成搜索”视为一个整体事件。以后即使奖励数值或跳转目标改变,也只需要改一个位置。
在 Passage 中调用并验证
在触发剧情结果的 Passage 中,只保留一次调用,再输出关键状态用于开发期验证。
<<run setup.completeSearch()>>
完成状态:搜索=<<print $searchCompleted>>,线索=<<print $clueCount>>,声望=<<print $reputation>>,下一节点=<<print $nextScene>>预期页面可见结果:
完成状态:搜索=true,线索=1,声望=2,下一节点=hallway再次进入同一 Passage 时,预期仍然是相同结果,而不是线索变成 2、声望变成 4。实际游戏中可以删除这行调试输出,只保留函数调用和剧情文本。
哪些逻辑适合放进脚本
适合集中处理的是同一次剧情事件必须一起成立的状态,例如“结算战斗”同时扣除消耗品、记录胜负、推进任务和更新关系值。它们如果只执行一半,存档就会进入难以解释的中间状态。
单纯显示一句文本、切换一个局部样式,或只赋值一次且不会复用的简单状态,不必强行包装成函数。真正值得抽取的是有多个相关更新、会被多处调用,或需要防止重复执行的操作。
脚本函数让 Passage 负责叙事,让状态更新负责规则。随着分支增多,这种边界能显著降低“改了剧情却漏改状态”的概率。