游戏叙事与剧情 / 系统课时
把重复对白抽成可复用片段
把重复对白抽成可复用片段
当多个剧情节点反复出现同一句提示、同一段对白或相同的条件文本时,直接复制会让后续修改变得危险。本节以 SugarCube 2 为例,把重复内容集中到共享 Passage 或 Widget 中,让场景只保留“在哪里使用”,而不是保存多份相同文本。
学习目标
- 判断哪些重复内容适合抽成共享 Passage,哪些更适合做成带参数的 Widget
- 使用
<<include>>与<<widget>>减少重复对白和重复逻辑 - 避免可复用片段偷偷修改剧情状态,降低后续维护风险
先确认什么值得抽取
重复不等于一定要抽象。只出现两次、但语义明显不同的对白,强行复用反而会让剧情难读。真正值得集中管理的,通常是会在多个 Passage 中保持同一含义、以后也需要一起修改的内容。
| 重复内容 | 更合适的结构 | 原因 |
|---|---|---|
| 完全相同的提示或对白 | 共享 Passage + <<include>> |
最直接,正文仍然容易阅读 |
| 结构相同但角色、文本不同 | <<widget>> |
可以通过参数复用结构 |
| 只在一个场景出现的短句 | 保留在原 Passage | 抽取后只会增加跳转成本 |
本节示例使用 SugarCube 2。Harlowe 与 SugarCube 的宏语法不同,不能直接复制这些宏。
用共享 Passage 收起完全重复的对白
假设庭院、岗亭和城门三个场景都要显示同一条守卫警告。最简单的做法是新建一个名为 GuardWarning 的 Passage,把唯一版本的对白放进去,然后在需要的位置引用它。
GuardWarning Passage 内容如下。它只是普通文本,不负责跳转,也不修改状态。
守卫压低声音:“钟响三次后,东门会封锁。”在 Courtyard Passage 中,只保留当前场景自己的内容,并通过 <<include>> 插入共享对白。
你在庭院里拦住巡逻的守卫。
<<include "GuardWarning">>
[[前往东门->EastGate]]预期结果
你在庭院里拦住巡逻的守卫。
守卫压低声音:“钟响三次后,东门会封锁。”
前往东门以后警告内容发生变化,只改 GuardWarning 一处即可。其他场景仍然引用同一个 Passage,不需要逐个搜索和替换。

需要参数时再升级为 Widget
如果重复的是“对白结构”,而角色名和内容会变化,就不适合为每句话创建一个共享 Passage。SugarCube 的 Widget 可以把变化部分作为参数传入。
先新建一个 Passage,例如 ReusableWidgets,给它添加 widget 标签,并写入下面的定义。Widget 应放在带 widget 标签的 Passage 中,让 SugarCube 在启动时加载。
<<widget "warningLine">>
<<print _args[0]>>压低声音:“<<print _args[1]>>”
<</widget>>然后在任意普通 Passage 中调用它。
<<warningLine "守卫" "钟响三次后,东门会封锁。">>
<<warningLine "船夫" "涨潮前必须离开码头。">>预期结果
守卫压低声音:“钟响三次后,东门会封锁。”
船夫压低声音:“涨潮前必须离开码头。”这里 _args[0] 是第一个参数,_args[1] 是第二个参数。参数顺序一旦成为约定,就不要在不同场景里交换含义,否则复用结构会变得比复制文本更难维护。
让复用片段保持低副作用
共享内容最好只负责“显示什么”,不要顺手改变关键剧情变量。例如把 <<set $doorOpen = true>> 藏进一段常用对白后,每次 <<include>> 都会再次执行赋值,调用者很难从表面看出状态为何变化。
一个实用边界是:完全相同的内容先用共享 Passage;需要传入少量变化值时用 Widget;只有当复用结构真的稳定时再继续抽象。这样既能减少重复,又不会把剧情拆成难以追踪的碎片。