游戏叙事与剧情 / 系统课时
保存 Story 的运行状态
保存 Story 的运行状态
只保存任务 ID 或当前 knot,无法完整恢复 Ink 已执行的变量、访问次数、调用栈和当前位置。Ink Runtime 已提供 Story 状态的 JSON 序列化能力,本节把它封装进 Unity 存档结构,并完成保存、重新创建 Story、加载状态这一条完整恢复链路。
学习目标
- 使用
story.state.ToJson()获取当前 Ink 运行状态 - 将 Ink 状态作为一个字段并入 Unity 游戏存档
- 在重新创建 Story 后使用
LoadJson()恢复剧情进度
不要自己拆解剧情状态
Ink 的运行状态不只是几个全局变量。剧情执行过程中还存在当前位置、访问计数、调用栈以及其他运行时数据。如果只手动保存 variablesState,恢复后可能出现条件正确但剧情位置错误的问题。
Ink Runtime 提供的标准做法是把 Story.state 整体序列化为 JSON:
string inkStateJson = story.state.ToJson();恢复时,应先使用对应的编译后 Ink 内容创建 Story,再把之前保存的状态加载进去:
story.state.LoadJson(inkStateJson);状态 JSON 应视为 Ink Runtime 管理的内部数据。业务存档只负责原样保存和取回,不要自行修改其中字段。

与 Unity 存档结构结合
下面给出一个完整的保存服务。GameSaveData 除 Ink 状态外还保存场景名和存档版本,便于游戏其他系统与剧情进度一起恢复。调用方需要传入已经存在的 Story 实例。
using System;
using System.IO;
using Ink.Runtime;
using UnityEngine;
[Serializable]
public sealed class GameSaveData
{
public int saveVersion = 1;
public string sceneName;
public string inkStateJson;
}
public static class InkSaveService
{
private const string FileName = "save.json";
public static void Save(Story story, string sceneName)
{
if (story == null)
throw new ArgumentNullException(nameof(story));
var data = new GameSaveData
{
sceneName = sceneName,
inkStateJson = story.state.ToJson()
};
string path = GetSavePath();
string json = JsonUtility.ToJson(data, true);
File.WriteAllText(path, json);
Debug.Log($"Saved Ink state for scene: {sceneName}");
}
public static GameSaveData Load(Story story)
{
if (story == null)
throw new ArgumentNullException(nameof(story));
string path = GetSavePath();
if (!File.Exists(path))
throw new FileNotFoundException("Save file does not exist.", path);
string json = File.ReadAllText(path);
var data = JsonUtility.FromJson<GameSaveData>(json);
if (data == null || string.IsNullOrEmpty(data.inkStateJson))
throw new InvalidDataException("Save file has no Ink state.");
// Story 必须先由兼容的 Ink 内容创建,再恢复运行状态。
story.state.LoadJson(data.inkStateJson);
Debug.Log($"Loaded Ink state for scene: {data.sceneName}");
return data;
}
private static string GetSavePath()
{
return Path.Combine(Application.persistentDataPath, FileName);
}
}假设保存时场景名为 Town,随后用同一份兼容 Ink 内容重新创建 Story 并调用 Load,预期控制台输出为:
Saved Ink state for scene: Town
Loaded Ink state for scene: Town实际存档路径由 Application.persistentDataPath 决定,不同平台会不同,因此不要在业务逻辑中写死绝对路径。
正确的恢复顺序
恢复剧情时,顺序非常重要。应先加载当前版本的编译后 Ink 内容并创建新的 Story,然后再调用 story.state.LoadJson(...)。如果先让新 Story 执行了额外的 Continue()、修改变量或跳转路径,再加载旧状态,这些临时操作都会被恢复操作覆盖。
推荐的调用顺序是:
- 创建或取得当前版本的 Ink Story。
- 读取游戏存档 JSON。
- 取出其中的
inkStateJson。 - 调用
story.state.LoadJson(inkStateJson)。 - 恢复场景、任务 UI 等 Unity 侧状态。
- 根据恢复后的
story.canContinue和story.currentChoices刷新剧情界面。
为内容迭代保留版本边界
剧情上线后可能重命名 knot、删除段落或调整流程。旧状态中保存的运行位置与调用栈依赖原来的编译内容,因此不能假设任意新版 Ink 都能无条件加载所有历史存档。
至少应在外层游戏存档保留 saveVersion,实际项目还可以再记录剧情内容版本。加载旧存档时先判断版本是否在当前支持范围内;如果发生破坏性剧情重构,应通过明确的迁移策略、章节重置或兼容旧内容处理,而不是修改 Ink 状态 JSON 猜测内部结构。
保存时调用 ToJson(),恢复时在兼容 Story 上调用 LoadJson(),即可把剧情运行进度作为一个完整单元交给游戏存档系统管理。这样任务、场景和 UI 可以继续使用自己的字段,而 Ink 的内部执行状态仍由 Ink Runtime 自己负责。