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

把剧情事件交给游戏系统

把剧情事件交给游戏系统

剧情走到关键节点后,往往需要推进任务、播放音效、切镜头或开启玩法。不要让 Ink 直接承担这些系统职责;更稳妥的做法是让 Ink 发出“发生了什么”的事件,再由 Unity 路由给对应系统处理。

学习目标

  • 用 Ink 标签描述剧情事件,而不是在剧情脚本中耦合具体 Unity 组件
  • 在 Unity 读取当前行标签并转换成结构化事件
  • 让任务、音频、镜头和玩法系统分别响应自己关心的事件

选择事件边界而不是直接调用系统

事件最适合表达已经发生的剧情事实,例如“任务推进到找到密道”“开始 Boss 战”“播放警报音效”。Ink 只声明事实,不决定 QuestManager、AudioManager 或 Cinemachine 具体怎么实现。

对于需要随文本节点一起发生的一次性通知,标签是一种简单且透明的做法。它跟着剧情内容走,编剧可以在 .ink 文件中直接看到事件位置,Unity 侧则统一解析标签。

Ink 剧情事件交给 Unity 系统的时序

事件路由层是关键边界。没有这一层时,剧情运行器很容易逐渐长成一个同时引用任务、音频、镜头、战斗系统的“上帝类”。

在 Ink 节点上发出事件标签

下面的 Ink 片段在显示文本的同时附带事件标签。这里约定格式为 event:<name>:<payload>,名称和参数都由项目自己定义。

text
=== 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: 开头的字符串传给它。

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

预期输出:

text
quest.advance | find_secret_passage

真正接入 Ink 时,读取顺序要放在 Continue() 之后,因为 currentTags 表示刚刚生成的当前文本所附带的标签。下面是片段示例,依赖 Ink.Runtime.Story 和项目自己的 Dispatch 方法。

csharp
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 仍然保持可读、可测试的剧情脚本。

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

目录与阅读设置

阅读设置

17

记录一个想法

把剧情事件交给游戏系统

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

登录哪都通