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

保存对话变量并恢复进度

保存对话变量并恢复进度

要让玩家退出后再次进入仍处于正确剧情状态,需要同时保存“影响分支的变量”和“可重新进入的剧情检查点”。本节用一个 Unity 组件把 Yarn 变量导出到存档、加载后批量恢复,并从稳定节点重新开始对话。

学习目标

  • 把 Yarn 变量快照写入玩家存档并在加载时恢复
  • 用稳定节点名而不是“当前播放到第几句”表示可恢复进度
  • 验证加载顺序,避免旧内存状态污染新存档

保存的不是正在执行的那一帧

对话恢复通常不需要复刻退出瞬间的解释器现场。更实用的做法是在剧情设计中设置稳定检查点,例如 TownAfterGate、QuestAccepted,保存检查点节点名,再保存会影响后续条件判断的 Yarn 变量。

保存与恢复可以拆成两条路径:保存时导出变量并写入检查点;加载时先清理并恢复变量,再从检查点节点启动对话。任务、背包等外部系统也应在重新启动剧情前完成恢复。

Yarn 对话状态保存与恢复流程

用一个组件完成变量快照

下面示例依赖 Yarn Spinner for Unity,并在 Inspector 中绑定 VariableStorageBehaviour 与 DialogueRunner。为避免依赖第三方 JSON 库,示例把字典转换成 Unity JsonUtility 能序列化的列表,再写入 Application.persistentDataPath。

csharp
using System;
using System.Collections.Generic;
using System.IO;
using UnityEngine;
using Yarn.Unity;

public class DialogueSaveController : MonoBehaviour
{
    [Serializable] public class FloatEntry { public string key; public float value; }
    [Serializable] public class StringEntry { public string key; public string value; }
    [Serializable] public class BoolEntry { public string key; public bool value; }

    [Serializable]
    public class DialogueSaveData
    {
        public string resumeNode;
        public List<FloatEntry> floats = new List<FloatEntry>();
        public List<StringEntry> strings = new List<StringEntry>();
        public List<BoolEntry> bools = new List<BoolEntry>();
    }

    [SerializeField] private VariableStorageBehaviour variableStorage;
    [SerializeField] private DialogueRunner dialogueRunner;

    private string SavePath =>
        Path.Combine(Application.persistentDataPath, "dialogue-save.json");

    public void SaveAtCheckpoint(string resumeNode)
    {
        var all = variableStorage.GetAllVariables();
        var data = new DialogueSaveData { resumeNode = resumeNode };

        foreach (var pair in all.FloatVariables)
            data.floats.Add(new FloatEntry { key = pair.Key, value = pair.Value });
        foreach (var pair in all.StringVariables)
            data.strings.Add(new StringEntry { key = pair.Key, value = pair.Value });
        foreach (var pair in all.BoolVariables)
            data.bools.Add(new BoolEntry { key = pair.Key, value = pair.Value });

        File.WriteAllText(SavePath, JsonUtility.ToJson(data, true));
        Debug.Log($"Saved dialogue state: {SavePath}");
    }

    public void LoadAndResume()
    {
        if (!File.Exists(SavePath))
        {
            Debug.LogWarning("Dialogue save not found.");
            return;
        }

        var data = JsonUtility.FromJson<DialogueSaveData>(
            File.ReadAllText(SavePath));

        var floats = new Dictionary<string, float>();
        var strings = new Dictionary<string, string>();
        var bools = new Dictionary<string, bool>();

        foreach (var item in data.floats)
            floats[item.key] = item.value;
        foreach (var item in data.strings)
            strings[item.key] = item.value;
        foreach (var item in data.bools)
            bools[item.key] = item.value;

        // clear=true,避免上一局仍留在内存中的变量污染当前存档。
        variableStorage.SetAllVariables(floats, strings, bools, clear: true);

        if (!string.IsNullOrWhiteSpace(data.resumeNode))
            dialogueRunner.StartDialogue(data.resumeNode);

        Debug.Log($"Restored dialogue state: {data.resumeNode}");
    }
}

预期输出:调用 SaveAtCheckpoint("TownAfterGate") 后会在持久化目录创建 JSON;重新启动游戏并调用 LoadAndResume() 时,先恢复变量,再启动 TownAfterGate。实际目录因平台不同而不同。

text
Saved dialogue state: <PATH>/dialogue-save.json
Restored dialogue state: TownAfterGate

把检查点放在稳定边界

检查点应位于可以安全“重新进入”的剧情边界,例如一段对话结束后、任务状态已经提交后,或场景切换完成后。不要把节点名当作随意可改的文案标识;一旦它进入存档格式,就相当于存档协议的一部分。

如果后续版本必须重命名节点,可以在存档迁移层维护旧名到新名的映射。这样脚本重构不会直接让已有存档指向不存在的节点。

验证恢复是否真的正确

至少测试三类状态:变量为 true 的已完成分支、数值变量经过多次修改后的状态,以及字符串变量影响角色称呼或路线选择的情况。保存后彻底退出运行,再重新启动并加载,才能验证持久化,而不是误把内存中尚未清除的数据当成“恢复成功”。

还要验证一个空存档或损坏存档的路径。示例已经处理“文件不存在”,生产项目还应让统一存档系统负责 JSON 解析失败、版本不兼容和备份回退。对话层只需要保证:拿到有效快照时恢复变量,拿不到时不要强行启动一个错误的剧情节点。

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

目录与阅读设置

记录一个想法

保存对话变量并恢复进度

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

登录哪都通