游戏叙事与剧情 / 系统课时
避免存档与业务状态打架
避免存档与业务状态打架
同一个剧情事实如果既存在任务系统里,又被 Yarn 变量再次独立保存,读档时就可能出现“任务已完成,但对话仍认为未完成”。解决关键不是多保存一次,而是为每类状态指定唯一事实来源,并按固定顺序恢复和投影。
学习目标
- 识别业务状态与 Yarn 对话变量重复保存造成的冲突
- 为任务、角色、背包和纯对话变量划分唯一事实来源
- 按“恢复业务状态 → 投影对话变量 → 开放对话”的顺序完成读档
冲突是怎样产生的
假设任务系统保存 rescuedMayor=true,Yarn 中又有 $rescued_mayor。如果两个值都进入存档,它们就可能在不同时间点被写入:任务刚完成,业务存档已经更新,但 Yarn 变量快照还没刷新。读档时先恢复哪一份,最终结果就可能不同。
更危险的是两个系统都认为自己有权修改这个事实。任务系统根据战斗结果把它设为真,对话节点又为了剧情分支把它改回假。此时问题已经不是“加载顺序”,而是没有明确所有权。
给每类状态指定唯一事实来源
推荐把会影响多个系统的事实放在业务系统中,例如任务阶段、角色存活、背包物品、章节进度。Yarn 只读取这些状态的投影值,用于条件判断和文本分支。只有真正属于对话自身、且没有其他系统拥有的状态,才由 Yarn 变量存储独立持久化。
| 状态 | 唯一事实来源 | Yarn 中的角色 |
|---|---|---|
| 任务是否完成 | 任务系统 | 只读投影 |
| 角色是否存活 | 角色系统 | 只读投影 |
| 玩家金币 | 经济或背包系统 | 只读投影 |
| 某句一次性闲聊是否看过 | 对话系统 | 可独立保存 |

用投影器隔离业务状态和 Yarn
下面示例让任务状态拥有 rescuedMayor,Yarn 的 $rescued_mayor 只是它的镜像。脚本只有一个可挂载的 SaveLoadCoordinator,先恢复业务对象,再把结果写入 Yarn 变量存储,不提供从 Yarn 反向覆盖任务状态的路径。
using UnityEngine;
using Yarn.Unity;
[System.Serializable]
public sealed class QuestSaveData
{
public bool rescuedMayor;
}
public sealed class QuestState
{
public bool RescuedMayor { get; private set; }
public void Restore(QuestSaveData data)
{
RescuedMayor = data.rescuedMayor;
Debug.Log($"[Load] Quest restored: rescuedMayor={RescuedMayor}");
}
}
public sealed class SaveLoadCoordinator : MonoBehaviour
{
[SerializeField] private VariableStorageBehaviour variableStorage;
private readonly QuestState questState = new QuestState();
public void RestoreGame(QuestSaveData saveData)
{
// 先恢复唯一事实来源。
questState.Restore(saveData);
// 再把业务结果投影到 Yarn,供条件分支读取。
variableStorage.SetValue("$rescued_mayor", questState.RescuedMayor);
Debug.Log($"[Load] Yarn projected: $rescued_mayor={questState.RescuedMayor}");
// 到这里之后,才允许玩家重新发起或恢复对话。
Debug.Log("[Load] Dialogue can start");
}
}预期输出
[Load] Quest restored: rescuedMayor=True
[Load] Yarn projected: $rescued_mayor=True
[Load] Dialogue can start把 SaveLoadCoordinator.cs 挂到加载流程对象,并在 Inspector 中给 variableStorage 绑定项目实际使用的 Yarn 变量存储组件。验证时先构造 rescuedMayor=true 的存档,再调用 RestoreGame;只有看到三条日志按上述顺序出现后,才应该开放对话交互。
恢复顺序要固定
实际项目通常不止一个业务系统。推荐统一由加载协调器控制顺序:先解析存档,再恢复任务、角色、背包等业务模块,然后一次性把这些结果投影到 Yarn,最后才允许 DialogueRunner 开始新对话或恢复剧情流程。
如果确实需要保存 Yarn 私有变量,应只保存对话系统独占的那一部分,并与业务变量使用清晰命名约定。判断标准很简单:一个事实如果会被任务、角色、经济或世界状态系统使用,它就应该由对应业务系统保存;Yarn 只消费它,而不再维护第二份可独立演化的真相。