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

读取和修改 Ink 变量

读取和修改 Ink 变量

Ink 变量常用来保存好感度、任务标记和剧情条件,但真正的游戏状态往往还在 Unity 中。本节把两端连起来:从 Unity 读取 variablesState、写入新值,再继续推进 Story,验证后续 Ink 分支确实使用了修改后的变量。

学习目标

  • 从 Unity 读取 Ink 中已声明的变量
  • 修改变量并让后续条件分支立即使用新值
  • 避免未声明变量、类型不匹配和“修改后看不到变化”等常见问题

先在 Ink 中声明变量

Unity 能访问的全局变量应先在 Ink 中用 VAR 声明。下面用 reputation 控制 NPC 的后续态度:

text
VAR reputation = 0

=== meeting ===
{ reputation >= 10:
    NPC:我听说过你的事,请进。
- else:
    NPC:这里不欢迎陌生人。
}
-> END

这里真正决定分支的是 Story 在执行条件时看到的 reputation 值。因此 Unity 必须在推进到 meeting 并执行对应文本之前完成赋值。

Unity 与 Ink 变量影响后续分支的数据流

在 Unity 中读写 variablesState

Story.variablesState 提供按变量名访问的索引器。读取时拿到的是 object,应按 Ink 中实际声明的类型转换;写入时则直接赋 C# 的 int、float、bool 或 string 等兼容值。

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

public sealed class InkVariableDemo : MonoBehaviour
{
    [SerializeField] private TextAsset inkJsonAsset;

    private Story story;

    private void Start()
    {
        story = new Story(inkJsonAsset.text);

        int before = Convert.ToInt32(story.variablesState["reputation"]);
        Debug.Log($"Before: {before}");

        // 先同步游戏状态,再执行依赖该变量的 Ink 分支。
        story.variablesState["reputation"] = 12;

        int after = Convert.ToInt32(story.variablesState["reputation"]);
        Debug.Log($"After: {after}");

        story.ChoosePathString("meeting");

        while (story.canContinue)
        {
            string line = story.Continue().Trim();
            if (line.Length > 0)
            {
                Debug.Log(line);
            }
        }
    }
}

预期输出:

text
Before: 0
After: 12
NPC:我听说过你的事,请进。

这个结果同时验证两件事:Unity 写入成功,并且后续 Ink 条件在执行时读取到了新值。

变量同步的时机

最稳妥的规则是“进入会使用变量的剧情入口前同步”。例如玩家在 Unity 中完成任务后,把 questCompleted 写入 Ink,再跳到回报任务的 Knot;不要等 Ink 已经输出完分支文本后才修改变量,因为已经生成的内容不会被追溯重算。

反方向也一样。如果 Ink 内部通过选项修改了变量,而 Unity 需要据此发奖励或改变场景,就应在相应剧情节点之后读取变量,或使用 Ink 提供的变量观察机制监听变化。不要让 Unity 和 Ink 同时各自维护一份长期状态却没有同步规则,否则最容易出现“界面显示已完成,但剧情变量还是未完成”的分叉。

三个常见边界

类型也应保持一致。Ink 中是数值变量时,不要从 Unity 写入任意字符串;读取前先明确变量的声明类型,再做对应转换。若变量可能来自存档,还要在恢复 Story 状态后再读取,避免用新建 Story 的默认值覆盖存档值。

最后要区分“剧情变量”和“唯一真相来源”。金币、背包、角色属性这类核心游戏数据通常更适合由 Unity 的游戏状态系统持有,Ink 只在需要分支判断时接收快照;纯剧情标记则可以留在 Ink。这样既能让剧情脚本保持表达力,也能避免两个系统互相覆盖关键状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

读取和修改 Ink 变量

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

登录哪都通