游戏叙事与剧情 / 系统课时
读取和修改 Ink 变量
读取和修改 Ink 变量
Ink 变量常用来保存好感度、任务标记和剧情条件,但真正的游戏状态往往还在 Unity 中。本节把两端连起来:从 Unity 读取 variablesState、写入新值,再继续推进 Story,验证后续 Ink 分支确实使用了修改后的变量。
学习目标
- 从 Unity 读取 Ink 中已声明的变量
- 修改变量并让后续条件分支立即使用新值
- 避免未声明变量、类型不匹配和“修改后看不到变化”等常见问题
先在 Ink 中声明变量
Unity 能访问的全局变量应先在 Ink 中用 VAR 声明。下面用 reputation 控制 NPC 的后续态度:
VAR reputation = 0
=== meeting ===
{ reputation >= 10:
NPC:我听说过你的事,请进。
- else:
NPC:这里不欢迎陌生人。
}
-> END这里真正决定分支的是 Story 在执行条件时看到的 reputation 值。因此 Unity 必须在推进到 meeting 并执行对应文本之前完成赋值。

在 Unity 中读写 variablesState
Story.variablesState 提供按变量名访问的索引器。读取时拿到的是 object,应按 Ink 中实际声明的类型转换;写入时则直接赋 C# 的 int、float、bool 或 string 等兼容值。
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);
}
}
}
}预期输出:
Before: 0
After: 12
NPC:我听说过你的事,请进。这个结果同时验证两件事:Unity 写入成功,并且后续 Ink 条件在执行时读取到了新值。
变量同步的时机
最稳妥的规则是“进入会使用变量的剧情入口前同步”。例如玩家在 Unity 中完成任务后,把 questCompleted 写入 Ink,再跳到回报任务的 Knot;不要等 Ink 已经输出完分支文本后才修改变量,因为已经生成的内容不会被追溯重算。
反方向也一样。如果 Ink 内部通过选项修改了变量,而 Unity 需要据此发奖励或改变场景,就应在相应剧情节点之后读取变量,或使用 Ink 提供的变量观察机制监听变化。不要让 Unity 和 Ink 同时各自维护一份长期状态却没有同步规则,否则最容易出现“界面显示已完成,但剧情变量还是未完成”的分叉。
三个常见边界
类型也应保持一致。Ink 中是数值变量时,不要从 Unity 写入任意字符串;读取前先明确变量的声明类型,再做对应转换。若变量可能来自存档,还要在恢复 Story 状态后再读取,避免用新建 Story 的默认值覆盖存档值。
最后要区分“剧情变量”和“唯一真相来源”。金币、背包、角色属性这类核心游戏数据通常更适合由 Unity 的游戏状态系统持有,Ink 只在需要分支判断时接收快照;纯剧情标记则可以留在 Ink。这样既能让剧情脚本保持表达力,也能避免两个系统互相覆盖关键状态。