游戏叙事与剧情 / 系统课时

保存 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:

csharp
string inkStateJson = story.state.ToJson();

恢复时,应先使用对应的编译后 Ink 内容创建 Story,再把之前保存的状态加载进去:

csharp
story.state.LoadJson(inkStateJson);

状态 JSON 应视为 Ink Runtime 管理的内部数据。业务存档只负责原样保存和取回,不要自行修改其中字段。

Ink Story 状态进入 Unity 存档并恢复的流程

与 Unity 存档结构结合

下面给出一个完整的保存服务。GameSaveData 除 Ink 状态外还保存场景名和存档版本,便于游戏其他系统与剧情进度一起恢复。调用方需要传入已经存在的 Story 实例。

csharp
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,预期控制台输出为:

text
Saved Ink state for scene: Town
Loaded Ink state for scene: Town

实际存档路径由 Application.persistentDataPath 决定,不同平台会不同,因此不要在业务逻辑中写死绝对路径。

正确的恢复顺序

恢复剧情时,顺序非常重要。应先加载当前版本的编译后 Ink 内容并创建新的 Story,然后再调用 story.state.LoadJson(...)。如果先让新 Story 执行了额外的 Continue()、修改变量或跳转路径,再加载旧状态,这些临时操作都会被恢复操作覆盖。

推荐的调用顺序是:

  1. 创建或取得当前版本的 Ink Story。
  2. 读取游戏存档 JSON。
  3. 取出其中的 inkStateJson。
  4. 调用 story.state.LoadJson(inkStateJson)。
  5. 恢复场景、任务 UI 等 Unity 侧状态。
  6. 根据恢复后的 story.canContinue 和 story.currentChoices 刷新剧情界面。

为内容迭代保留版本边界

剧情上线后可能重命名 knot、删除段落或调整流程。旧状态中保存的运行位置与调用栈依赖原来的编译内容,因此不能假设任意新版 Ink 都能无条件加载所有历史存档。

至少应在外层游戏存档保留 saveVersion,实际项目还可以再记录剧情内容版本。加载旧存档时先判断版本是否在当前支持范围内;如果发生破坏性剧情重构,应通过明确的迁移策略、章节重置或兼容旧内容处理,而不是修改 Ink 状态 JSON 猜测内部结构。

保存时调用 ToJson(),恢复时在兼容 Story 上调用 LoadJson(),即可把剧情运行进度作为一个完整单元交给游戏存档系统管理。这样任务、场景和 UI 可以继续使用自己的字段,而 Ink 的内部执行状态仍由 Ink Runtime 自己负责。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

保存 Story 的运行状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通