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

切换 Knot 与剧情入口

切换 Knot 与剧情入口

当剧情按章节、场景或任务拆成多个 Knot 后,Unity 不应靠“先把前文跑完”来进入目标内容。本节用 ChoosePathString 直接定位入口,并区分“同一 Story 内跳转”和“切换另一份 Ink 剧本”两种做法。

学习目标

  • 使用 Knot 或 Stitch 路径把 Story 的执行位置切到指定剧情入口
  • 在 Unity 中建立场景或任务到 Ink 路径的映射
  • 判断什么时候应该跳路径,什么时候应该重新创建 Story

把 Knot 当成可寻址入口

Ink 编译后会保留 Knot 和 Stitch 的路径。只要目标仍在当前这份编译后的 Story 中,就可以让 Unity 直接选择路径,而不需要从开头连续调用 Continue()。

下面的 Ink 示例提供三个可进入的 Knot:

text
=== town ===
你来到城镇广场。
-> END

=== quest_intro ===
委托人把一封密信交给了你。
-> END

=== quest_complete ===
委托人接过密信,任务完成。
-> END

在 Unity 中,story.ChoosePathString("quest_intro") 会把当前执行位置切到该 Knot。它改变的是当前 Story 的指针位置,不是加载另一份 Ink JSON。

Unity 按游戏状态选择 Ink Knot 的流程

在 Unity 中切换入口

下面脚本假设 Inspector 已绑定 Ink 编译生成的 JSON TextAsset。OpenEntry 先切到目标路径,再持续读取到不能继续为止;真实项目中通常会把每次 Continue() 的结果交给对话 UI,而不是一次性打印完。

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

预期输出:

text
委托人把一封密信交给了你。

如果路径不存在,运行时会报 Ink 路径相关错误。因此入口字符串不要散落在各个按钮和任务脚本中,最好集中映射。

用业务状态映射入口

不要让任务系统直接到处硬编码 "quest_intro"。更稳定的做法是由一个路由层根据业务状态决定 Ink 路径,例如“首次接任务”“任务完成后回报”“普通进城”分别映射到不同 Knot。

映射可以来自枚举、配置表或任务数据。关键点是:游戏系统决定进入哪个剧情语义,Ink 路径只是实现细节。这样以后重命名 Knot 时,只需修改映射层,而不是全项目搜索字符串。

什么时候需要换一份 Story

如果章节仍编译在同一个 Ink JSON 中,优先用 Knot 路径切换;这样变量、访问次数和当前 Story 状态都可以继续保留。

如果你把不同章节编译成了彼此独立的 Ink JSON,那么 ChoosePathString 无法跨 Story 跳转。此时应加载目标 TextAsset 并重新创建 Story,同时明确哪些游戏状态需要从 Unity 再写回新 Story。换句话说,Knot 负责“同一剧本内导航”,重新创建 Story 才负责“切换剧本实例”。

在项目验收时,可以分别从“普通进城、接到任务、任务完成”三个状态触发入口,确认每个状态只进入预期 Knot,且不存在为了到达目标剧情而先播放无关前文的情况。

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

目录与阅读设置

阅读设置

17

记录一个想法

切换 Knot 与剧情入口

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

登录哪都通