游戏叙事与剧情 / 系统课时
用循环结构实现反复事件
用循环结构实现反复事件
互动小说里的“循环”通常不是让程序在一瞬间重复执行,而是让玩家在几个 Passage 之间反复移动,并用状态变量记录已经调查、询问或尝试了多少次。本节用 SugarCube 2 实现一个可退出、会随次数变化的重复调查事件。
学习目标
- 用 Passage 回跳构造玩家可感知的剧情循环
- 用状态变量控制重复次数、文本变化和退出条件
- 避免无法退出、状态不更新等常见循环问题
把循环理解成再次进入 Passage
在互动叙事中,玩家每次点击“继续调查”,都应当得到一次新的操作机会。最自然的做法不是在一个 Passage 中使用传统的 while 循环,而是让链接再次进入调查 Passage,并在进入时更新计数器。
这样做有两个好处:玩家每次选择之间都有明确的阅读和决策机会;Twine 也可以根据当前状态决定下一次展示什么内容。循环的核心关系是“进入事件 → 更新状态 → 判断是否完成 → 返回或继续”。

用状态变量限制重复次数
下面的 SugarCube 2 示例包含初始化、房间和书桌三个完整 Passage。第一次调查只能看到表面线索,第二次调查才找到钥匙;找到后,原来的调查入口会被新的离开选项替代。
:: StoryInit
<<set $deskChecks = 0>>
<<set $foundKey = false>>
:: Room
你被锁在一间昏暗的房间里,门需要一把钥匙。
<<if $foundKey>>
你已经找到钥匙。
[[用钥匙开门->Escape]]
<<else>>
[[调查书桌->Desk]]
<</if>>
:: Desk
<<set $deskChecks += 1>>
<<if $deskChecks is 1>>
你拉开抽屉,只看到几张旧收据。抽屉底板似乎有些松动。
<<elseif $deskChecks is 2>>
你掀开松动的底板,找到了一把小钥匙。
<<set $foundKey = true>>
<<else>>
这里已经没有新的东西了。
<</if>>
<<if $foundKey>>
[[带着钥匙回到房间->Room]]
<<else>>
[[再查一次->Desk]]
[[暂时离开->Room]]
<</if>>
:: Escape
钥匙转动后,门锁弹开。你离开了房间。预期结果:首次进入书桌时只发现松动的底板;点击“再查一次”后 $deskChecks 变为 2,找到钥匙并把 $foundKey 设为 true。返回房间后,“调查书桌”消失,改为“用钥匙开门”。
第一次调查:发现抽屉底板松动
第二次调查:找到钥匙
返回房间:出现“用钥匙开门”
继续选择:进入 Escape这里的计数器承担“循环进度”,布尔变量承担“关键结果”。如果事件只关心是否发生过一次,可以只保留布尔变量;如果不同次数要产生不同反馈,则计数器更合适。
让重复行为产生变化
重复事件最容易写成机械复制:玩家连续点击五次,得到五次完全相同的文字。更好的设计是让循环状态改变文本、可选操作或成功概率,让玩家知道自己的行为正在推进事件。
常见做法包括前三次对话逐步透露信息、调查达到指定次数后出现线索、某个前置条件满足后提前跳出循环。状态变量应记录真正影响后续剧情的信息,而不是给每一次点击都创建一个永久变量。
防止循环变成死路
可重复事件至少要检查三个边界。第一,循环中必须存在退出路径,例如“暂时离开”;第二,状态必须在重新进入 Passage 时发生变化,否则终止条件永远不会满足;第三,完成事件后应关闭或替换旧入口,避免玩家继续执行已经没有意义的调查。
还要避免把传统编程里的长循环直接塞进 Passage 渲染过程。互动叙事需要把控制权交还给玩家,因此“链接回到当前 Passage 或前一个 Passage”通常比一次性执行大量循环更符合 Twine 的交互模型。
当重复调查、反复对话或多次尝试都被建模为“回到节点并携带更新后的状态”时,循环既容易阅读,也容易在后续增加条件和退出规则。