游戏叙事与剧情 / 系统课时
保存并恢复剧情运行状态
保存并恢复剧情运行状态
保存 Ink 剧情时,不能只记住当前 knot 名称或最后一句文本,因为选项、访问次数、变量和调用栈都会影响后续执行。正确做法是保存完整 StoryState,并把它和游戏自己的存档数据一起版本化管理,恢复时重新创建 Story 后再加载状态。
学习目标
- 使用
StoryState.ToJson()保存完整 Ink 运行状态 - 使用
StoryState.LoadJson()恢复到保存时的剧情位置 - 设计存档版本与验证流程,避免脚本升级后直接读取不兼容状态
保存的是运行状态而不是位置字符串
Ink 的当前位置只是状态的一部分。玩家可能正停在一个 choice 上,也可能已经访问过某个 knot 多次;这些信息都会影响条件判断和后续路径。只保存“当前章节 ID”无法完整还原。
因此存档应保留 story.state.ToJson() 的结果。这个 JSON 由 Ink Runtime 生成和解析,游戏代码不应自行拆字段修改。游戏自己的任务、背包等数据仍保存在游戏存档中,两者通过一个外层存档对象组合。

用外层存档封装 Ink 状态
下面使用 Unity 的 JsonUtility 封装存档,其中 inkStateJson 是 Ink Runtime 生成的完整状态字符串。片段示例依赖 Unity、Ink.Runtime,并要求 Inspector 中的 TextAsset 指向当前编译后的 Ink JSON。
using System;
using Ink.Runtime;
using UnityEngine;
[Serializable]
public sealed class SaveData
{
public int saveVersion = 1;
public string inkStateJson = "";
public int coins;
}
public sealed class NarrativeSaveExample : MonoBehaviour
{
[SerializeField] private TextAsset compiledInkJson;
private Story story;
private int coins;
private void Start()
{
story = new Story(compiledInkJson.text);
}
public string CreateSave()
{
var data = new SaveData
{
inkStateJson = story.state.ToJson(),
coins = coins
};
return JsonUtility.ToJson(data);
}
public void LoadSave(string saveJson)
{
SaveData data = JsonUtility.FromJson<SaveData>(saveJson);
if (data == null || data.saveVersion != 1)
{
throw new InvalidOperationException("Unsupported save version.");
}
// 先用当前剧情资源创建 Story,再把保存的运行状态装回去。
story = new Story(compiledInkJson.text);
story.state.LoadJson(data.inkStateJson);
coins = data.coins;
}
public string GetResumeSummary()
{
return $"canContinue={story.canContinue}, choices={story.currentChoices.Count}, coins={coins}";
}
}验证方法:先推进剧情到任意稳定存档点,记录 GetResumeSummary() 与关键 Ink 变量,再调用 CreateSave();重新创建场景或组件后把同一存档传给 LoadSave(),恢复后的可继续状态、当前选项数量、关键变量和 coins 应与保存时一致。实际数值由保存点决定,不应写死。
预期结果
before: canContinue=<VALUE>, choices=<COUNT>, coins=<VALUE>
after: canContinue=<SAME_VALUE>, choices=<SAME_COUNT>, coins=<SAME_VALUE>恢复后不要重新跑初始化逻辑
恢复流程应和“新游戏初始化”分开。新游戏可以写入初始剧情变量、跳转起始 knot 或注入默认任务状态;载入存档时如果再次执行这些操作,就可能覆盖 LoadJson() 恢复出的值。
推荐的顺序是:
- 读取外层存档并校验
saveVersion。 - 使用当前编译后的 Ink JSON 创建新的
Story。 - 调用
story.state.LoadJson(savedInkStateJson)。 - 恢复游戏侧状态。
- 根据
canContinue或currentChoices刷新 UI,而不是强行跳转到某个 knot。
这样“新游戏”和“继续游戏”拥有两条明确入口,恢复逻辑不会被初始化代码污染。
给脚本升级留出版本边界
完整 StoryState 能精确恢复运行现场,但它依赖对应的故事结构。发布新版本后,如果大幅删除 knot、重命名重要路径或改变变量结构,旧存档可能无法安全恢复到同一位置。
因此外层存档应至少包含自己的 saveVersion,必要时再记录内容版本。小型项目可以在检测到不支持的旧版本时提示玩家重新开始当前章节;大型项目则需要编写显式迁移策略,而不是尝试手工修改 Ink 状态 JSON。
验证存档是否真的可恢复
存档功能不能只验证“文件写成功”。至少要覆盖三个测试点:连续文本中保存、选项界面保存、关键变量修改后保存。恢复后分别检查当前位置可继续性、选项数量和变量值是否一致。
如果你的游戏还会同步任务、背包或角色属性,再额外验证恢复后的第一帧不会把旧游戏状态推回 Ink,或把 Ink 中的镜像值错误写回全局状态。一个可靠的存档流程应能把玩家带回同一叙事现场,而不是只打开同一个场景。