游戏叙事与剧情 / 系统课时
检查存档与分支回放结果
检查存档与分支回放结果
互动剧情最危险的问题往往不是第一次运行失败,而是读取存档、重复进入节点或从同一存档回放不同选择后状态悄悄漂移。本节用可重复的测试方法检查分支隔离、变量恢复和重复进入结果是否一致。
学习目标
- 使用 Ink Story 状态序列化保存并恢复完整运行时进度
- 从同一选择点快照回放不同分支,确认结果互不污染
- 检查重复进入剧情节点时计数和持久变量是否符合预期
先定义需要保持一致的状态
测试不能只比较最终显示的文字,因为两个错误状态也可能恰好输出相同文本。更可靠的检查对象至少包括当前剧情位置、关键 Ink 变量以及当前选择集合。
下面的最小故事使用 has_key 表示是否拿到钥匙,用 visit_count 记录进入门厅的次数。它同时覆盖分支状态和重复进入两个容易出错的场景。
VAR has_key = false
VAR visit_count = 0
=== hub ===
~ visit_count = visit_count + 1
{ visit_count == 1:
第一次来到门厅。
- else:
再次来到门厅。
}
+ [拿钥匙]
~ has_key = true
你拿起了钥匙。
-> END
+ [离开]
你离开了门厅。
-> END这段脚本编译后,第一次进入 hub 时 visit_count 应为 1。选择“拿钥匙”后 has_key 应变成 true;选择“离开”则仍为 false。
用快照隔离不同分支
Ink 运行时可以通过 story.state.ToJson() 把当前 Story 状态序列化为字符串,并通过 story.state.LoadJson() 恢复。为了验证分支隔离,可以在出现选择时只保存一次快照,然后分别加载到两个新的 Story 实例,再选择不同分支。

关键原则是每次分支回放都从同一个未被修改的快照创建独立 Story。如果先在一个实例中跑完 A 分支,再试图把变量手工改回去测试 B 分支,很容易漏掉调用栈、访问计数或其他内部状态。
编写一组可重复的运行时检查
下面的 Unity 组件在启动时执行四项检查:保存选择点、回放“拿钥匙”、从相同快照回放“离开”、恢复拿钥匙后的存档并重新进入 hub。它依赖已编译的 Ink JSON,并需要在 Inspector 中赋给 storyJson。
using System;
using Ink.Runtime;
using UnityEngine;
public sealed class InkReplayCheck : MonoBehaviour
{
[SerializeField] private TextAsset storyJson;
private void Start()
{
Story initial = NewStory();
ContinueToChoice(initial);
AssertEqual(1, ReadInt(initial, "visit_count"), "首次进入次数");
// 在任何选择发生前保存统一基线,后面的分支都从这里恢复。
string choiceSnapshot = initial.state.ToJson();
Story takeKey = NewStory();
takeKey.state.LoadJson(choiceSnapshot);
takeKey.ChooseChoiceIndex(0);
ContinueToEnd(takeKey);
AssertEqual(true, ReadBool(takeKey, "has_key"), "拿钥匙分支");
Story leave = NewStory();
leave.state.LoadJson(choiceSnapshot);
leave.ChooseChoiceIndex(1);
ContinueToEnd(leave);
AssertEqual(false, ReadBool(leave, "has_key"), "离开分支");
// 保存已经拿到钥匙的结果,再恢复并重复进入 hub。
string savedAfterKey = takeKey.state.ToJson();
Story restored = NewStory();
restored.state.LoadJson(savedAfterKey);
AssertEqual(true, ReadBool(restored, "has_key"), "恢复后钥匙状态");
restored.ChoosePathString("hub");
ContinueToChoice(restored);
AssertEqual(2, ReadInt(restored, "visit_count"), "重复进入次数");
AssertEqual(true, ReadBool(restored, "has_key"), "重复进入后的钥匙状态");
Debug.Log("Ink replay checks passed");
}
private Story NewStory()
{
return new Story(storyJson.text);
}
private static void ContinueToChoice(Story story)
{
while (story.canContinue)
story.Continue();
if (story.currentChoices.Count == 0)
throw new InvalidOperationException("预期出现选择,但当前没有可选项");
}
private static void ContinueToEnd(Story story)
{
while (story.canContinue)
story.Continue();
}
private static bool ReadBool(Story story, string name)
{
return (bool)story.variablesState[name];
}
private static int ReadInt(Story story, string name)
{
return (int)story.variablesState[name];
}
private static void AssertEqual<T>(T expected, T actual, string label)
{
if (!Equals(expected, actual))
throw new Exception($"{label}: expected={expected}, actual={actual}");
}
}预期输出:
Ink replay checks passed只要任意状态不符合预期,组件会在到达最终日志前抛出异常,并指出失败的检查项。Unity 可能在日志中附加时间、调用栈等环境信息,实际格式可以不同。
为什么不能只保存几个剧情变量
手工保存 has_key、visit_count 之类的变量看起来简单,但 Story 的完整运行状态不只有全局变量,还包含当前位置、调用栈、选择状态等信息。要恢复“玩家当时正走到哪里”,应保存 story.state.ToJson() 的完整结果,而不是自行拼一个变量字典冒充 Ink 存档。
把边界场景加入验收
正式验收时,至少保留三类回放用例:关键选择点分别走每个重要分支;在分支结束后保存并重新加载,核对关键变量;对允许重复进入的 knot 再次调用路径跳转,确认计数、一次性奖励和已获得物品不会被意外重置。
分支测试的重点不是证明某一次剧情能跑完,而是证明相同快照能稳定复现相同状态,不同分支不会互相污染,恢复后继续推进仍与保存前的逻辑一致。做到这一点,剧情才真正具备接入游戏存档系统的条件。