游戏叙事与剧情 / 系统课时
剧情存档到底要保存哪些状态
剧情存档到底要保存哪些状态
剧情存档不是把当前内存完整序列化,而是保存那些能够决定“玩家已经经历了什么、接下来应该从哪里继续”的最小持久状态。本课会把节点进度、剧情变量、任务状态和一次性事件拆开,建立可长期演进的存档边界。
学习目标
- 判断哪些剧情状态必须持久化,哪些运行时对象应在加载后重新构建
- 为节点、变量、任务和一次性事件设计稳定的存档数据
- 避免把缓存、UI 状态和临时引用错误写入存档
先区分事实状态与运行时状态
判断一个字段是否应该进入存档,可以问一个问题:关闭游戏并重新启动后,如果这个值丢失,会不会改变玩家已经完成的剧情事实?
通常需要持久化的内容包括当前剧情位置、影响后续分支的变量、任务进度,以及已经触发过且不能重复发生的一次性事件。对话框是否展开、当前播放到第几帧、缓存的节点对象、正在执行的协程等,只是运行时状态,加载时重新创建更可靠。

一个实用原则是:存档保存可重建运行现场所需的事实,而不是保存运行现场本身。这样可以降低存档与具体代码实现、对象生命周期之间的耦合。
四类核心状态怎样建模
节点进度至少要有稳定的节点标识,例如 chapter2.meet_guard.after_choice。不要直接保存节点对象的内存地址、数组下标或临时生成序号,因为内容调整后这些值很容易失效。
剧情变量只保存真正影响分支判断的值,例如阵营好感、是否获得证据、关键选择结果。可以采用键值结构,但变量名一旦进入正式存档,就应视为需要兼容的持久化协议。
任务状态应保存任务标识、阶段或目标进度,而不是只保存“任务面板当前显示的文本”。一次性事件则适合保存已经执行的事件 ID 集合,例如奖励发放、过场动画首播、世界物件永久移除。加载后再次遇到这些事件时,根据集合直接跳过副作用。
下面的示例把这些状态整理成独立的数据对象,同时故意不保存当前 UI、节点实例和临时缓存:
using System;
using System.Collections.Generic;
using System.Text.Json;
public sealed class NarrativeSaveData
{
public string CurrentNodeId { get; set; } = "";
public Dictionary<string, int> Variables { get; set; } = new();
public Dictionary<string, int> QuestStages { get; set; } = new();
public HashSet<string> FiredEventIds { get; set; } = new();
}
public static class Program
{
public static void Main()
{
var save = new NarrativeSaveData
{
CurrentNodeId = "chapter2.meet_guard.after_choice",
Variables = new Dictionary<string, int>
{
["guard_trust"] = 2,
["has_evidence"] = 1
},
QuestStages = new Dictionary<string, int>
{
["quest_find_witness"] = 3
},
// 这些事件已经产生过不可重复的副作用。
FiredEventIds = new HashSet<string>
{
"event_reward_guard_key",
"event_intro_cutscene"
}
};
var json = JsonSerializer.Serialize(save, new JsonSerializerOptions
{
WriteIndented = true
});
Console.WriteLine(json);
}
}预期输出
{
"CurrentNodeId": "chapter2.meet_guard.after_choice",
"Variables": {
"guard_trust": 2,
"has_evidence": 1
},
"QuestStages": {
"quest_find_witness": 3
},
"FiredEventIds": [
"event_reward_guard_key",
"event_intro_cutscene"
]
}集合元素的输出顺序不应该被业务逻辑依赖;真正需要稳定的是事件 ID 本身及其语义。
不要把派生状态重复保存
如果一个值能够稳定地从其他持久状态计算出来,通常没有必要再存一份。例如“守卫是否愿意开门”完全由 guard_trust >= 2 与 has_evidence == 1 决定,就应在加载后重新计算,而不是额外保存 can_open_gate=true。
重复保存派生状态会产生两个风险:规则更新后旧存档中的派生值可能已经不符合新规则;多个字段如果更新不同步,也会出现“变量说可以开门,但缓存布尔值说不可以”的矛盾。
为以后改剧情留下兼容空间
剧情内容上线后,节点重命名、任务拆分和变量调整都可能发生。因此稳定 ID 比显示名称更重要,例如存 quest_find_witness,不要把“寻找目击者”当作程序主键。
正式项目还应在存档根对象保存独立的存档版本,并在读取旧版本时做迁移。版本号属于整个存档协议,不应该通过猜测字段是否存在来判断格式。与此同时,删除一个剧情节点前要考虑旧存档仍可能把它作为 CurrentNodeId,应准备回退节点或迁移规则。
最终的筛选标准很简单:节点位置回答“从哪里继续”,剧情变量回答“世界已经做过哪些选择”,任务状态回答“目标推进到了哪里”,一次性事件集合回答“哪些副作用绝不能再执行”。其余能够安全重建的运行时对象,留给加载流程重新初始化。