游戏叙事与剧情 / 系统课时

用脚本处理连续状态操作

用脚本处理连续状态操作

当一个剧情节点要同时修改任务、资源、关系值和下一步去向时,把操作散在多个 Passage 中会很快失控。本节用 SugarCube 2 演示把一组状态变更收进单个函数,并通过一次调用完成、验证和防重复执行。

学习目标

  • 判断哪些连续状态操作应该集中到脚本函数中。
  • 用 SugarCube 2 的 setup 与 State.variables 封装一次剧情状态变更。
  • 通过幂等保护避免玩家返回 Passage 时重复领取奖励。

为什么要集中连续状态更新

假设玩家完成“搜索房间”后,需要同时把搜索标记设为完成、线索数加一、声望加二,并指定下一节点。如果四个动作分别散落在正文宏、链接和后续 Passage 中,修改其中一个条件时很容易漏掉另外几个。

集中处理的目标不是“少写几行”,而是让一次剧情事件对应一次明确的状态提交。调用者只负责表达“搜索完成”,具体改哪些变量由同一个函数维护。

连续状态操作集中处理流程

把状态变更封装成一个函数

以下示例以 SugarCube 2 为例。把函数放进 Twine 的 Story JavaScript,这样任意 Passage 都可以调用它;Harlowe 的变量和宏机制不同,不能直接照搬这段 API。

js
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 中,只保留一次调用,再输出关键状态用于开发期验证。

text
<<run setup.completeSearch()>>

完成状态:搜索=<<print $searchCompleted>>,线索=<<print $clueCount>>,声望=<<print $reputation>>,下一节点=<<print $nextScene>>

预期页面可见结果:

text
完成状态:搜索=true,线索=1,声望=2,下一节点=hallway

再次进入同一 Passage 时,预期仍然是相同结果,而不是线索变成 2、声望变成 4。实际游戏中可以删除这行调试输出,只保留函数调用和剧情文本。

哪些逻辑适合放进脚本

适合集中处理的是同一次剧情事件必须一起成立的状态,例如“结算战斗”同时扣除消耗品、记录胜负、推进任务和更新关系值。它们如果只执行一半,存档就会进入难以解释的中间状态。

单纯显示一句文本、切换一个局部样式,或只赋值一次且不会复用的简单状态,不必强行包装成函数。真正值得抽取的是有多个相关更新、会被多处调用,或需要防止重复执行的操作。

脚本函数让 Passage 负责叙事,让状态更新负责规则。随着分支增多,这种边界能显著降低“改了剧情却漏改状态”的概率。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用脚本处理连续状态操作

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通