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

用标签定位剧情节点

用标签定位剧情节点

当 weave 里的选择和汇合点越来越多,仅靠上下顺序很难稳定引用某个位置。Ink 可以给 choice 或 gather 添加 (label),让脚本内部能够跳转或判断节点是否访问过;而与游戏代码集成时,则应使用 knot 或 stitch 的稳定路径作为外部入口。

学习目标

  • 会给 choice 与 gather 添加可引用的 label
  • 理解 label、knot/stitch 路径与 # tag 的不同职责
  • 为后续游戏代码跳转设计稳定且可维护的剧情入口

标签解决脚本内定位

在 weave 中,普通选择和 gather 主要依赖结构位置工作。给它们写上 (label_name) 后,这个位置就获得了可引用名称,可以在 Ink 条件中测试,也可以在允许的作用域内作为 divert 目标。

例如 (ask_guard) 可以表示“玩家选择过询问守卫”,(after_check) 可以表示当前 weave 的一个明确汇合点。名称应描述剧情语义,而不是写成 choice1、point2 这类容易在重排剧情后失去意义的编号。

Ink 中局部 label、knot stitch 路径与游戏运行时入口的关系

给 choice 和 gather 命名

下面的完整 Ink 示例给两个选择以及汇合点都添加了 label,并在汇合后判断玩家是否选择过“询问守卫”。同时使用 entry stitch,为后续外部集成保留稳定路径 scene_gate.entry。

ink
=== scene_gate ===
= entry
城门已经关闭,你只能先收集一点信息。

* (ask_guard) [询问守卫]
    守卫告诉你,商队刚刚从北门离开。
* (inspect_notice) [查看告示]
    告示上写着北门将在午夜前封锁。
- (after_check)
{ ask_guard:
    守卫已经认得你,临走前又提醒了一次北门的方向。
- else:
    你没有再和守卫交谈。
}

你转身走向北门。
-> END

预期结果以选择“询问守卫”为例:

text
城门已经关闭,你只能先收集一点信息。
守卫告诉你,商队刚刚从北门离开。
守卫已经认得你,临走前又提醒了一次北门的方向。
你转身走向北门。

这里的 ask_guard 不只是给作者看的注释。Ink 会记录这个命名节点的访问情况,因此 { ask_guard: ... } 可以根据玩家是否走过该选择输出不同内容。after_check 则让汇合位置拥有明确名称,方便脚本内部引用。

外部集成使用 knot 和 stitch

label 很适合在 Ink 脚本内部组织 weave,但如果 Unity、C# 或其他宿主代码需要“直接从某个剧情入口开始”,应把外部入口设计成 knot 或 stitch。上例中的 scene_gate 是 knot,而 entry 是 stitch,因此外部可使用稳定路径 scene_gate.entry。

下面是 C# 片段示例,依赖项目已经引用 Ink Runtime,并且调用方已经加载剧情 JSON、创建好 Story story 实例。

csharp
using Ink.Runtime;

public static class StoryNavigator
{
    public static string EnterGateScene(Story story)
    {
        story.ChoosePathString("scene_gate.entry");

        return story.canContinue
            ? story.Continue().Trim()
            : string.Empty;
    }
}

预期结果是在当前剧情状态允许继续时,从 scene_gate.entry 开始读取第一段内容。以上一段 Ink 为准,第一次 Continue() 返回:

text
城门已经关闭,你只能先收集一点信息。

不要把 label 和 tag 混在一起

Ink 里还有 # tag,但它与 (label) 不是一回事。(label) 用于给剧情节点命名,以便脚本内部引用或判断访问情况;# tag 是附着在内容上的元数据,可以由宿主读取,常用于角色、表情、音效或镜头提示。

如果需求是“游戏代码要直接进入某个场景”,使用 knot/stitch 路径;如果需求是“脚本内部要判断玩家是否走过某个选择”,可以使用 label;如果需求是“这一句对白要附带演出或资源信息”,才使用 # tag。把三种职责分开,后续重构剧情时就不会因为一个名称同时承担流程、入口和元数据职责而产生隐式依赖。

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

目录与阅读设置

记录一个想法

用标签定位剧情节点

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

登录哪都通