游戏叙事与剧情 / 系统课时
完成一套可维护剧情集成架构
完成一套可维护剧情集成架构
当 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。实际项目可以再把接口拆到独立程序集,便于单元测试。
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 对象。
协调器随后只处理业务流程,例如“继续读一句”“显示选项”“玩家完成选择”,而不是直接承担任务奖励、存档文件写入或按钮渲染。
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 形态或存档版本时,都能把修改限制在少数模块中。