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

新旧存档遇到变量变化怎么办

新旧存档遇到变量变化怎么办

剧情上线后继续改 Ink 变量是常态:会新增字段、调整默认值,甚至重命名旧变量。真正危险的不是“多了一个变量”,而是旧存档携带的状态语义与新脚本不再一致。本节用版本化存档和加载后迁移,把兼容逻辑放在你能控制的边界上,而不是直接修改 Ink 的内部状态 JSON。

学习目标

  • 区分新增变量、重命名变量和类型变化的兼容风险
  • 给存档增加版本号,并在 LoadJson() 后执行明确的迁移
  • 知道哪些改动可以补默认值,哪些改动必须做显式数据转换

先按变化类型判断风险

只新增变量时,风险最低。新版本 Ink 中先声明变量,再对旧存档按版本补一个确定的默认值即可。这样兼容行为不依赖旧状态里是否恰好存在该键。

重命名变量和类型变化风险更高。旧存档里的 reputation 不会自动知道它现在叫 trust;一个原来是整数的变量改成字符串,也需要你定义转换规则。对这两类变化,应把“旧语义如何映射到新语义”写成迁移代码。

Ink 变量变更时的存档兼容决策

给存档外壳加版本号

不要直接解析、增删 Ink StoryState JSON 内部字段。它是运行时实现细节,结构可能随 Ink Runtime 演进。更稳妥的方式是在外面包一层你自己的存档对象,记录 saveVersion 和必要的兼容字段。

下面示例假设 v1 使用 reputation,v2 的 Ink 脚本改为 trust,同时新增 has_map。旧版在保存时把关键业务值镜像到了外壳字段 reputation,因此新版本能够明确迁移。

csharp
using System;
using Ink.Runtime;
using UnityEngine;

public sealed class InkSaveMigrator : MonoBehaviour
{
    [Serializable]
    private sealed class SaveEnvelope
    {
        public int saveVersion;
        public string inkStateJson;

        // v1 遗留字段:在仍支持 v1 存档期间保留,只用于迁移。
        public int reputation;
    }

    [SerializeField] private TextAsset currentInkJson;

    public Story LoadCompatibleStory(string saveJson)
    {
        SaveEnvelope save = JsonUtility.FromJson<SaveEnvelope>(saveJson);
        if (save == null || string.IsNullOrEmpty(save.inkStateJson))
            throw new InvalidOperationException("无效存档:缺少 inkStateJson");

        Story story = new Story(currentInkJson.text);
        story.state.LoadJson(save.inkStateJson);

        ApplyPostLoadMigration(story, save);
        Debug.Log($"Save migrated: v{save.saveVersion} -> current");

        return story;
    }

    private static void ApplyPostLoadMigration(Story story, SaveEnvelope save)
    {
        if (save.saveVersion < 2)
        {
            // 新脚本必须已经声明 VAR trust 和 VAR has_map。
            story.variablesState["trust"] = save.reputation;
            story.variablesState["has_map"] = false;
        }
    }
}

预期输出:加载一个 saveVersion 为 1 的旧存档后,控制台会输出迁移记录;trust 得到旧 reputation 的值,has_map 被补成 false。

text
Save migrated: v1 -> current

如果旧版本没有在外壳中保存 reputation,就不要为了“兼容”去猜值。更可靠的做法是保留一个能读取旧存档的中间版本,或在发布重命名前先把关键值写入稳定的业务存档字段。

默认值要表达业务含义

新增变量的默认值不能只考虑“代码不报错”,还要考虑旧玩家的剧情语义。例如新版本增加 has_map,如果旧玩家在历史章节中已经必然拿到地图,那么统一补 false 会让剧情倒退。

这时迁移条件应该来自已有业务状态,例如章节完成标记、任务进度或道具表,而不是简单写死。默认值是“无法从历史事实推导时的兜底”,迁移规则才是旧数据到新语义的正式映射。

类型变化必须显式转换

把整数直接改成字符串、把单值改成枚举语义,都会让旧值的解释发生变化。迁移时应先读取旧格式,校验范围,再写入新变量;无法转换时要有清晰策略,例如回退默认值、标记存档需要修复,或拒绝继续加载。

不要把所有迁移永久堆在一个 if 中。项目持续迭代时,应按版本顺序执行 v1→v2、v2→v3 的小迁移,并在最低支持版本提升后删除已经不再需要的旧字段和代码。这样每次变化都只有一个明确责任,回归测试也更容易定位。

用旧存档做回归测试

兼容性不能只测试“新版本新建存档”。发布前至少准备一份每个受支持版本的真实存档,加载后验证关键变量、当前选项和对应游戏状态。

对于变量重命名,验收标准不是“能加载”,而是迁移后的新变量值与旧剧情语义一致;对于新增变量,验收默认值不会把旧玩家送进错误分支。只要这些检查进入自动化或固定发布清单,内容团队就可以继续迭代 Ink,而不必把变量名永久冻结。

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

目录与阅读设置

阅读设置

17

记录一个想法

新旧存档遇到变量变化怎么办

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

登录哪都通