游戏叙事与剧情 / 系统课时
用标签定位剧情节点
用标签定位剧情节点
当 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 这类容易在重排剧情后失去意义的编号。

给 choice 和 gather 命名
下面的完整 Ink 示例给两个选择以及汇合点都添加了 label,并在汇合后判断玩家是否选择过“询问守卫”。同时使用 entry stitch,为后续外部集成保留稳定路径 scene_gate.entry。
=== scene_gate ===
= entry
城门已经关闭,你只能先收集一点信息。
* (ask_guard) [询问守卫]
守卫告诉你,商队刚刚从北门离开。
* (inspect_notice) [查看告示]
告示上写着北门将在午夜前封锁。
- (after_check)
{ ask_guard:
守卫已经认得你,临走前又提醒了一次北门的方向。
- else:
你没有再和守卫交谈。
}
你转身走向北门。
-> END预期结果以选择“询问守卫”为例:
城门已经关闭,你只能先收集一点信息。
守卫告诉你,商队刚刚从北门离开。
守卫已经认得你,临走前又提醒了一次北门的方向。
你转身走向北门。这里的 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 实例。
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() 返回:
城门已经关闭,你只能先收集一点信息。不要把 label 和 tag 混在一起
Ink 里还有 # tag,但它与 (label) 不是一回事。(label) 用于给剧情节点命名,以便脚本内部引用或判断访问情况;# tag 是附着在内容上的元数据,可以由宿主读取,常用于角色、表情、音效或镜头提示。
如果需求是“游戏代码要直接进入某个场景”,使用 knot/stitch 路径;如果需求是“脚本内部要判断玩家是否走过某个选择”,可以使用 label;如果需求是“这一句对白要附带演出或资源信息”,才使用 # tag。把三种职责分开,后续重构剧情时就不会因为一个名称同时承担流程、入口和元数据职责而产生隐式依赖。