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

接入游戏侧状态与输入

接入游戏侧状态与输入

Ink 真正接入游戏后,脚本不能只靠自身变量推进:角色生命值、任务进度等条件来自游戏侧,而玩家点击的选项又必须回传给 Story。本节把状态注入、剧情推进、选项展示和玩家输入串成一条可验证的运行时链路。

学习目标

  • 将游戏侧状态写入 Ink 变量,并让剧情据此产生不同文本
  • 将 Ink 的当前选项暴露给游戏界面,再把玩家选择回传给 Story
  • 用明确的调用顺序验证状态、文本和输入没有脱节

交互链路应该由谁负责

游戏侧应当掌握运行循环,Ink 负责根据当前故事状态生成文本和选项。典型的一次交互是:游戏先同步条件,随后持续调用 Continue(),直到 Ink 停在选择点;界面读取 currentChoices;玩家点击后,游戏调用 ChooseChoiceIndex(),再进入下一轮推进。

游戏状态、Ink Story 与玩家输入之间的运行时交互链路

这里有两个容易混淆的边界。第一,Continue() 只负责让故事继续执行,不等于替玩家选择;第二,选项索引应来自当前 currentChoices,不能缓存旧索引后跨剧情节点复用。

准备一段依赖游戏状态的剧情

下面的 Ink 脚本声明 player_hp,游戏会在运行时覆盖它。生命值大于 50 时显示状态良好的文本,否则提示先恢复体力。

text
VAR player_hp = 0

=== start ===
{ player_hp > 50:
    你看起来状态不错。
- else:
    你需要先恢复体力。
}

+ [询问守卫]
    守卫问:“准备好了吗?”
    -> END
+ [离开]
    你暂时离开了入口。
    -> END

这段脚本需要先由 Ink 工具链编译为游戏运行时加载的 JSON。生效行为是:游戏写入不同的 player_hp 后,同一个剧情入口会输出不同的首段文本,但仍停在相同的两个选择上。

在 Unity 中连接状态、文本和选择

下面是一个最小运行时组件。它假设项目已经安装 Ink Unity Integration,并在 Inspector 中把编译后的 Ink JSON 赋给 storyJson。Begin() 负责创建 Story 和同步游戏状态,Advance() 负责消费玩家输入。

csharp
using System.Text;
using Ink.Runtime;
using UnityEngine;

public sealed class InkGameBridge : MonoBehaviour
{
    [SerializeField] private TextAsset storyJson;

    private Story story;

    public void Begin(int playerHp)
    {
        story = new Story(storyJson.text);

        // 游戏状态在剧情开始前同步,Ink 只读取这份运行时值。
        story.variablesState["player_hp"] = playerHp;
        PrintUntilChoice();
    }

    public void Advance(int choiceIndex)
    {
        if (story == null)
            throw new System.InvalidOperationException("Story 尚未初始化");

        if (choiceIndex < 0 || choiceIndex >= story.currentChoices.Count)
            throw new System.ArgumentOutOfRangeException(nameof(choiceIndex));

        // 索引必须对应当前选择点,选择完成后再继续推进故事。
        story.ChooseChoiceIndex(choiceIndex);
        PrintUntilChoice();
    }

    private void PrintUntilChoice()
    {
        var output = new StringBuilder();

        while (story.canContinue)
        {
            string text = story.Continue().Trim();
            if (text.Length > 0)
                output.AppendLine(text);
        }

        if (output.Length > 0)
            Debug.Log(output.ToString().TrimEnd());

        for (int i = 0; i < story.currentChoices.Count; i++)
            Debug.Log($"[{i}] {story.currentChoices[i].text}");
    }
}

例如游戏调用 Begin(80),随后玩家点击界面上的第一个选项并调用 Advance(0)。

预期输出:

text
你看起来状态不错。
[0] 询问守卫
[1] 离开
守卫问:“准备好了吗?”

如果改成 Begin(30),第一行应变为“你需要先恢复体力。”,而选择列表保持不变。Unity 日志前缀、时间和对象名可能因编辑器环境不同而额外出现,但剧情文本与选择顺序应一致。

处理真实游戏中的状态同步边界

不要在每次 Continue() 前无条件把所有游戏变量重新写入 Ink。这样很容易覆盖脚本刚刚修改的状态。更稳妥的做法是先确定每个变量的所有权:生命值、装备、世界时间这类权威数据通常由游戏侧维护;只服务于叙事推进的局部变量可以由 Ink 自己维护。

玩家输入也应在界面层和 Story 之间保持单向传递:界面展示当前 currentChoices,点击时只提交对应索引,随后立即重新读取新的文本和选项。不要假设选择后一定还有文本,也不要假设一定会继续出现下一个选择。

验证接入是否真的完整

至少验证三个场景:分别用高、低生命值进入同一故事,确认条件文本变化;分别选择两个选项,确认 ChooseChoiceIndex() 推进到正确分支;到达 END 后确认界面不会继续显示上一个选择点的按钮。

这条链路稳定后,游戏侧只需要维护“同步状态、展示输出、提交输入”三个职责,Ink 就可以继续专注于分支和叙事逻辑,而不会与具体 UI 实现耦合。

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

目录与阅读设置

阅读设置

17

记录一个想法

接入游戏侧状态与输入

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

登录哪都通