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

用标签连接策划与程序定位

用标签连接策划与程序定位

Ink 的节点名称适合负责跳转,而标签更适合携带“当前剧情处于什么上下文”。本节用场景、任务和镜头三个维度建立标签约定,并展示宿主程序如何读取当前标签,使策划写在脚本里的上下文能被 UI、镜头系统和调试工具直接消费。

学习目标

  • 理解标签与结名称的职责差异,避免把所有上下文塞进节点名
  • 设计可被程序稳定解析的场景、任务和镜头标签
  • 通过 currentTags 验证 Ink 文本与宿主程序之间的上下文传递

标签适合描述横向上下文

结名回答“跳到哪里”,标签回答“这里属于什么”。同一段剧情可能同时属于城门场景、主线任务和近景镜头,如果把这些信息全塞进节点名,名称会很长,而且任一维度变化都会触发重命名。

标签更适合使用 key:value 形式,例如 scene:city_gate、quest:permit、shot:close_up。键名保持固定,值使用稳定标识。程序只解析自己关心的键,策划也能直接通过文本搜索定位所有相关段落。

Ink 标签从脚本传递到宿主系统的数据流

在 Ink 中写可解析标签

下面是一个最小脚本。三个标签紧跟在文本行后面,宿主程序推进到该行后,可以从当前标签中读取场景、任务和镜头信息。

text
-> scene_gate_dialogue

=== scene_gate_dialogue ===
守卫仔细检查了你的通行证。 # scene:city_gate # quest:permit # shot:close_up
+ [递交通行证]
    守卫点了点头。 # quest:permit # shot:medium
    -> END
+ [暂时离开]
    -> END

在 Ink 运行器中进入 scene_gate_dialogue 后,第一行文本会显示“守卫仔细检查了你的通行证。”,并携带三个当前标签。

预期结果

text
文本:守卫仔细检查了你的通行证。
标签:scene:city_gate, quest:permit, shot:close_up

标签本身不会自动驱动镜头或任务状态;它只是把上下文交给宿主程序。真正的业务行为应由程序按照团队约定解释,避免把“看到某个字符串就随意执行逻辑”的隐式规则散落到多个模块。

在宿主程序中读取当前标签

以下 C# 示例适用于使用 Ink Runtime 的宿主代码。它推进一次剧情,然后读取 currentTags。示例中的 Ink JSON 路径需要替换成项目实际导出的资源。

csharp
using System;
using Ink.Runtime;

public static class Program
{
    public static void Main()
    {
        var storyJson = System.IO.File.ReadAllText("story.json");
        var story = new Story(storyJson);

        string line = story.Continue().Trim();

        Console.WriteLine($"文本:{line}");
        foreach (string tag in story.currentTags)
        {
            Console.WriteLine($"标签:{tag}");
        }
    }
}

如果 story.json 由上面的 Ink 脚本导出,并从 scene_gate_dialogue 开始执行,控制台应先打印文本,再打印当前行携带的三个标签。标签顺序与脚本中的书写顺序一致;资源路径等环境差异不会改变标签值。

预期输出

text
文本:守卫仔细检查了你的通行证。
标签:scene:city_gate
标签:quest:permit
标签:shot:close_up

程序拿到标签后,可以把 scene 交给场景 UI,把 quest 交给任务追踪,把 shot 交给镜头系统。解析器最好只接受已登记的键,并对未知标签记录警告,这样拼写错误不会静默变成线上行为差异。

让标签成为团队契约

标签一旦被程序读取,就不再只是策划备注,而是跨岗位接口。建议建立一份很短的标签字典,至少写清允许的键、值的命名方式、由哪个系统消费,以及值是否允许自由扩展。

例如 shot:close_up 可以被镜头系统消费,但不应同时承担角色表情或音效语义;任务进度如果会改变存档状态,也不应只依赖展示型标签触发。标签负责描述当前上下文,真正需要持久化和分支判断的状态仍应使用 Ink 变量或宿主程序状态。

当结名负责稳定跳转、标签负责横向上下文、变量负责可变状态时,策划与程序就有了清晰分工:策划能直接在脚本中标记语义,程序能通过统一解析器定位并响应,而不必依赖脆弱的文本匹配。

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

目录与阅读设置

阅读设置

17

记录一个想法

用标签连接策划与程序定位

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

登录哪都通