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

完成一套可维护剧情集成架构

完成一套可维护剧情集成架构

当 Ink 剧情逐渐接入任务、UI、游戏变量、事件和存档后,真正难维护的通常不是某个 API,而是各模块直接互相调用。本节把这些职责重新划分,让 Ink 只负责剧情推进,由统一协调层连接 Unity 系统,并给出能够继续扩展的代码结构和验收方式。

学习目标

  • 划分剧情运行时、UI、游戏状态、任务、事件和存档的职责边界
  • 用统一协调层避免 UI、任务系统和 Ink Story 互相直接依赖
  • 建立变量同步、事件分发和存档恢复的稳定数据流

先确定模块边界

一个可维护的剧情系统不应该让 DialoguePanel 直接修改任务,也不应该让任务代码直接调用 Story.ChooseChoiceIndex()。这些调用短期方便,但随着剧情增多,会迅速形成难以测试的双向依赖。

推荐把系统拆成六类职责:Ink 适配器负责推进 Story;剧情协调器组织一次对话流程;UI 只展示文本和选项;游戏状态服务持有可持久化变量;任务与业务模块通过事件接收剧情意图;存档模块保存剧情状态与游戏状态。

剧情集成架构中的职责与数据流

这套结构最重要的约束是:只有 Ink 适配器持有 Ink.Runtime.Story,只有协调器同时认识剧情运行时和外围系统。 以后替换 UI、增加任务系统或调整存档格式时,就不需要修改所有剧情调用点。

用协调器收拢剧情流程

下面是一个面向 Unity 项目的片段示例,依赖 Ink.Runtime。示例刻意把 Ink API 包在 InkStoryAdapter 中,外部只拿到普通字符串、选项和状态 JSON。实际项目可以再把接口拆到独立程序集,便于单元测试。

csharp
using System;
using System.Collections.Generic;
using Ink.Runtime;

public sealed class InkStoryAdapter
{
    private readonly Story story;

    public InkStoryAdapter(string compiledInkJson)
    {
        story = new Story(compiledInkJson);
    }

    public bool CanContinue => story.canContinue;

    public string Continue()
    {
        if (!story.canContinue)
            throw new InvalidOperationException("Story cannot continue.");

        return story.Continue().Trim();
    }

    public IReadOnlyList<Choice> GetChoices()
    {
        return story.currentChoices;
    }

    public void Choose(int choiceIndex)
    {
        if (choiceIndex < 0 || choiceIndex >= story.currentChoices.Count)
            throw new ArgumentOutOfRangeException(nameof(choiceIndex));

        story.ChooseChoiceIndex(choiceIndex);
    }

    public string SaveStoryState()
    {
        return story.state.ToJson();
    }

    public void LoadStoryState(string stateJson)
    {
        story.state.LoadJson(stateJson);
    }
}

这段代码不是完整 Unity 场景,而是适配层片段。它依赖已经编译得到的 Ink JSON,并要求项目已安装 Ink Unity Integration。验证时可在测试剧情中连续调用 Continue(),检查 GetChoices(),选择后再保存与加载状态;恢复后应回到保存时相同的剧情位置,而外围模块不需要接触 Story 对象。

协调器随后只处理业务流程,例如“继续读一句”“显示选项”“玩家完成选择”,而不是直接承担任务奖励、存档文件写入或按钮渲染。

csharp
using System;
using System.Collections.Generic;
using Ink.Runtime;

public interface IDialogueView
{
    void ShowLine(string text);
    void ShowChoices(IReadOnlyList<Choice> choices, Action<int> onSelected);
    void Close();
}

public sealed class DialogueCoordinator
{
    private readonly InkStoryAdapter story;
    private readonly IDialogueView view;

    public DialogueCoordinator(InkStoryAdapter story, IDialogueView view)
    {
        this.story = story;
        this.view = view;
    }

    public void Advance()
    {
        if (story.CanContinue)
        {
            view.ShowLine(story.Continue());
            return;
        }

        IReadOnlyList<Choice> choices = story.GetChoices();
        if (choices.Count > 0)
        {
            view.ShowChoices(choices, SelectChoice);
            return;
        }

        view.Close();
    }

    private void SelectChoice(int index)
    {
        story.Choose(index);
        Advance();
    }
}

预期行为是确定的:有正文时只显示下一句;正文耗尽但存在选项时显示选择列表;选中后继续推进;既没有正文也没有选项时关闭对话。IDialogueView 可以由 UGUI、UI Toolkit 或测试替身实现,因此剧情流程不再依赖具体按钮和文本组件。

变量、任务和事件不要混成一种机制

剧情变量适合表达“剧情当前知道什么”,例如角色是否见过玩家、某条路线是否解锁;任务系统则负责目标进度、奖励和完成条件。两者可以同步,但不应该共用同一个数据对象。

更稳定的做法是规定同步方向。例如进入剧情前,把权威游戏状态写入 Ink;剧情运行期间只收集需要回写的变量;离开剧情或到达明确提交点时,再把允许持久化的值写回游戏状态。这样可以避免 UI 刷新、自动存档和剧情推进同时修改同一个值。

剧情触发任务或场景行为时,优先发送语义事件,例如 quest.accepted、door.unlock,由业务模块订阅处理,而不是让 Ink 适配器查找某个 QuestManager 单例。事件参数还应经过白名单解析,避免剧情文本可以任意调用游戏代码。

存档必须同时考虑剧情和游戏状态

只保存 Story.state.ToJson() 并不等于完成了游戏存档。玩家在剧情中可能已经接取任务、消耗道具或修改角色关系,这些数据通常属于 Unity 游戏状态,而不是 Ink 状态。

因此一次一致的存档至少要关联两部分:Ink 状态保存当前剧情执行位置和 Ink 变量;游戏状态保存任务、背包、场景和其他业务数据。恢复时先恢复游戏状态,再创建对应的 Story 并载入 Ink 状态,最后刷新 UI。

如果项目允许在对话中途自动存档,还应把“正在播放哪段剧情”作为显式标识保存,例如稳定的剧情资源 ID,而不是仅保存场景中某个对象引用。对象引用可能随着场景重建失效,资源 ID 才适合跨会话恢复。

用故障隔离能力验收架构

架构是否可维护,不能只看文件夹是否整齐,而要看修改一个模块时会不会牵动其他模块。可以用几组变化做验收:替换对话 UI 时,Ink 适配器和任务系统不应改动;新增任务事件时,不应修改对话按钮代码;修改存档位置时,不应影响剧情推进逻辑;编写纯 C# 测试时,可以用假的 IDialogueView 验证推进与选择流程。

另外要主动测试恢复边界:在有选项时保存、选择后保存、剧情结束前保存,再分别读取。如果恢复后文本重复、选项消失或任务被重复发放,通常说明“剧情状态恢复”和“业务副作用恢复”没有被分开设计。

最终需要守住的不是某一种目录结构,而是一条依赖规则:Ink 描述剧情,适配器封装 Ink,协调器编排流程,UI 负责展示,业务系统消费明确事件,存档保存各自拥有的状态。 只要这条边界稳定,后续增加新剧情、任务类型、UI 形态或存档版本时,都能把修改限制在少数模块中。

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

目录与阅读设置

阅读设置

17

记录一个想法

完成一套可维护剧情集成架构

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

登录哪都通