游戏叙事与剧情 / 系统课时
把剧情事件交给游戏系统
把剧情事件交给游戏系统
剧情走到关键节点后,往往需要推进任务、播放音效、切镜头或开启玩法。不要让 Ink 直接承担这些系统职责;更稳妥的做法是让 Ink 发出“发生了什么”的事件,再由 Unity 路由给对应系统处理。
学习目标
- 用 Ink 标签描述剧情事件,而不是在剧情脚本中耦合具体 Unity 组件
- 在 Unity 读取当前行标签并转换成结构化事件
- 让任务、音频、镜头和玩法系统分别响应自己关心的事件
选择事件边界而不是直接调用系统
事件最适合表达已经发生的剧情事实,例如“任务推进到找到密道”“开始 Boss 战”“播放警报音效”。Ink 只声明事实,不决定 QuestManager、AudioManager 或 Cinemachine 具体怎么实现。
对于需要随文本节点一起发生的一次性通知,标签是一种简单且透明的做法。它跟着剧情内容走,编剧可以在 .ink 文件中直接看到事件位置,Unity 侧则统一解析标签。

事件路由层是关键边界。没有这一层时,剧情运行器很容易逐渐长成一个同时引用任务、音频、镜头、战斗系统的“上帝类”。
在 Ink 节点上发出事件标签
下面的 Ink 片段在显示文本的同时附带事件标签。这里约定格式为 event:<name>:<payload>,名称和参数都由项目自己定义。
=== secret_passage ===
墙后的机关发出一声闷响,密道缓缓打开。
# event:quest.advance:find_secret_passage
# event:audio.play:stone_door
# event:camera.focus:secret_passage
-> END这不是控制台程序,因此没有终端输出。预期结果是 Unity 在取得这行文本后,同时读到三个标签,并把它们分别交给任务、音频和镜头系统;玩家看到的剧情文本仍然只有“墙后的机关发出一声闷响,密道缓缓打开。”
在 Unity 中解析并分发标签
下面给出一个完整的纯 C# 解析器,可直接验证事件标签格式。Unity 集成时,InkRunner 只需要把 story.currentTags 中以 event: 开头的字符串传给它。
using System;
public readonly record struct StoryEvent(string Name, string Payload);
public static class StoryEventParser
{
public static bool TryParse(string tag, out StoryEvent storyEvent)
{
storyEvent = default;
if (string.IsNullOrWhiteSpace(tag) || !tag.StartsWith("event:", StringComparison.Ordinal))
return false;
string[] parts = tag.Split(':', 3);
if (parts.Length != 3 || string.IsNullOrWhiteSpace(parts[1]))
return false;
storyEvent = new StoryEvent(parts[1], parts[2]);
return true;
}
public static void Main()
{
string tag = "event:quest.advance:find_secret_passage";
if (TryParse(tag, out StoryEvent e))
Console.WriteLine($"{e.Name} | {e.Payload}");
}
}预期输出:
quest.advance | find_secret_passage真正接入 Ink 时,读取顺序要放在 Continue() 之后,因为 currentTags 表示刚刚生成的当前文本所附带的标签。下面是片段示例,依赖 Ink.Runtime.Story 和项目自己的 Dispatch 方法。
string line = story.Continue();
foreach (string tag in story.currentTags)
{
if (StoryEventParser.TryParse(tag, out StoryEvent storyEvent))
Dispatch(storyEvent);
}
ShowDialogue(line);预期结果:当前行先由 Ink 生成,随后同一行的事件被分发,最后文本进入对话 UI。实际项目中,音频或镜头可以立即响应,任务系统也可以更新进度;具体执行顺序应由路由层统一约定。
让路由层承担兼容和防重复
路由层至少应该做两件事。第一,校验事件名和参数,遇到未知事件时记录诊断信息,而不是让整个剧情中断。第二,区分“允许重复”的表现事件和“只能执行一次”的状态事件。
例如 audio.play 重复触发通常只是多播一次声音,而 quest.advance 如果被存档恢复、快速回放或重复进入节点再次执行,可能把任务推进两次。对于后者,应由任务系统根据任务当前阶段保证幂等,或由事件层为关键事件携带稳定 ID 并记录已处理集合。
什么时候改用 External Function
标签适合声明式、跟随剧情行发生的通知;如果 Ink 必须立即取得 Unity 计算结果并据此继续分支,例如查询动态寻路结果或实时小游戏结果,才更适合考虑 Ink 的 External Function 绑定。
两者的边界可以记成一句话:通知 Unity“发生了什么”用事件,向 Unity“询问一个结果”才考虑函数调用。 这样任务、音频、镜头和玩法系统都能独立演进,而 Ink 仍然保持可读、可测试的剧情脚本。