游戏叙事与剧情 / 系统课时
保存对话变量并恢复进度
保存对话变量并恢复进度
要让玩家退出后再次进入仍处于正确剧情状态,需要同时保存“影响分支的变量”和“可重新进入的剧情检查点”。本节用一个 Unity 组件把 Yarn 变量导出到存档、加载后批量恢复,并从稳定节点重新开始对话。
学习目标
- 把 Yarn 变量快照写入玩家存档并在加载时恢复
- 用稳定节点名而不是“当前播放到第几句”表示可恢复进度
- 验证加载顺序,避免旧内存状态污染新存档
保存的不是正在执行的那一帧
对话恢复通常不需要复刻退出瞬间的解释器现场。更实用的做法是在剧情设计中设置稳定检查点,例如 TownAfterGate、QuestAccepted,保存检查点节点名,再保存会影响后续条件判断的 Yarn 变量。
保存与恢复可以拆成两条路径:保存时导出变量并写入检查点;加载时先清理并恢复变量,再从检查点节点启动对话。任务、背包等外部系统也应在重新启动剧情前完成恢复。

用一个组件完成变量快照
下面示例依赖 Yarn Spinner for Unity,并在 Inspector 中绑定 VariableStorageBehaviour 与 DialogueRunner。为避免依赖第三方 JSON 库,示例把字典转换成 Unity JsonUtility 能序列化的列表,再写入 Application.persistentDataPath。
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。实际目录因平台不同而不同。
Saved dialogue state: <PATH>/dialogue-save.json
Restored dialogue state: TownAfterGate把检查点放在稳定边界
检查点应位于可以安全“重新进入”的剧情边界,例如一段对话结束后、任务状态已经提交后,或场景切换完成后。不要把节点名当作随意可改的文案标识;一旦它进入存档格式,就相当于存档协议的一部分。
如果后续版本必须重命名节点,可以在存档迁移层维护旧名到新名的映射。这样脚本重构不会直接让已有存档指向不存在的节点。
验证恢复是否真的正确
至少测试三类状态:变量为 true 的已完成分支、数值变量经过多次修改后的状态,以及字符串变量影响角色称呼或路线选择的情况。保存后彻底退出运行,再重新启动并加载,才能验证持久化,而不是误把内存中尚未清除的数据当成“恢复成功”。
还要验证一个空存档或损坏存档的路径。示例已经处理“文件不存在”,生产项目还应让统一存档系统负责 JSON 解析失败、版本不兼容和备份回退。对话层只需要保证:拿到有效快照时恢复变量,拿不到时不要强行启动一个错误的剧情节点。