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

避免存档与业务状态打架

避免存档与业务状态打架

同一个剧情事实如果既存在任务系统里,又被 Yarn 变量再次独立保存,读档时就可能出现“任务已完成,但对话仍认为未完成”。解决关键不是多保存一次,而是为每类状态指定唯一事实来源,并按固定顺序恢复和投影。

学习目标

  • 识别业务状态与 Yarn 对话变量重复保存造成的冲突
  • 为任务、角色、背包和纯对话变量划分唯一事实来源
  • 按“恢复业务状态 → 投影对话变量 → 开放对话”的顺序完成读档

冲突是怎样产生的

假设任务系统保存 rescuedMayor=true,Yarn 中又有 $rescued_mayor。如果两个值都进入存档,它们就可能在不同时间点被写入:任务刚完成,业务存档已经更新,但 Yarn 变量快照还没刷新。读档时先恢复哪一份,最终结果就可能不同。

更危险的是两个系统都认为自己有权修改这个事实。任务系统根据战斗结果把它设为真,对话节点又为了剧情分支把它改回假。此时问题已经不是“加载顺序”,而是没有明确所有权。

给每类状态指定唯一事实来源

推荐把会影响多个系统的事实放在业务系统中,例如任务阶段、角色存活、背包物品、章节进度。Yarn 只读取这些状态的投影值,用于条件判断和文本分支。只有真正属于对话自身、且没有其他系统拥有的状态,才由 Yarn 变量存储独立持久化。

状态 唯一事实来源 Yarn 中的角色
任务是否完成 任务系统 只读投影
角色是否存活 角色系统 只读投影
玩家金币 经济或背包系统 只读投影
某句一次性闲聊是否看过 对话系统 可独立保存

存档恢复与 Yarn 变量投影顺序

用投影器隔离业务状态和 Yarn

下面示例让任务状态拥有 rescuedMayor,Yarn 的 $rescued_mayor 只是它的镜像。脚本只有一个可挂载的 SaveLoadCoordinator,先恢复业务对象,再把结果写入 Yarn 变量存储,不提供从 Yarn 反向覆盖任务状态的路径。

csharp
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");
    }
}

预期输出

text
[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 只消费它,而不再维护第二份可独立演化的真相。

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

目录与阅读设置

记录一个想法

避免存档与业务状态打架

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

登录哪都通