游戏叙事与剧情 / 系统课时
验证关键状态是否按预期变化
验证关键状态是否按预期变化
Twine 的分支往往由变量驱动:玩家是否拿到道具、任务是否接受、某个角色是否信任玩家,都会改变后续链接和文本。本节建立一套可重复的状态检查方法,让“变量赋值正确”与“条件分支真的走对”同时得到验证。
学习目标
- 能为关键变量定义初始值、触发动作和期望状态。
- 能逐条验证状态更新、条件判断与任务状态转换。
- 能识别状态被重复覆盖、漏初始化和非法跳转等常见问题。
先定义可验证的状态转换
不要直接从几十个 passage 开始点。先把关键状态写成“前置状态 + 玩家动作 + 期望状态”。例如一个任务可以只有 not_started、accepted、completed 三种值,并规定只有接受任务后才能完成。

先把测试条件写清楚,再去验证 passage。这样失败时能快速判断是“赋值没有发生”“判断条件写错”,还是“玩家根本没经过负责更新状态的 passage”。
在故事中暴露临时诊断信息
下面以 SugarCube 2 为例;如果项目使用 Harlowe 或其他 Story Format,需要改成对应语法,不能混用。片段依赖三个 passage:Start、AcceptQuest、FinishQuest。
:: Start
<<set $questState = "not_started">>
当前状态:<<print $questState>>
[[接受任务->AcceptQuest]]
:: AcceptQuest
<<set $questState = "accepted">>
当前状态:<<print $questState>>
[[完成任务->FinishQuest]]
:: FinishQuest
<<if $questState is "accepted">>
<<set $questState = "completed">>
任务完成,当前状态:<<print $questState>>
<<else>>
状态异常,当前状态:<<print $questState>>
<</if>>预期页面结果
Start:当前状态 not_started
点击“接受任务”后:当前状态 accepted
点击“完成任务”后:任务完成,当前状态 completed这种临时输出应只用于测试。确认变量变化正确后,应删除或关闭诊断文本,避免调试信息进入正式剧情。
按状态表逐条走关键路径
验证时至少覆盖正常路径和一个非法路径。正常路径检查每次动作后状态是否等于预期值;非法路径则确认玩家不能绕过前置条件直接进入后续状态。
| 前置状态 | 动作 | 期望结果 |
|---|---|---|
not_started |
接受任务 | 变为 accepted |
accepted |
完成任务 | 变为 completed |
not_started |
直接尝试完成 | 不应进入 completed |
如果故事允许返回旧 passage,要额外测试“重复进入”是否会再次执行赋值。例如玩家完成任务后返回 Start,若那里无条件执行 <<set $questState = "not_started">>,状态会被错误重置。初始化代码应放在只执行一次的初始化位置,或使用明确的保护条件。
定位状态错误时按执行顺序排查
遇到条件分支不符合预期时,先确认变量是否初始化,再确认负责更新状态的 passage 是否真的被访问,然后检查赋值发生在判断之前还是之后。最后再检查是否有其他 passage 在返回、重放或加载存档时覆盖了同一个变量。
对任务、好感度、道具持有等关键变量,最好维护一张小型状态表,并给每个合法转换准备一条可复现路径。这样扩展剧情时,新分支只要破坏了既有状态约束,就能在正式接入游戏前被发现。