游戏叙事与剧情 / 系统课时
切换 Knot 与剧情入口
切换 Knot 与剧情入口
当剧情按章节、场景或任务拆成多个 Knot 后,Unity 不应靠“先把前文跑完”来进入目标内容。本节用 ChoosePathString 直接定位入口,并区分“同一 Story 内跳转”和“切换另一份 Ink 剧本”两种做法。
学习目标
- 使用 Knot 或 Stitch 路径把 Story 的执行位置切到指定剧情入口
- 在 Unity 中建立场景或任务到 Ink 路径的映射
- 判断什么时候应该跳路径,什么时候应该重新创建
Story
把 Knot 当成可寻址入口
Ink 编译后会保留 Knot 和 Stitch 的路径。只要目标仍在当前这份编译后的 Story 中,就可以让 Unity 直接选择路径,而不需要从开头连续调用 Continue()。
下面的 Ink 示例提供三个可进入的 Knot:
=== town ===
你来到城镇广场。
-> END
=== quest_intro ===
委托人把一封密信交给了你。
-> END
=== quest_complete ===
委托人接过密信,任务完成。
-> END在 Unity 中,story.ChoosePathString("quest_intro") 会把当前执行位置切到该 Knot。它改变的是当前 Story 的指针位置,不是加载另一份 Ink JSON。

在 Unity 中切换入口
下面脚本假设 Inspector 已绑定 Ink 编译生成的 JSON TextAsset。OpenEntry 先切到目标路径,再持续读取到不能继续为止;真实项目中通常会把每次 Continue() 的结果交给对话 UI,而不是一次性打印完。
using System;
using Ink.Runtime;
using UnityEngine;
public sealed class InkEntryRouter : MonoBehaviour
{
[SerializeField] private TextAsset inkJsonAsset;
private Story story;
private void Awake()
{
story = new Story(inkJsonAsset.text);
}
public void OpenEntry(string entryPath)
{
if (string.IsNullOrWhiteSpace(entryPath))
{
throw new ArgumentException("Ink entry path cannot be empty.", nameof(entryPath));
}
// 目标路径必须存在于当前加载的 Ink Story 中。
story.ChoosePathString(entryPath);
while (story.canContinue)
{
string line = story.Continue().Trim();
if (line.Length > 0)
{
Debug.Log(line);
}
}
}
private void Start()
{
OpenEntry("quest_intro");
}
}预期输出:
委托人把一封密信交给了你。如果路径不存在,运行时会报 Ink 路径相关错误。因此入口字符串不要散落在各个按钮和任务脚本中,最好集中映射。
用业务状态映射入口
不要让任务系统直接到处硬编码 "quest_intro"。更稳定的做法是由一个路由层根据业务状态决定 Ink 路径,例如“首次接任务”“任务完成后回报”“普通进城”分别映射到不同 Knot。
映射可以来自枚举、配置表或任务数据。关键点是:游戏系统决定进入哪个剧情语义,Ink 路径只是实现细节。这样以后重命名 Knot 时,只需修改映射层,而不是全项目搜索字符串。
什么时候需要换一份 Story
如果章节仍编译在同一个 Ink JSON 中,优先用 Knot 路径切换;这样变量、访问次数和当前 Story 状态都可以继续保留。
如果你把不同章节编译成了彼此独立的 Ink JSON,那么 ChoosePathString 无法跨 Story 跳转。此时应加载目标 TextAsset 并重新创建 Story,同时明确哪些游戏状态需要从 Unity 再写回新 Story。换句话说,Knot 负责“同一剧本内导航”,重新创建 Story 才负责“切换剧本实例”。
在项目验收时,可以分别从“普通进城、接到任务、任务完成”三个状态触发入口,确认每个状态只进入预期 Knot,且不存在为了到达目标剧情而先播放无关前文的情况。