游戏叙事与剧情 / 系统课时
避免变量同步覆盖错误状态
避免变量同步覆盖错误状态
Ink 与 Unity 同时保存同一份“剧情状态”时,最常见的问题不是读不到变量,而是后写入的一方把正确值覆盖掉。本课把变量分成剧情拥有、游戏拥有两类,并用明确的初始化与加载顺序避免重复初始化和错误回写。
学习目标
- 区分 Ink Story 内状态与 Unity 游戏全局状态的所有权
- 设计新游戏、读档两条不会互相覆盖的初始化路径
- 用白名单同步代替“把所有变量双向复制”的做法
先决定谁拥有变量
同步前先回答一个问题:这个值最终由谁说了算? 例如 quest_stage 表示剧情推进位置,通常应由 Ink 拥有;reputation 如果来自战斗、任务和开放世界系统,则应由 Unity 的 GameState 拥有,Ink 只读取它的镜像。
| 变量 | 权威来源 | 允许的同步方向 |
|---|---|---|
quest_stage |
Ink Story | Ink → Unity 展示或触发 |
reputation |
Unity GameState | Unity → Ink |
player_name |
Unity 玩家资料 | Unity → Ink |
不要把同一个字段长期设计成“双向都能改”。如果两边都能写,加载、切场景、重新创建 Story 或恢复存档时就很难判断哪个值更新、更可信。

重复初始化为什么会覆盖正确状态
创建新的 Story 时,Ink 会先得到脚本中声明的全局变量初值。新游戏可以在这之后把 Unity 拥有的玩家资料写入 Story;读档则应先恢复 story.state,再只补写 Unity 拥有的变量。
危险做法是每次创建 Story 后都执行同一套“初始化全部变量”。假设存档里的 quest_stage 已经是 2,读档后又把它写回默认值 0,存档本身没有坏,但恢复流程把正确状态覆盖掉了。
用两条入口分开新游戏与读档
下面示例依赖一个已经编译为 JSON 的 Ink 故事,其中声明了 quest_stage、reputation 和 player_name 三个全局变量。Ink 源文件可保持最小定义:
VAR quest_stage = 0
VAR reputation = 0
VAR player_name = ""Unity 侧只允许 reputation 和 player_name 从游戏状态写入 Ink;quest_stage 只随 Ink 自己的状态保存和恢复。
using Ink.Runtime;
using UnityEngine;
public sealed class InkStateCoordinator : MonoBehaviour
{
[SerializeField] private TextAsset compiledInkJson;
private Story story;
private sealed class GameState
{
public string PlayerName;
public int Reputation;
}
private void Start()
{
var game = new GameState
{
PlayerName = "Mira",
Reputation = 3
};
StartNewGame(game);
// 模拟剧情已经推进到阶段 2,并把完整 Ink 状态保存下来。
story.variablesState["quest_stage"] = 2;
string savedInkState = story.state.ToJson();
// 模拟游戏全局状态在别处更新,读档后它仍是权威来源。
game.Reputation = 8;
LoadGame(savedInkState, game);
int questStage = (int)story.variablesState["quest_stage"];
int reputation = (int)story.variablesState["reputation"];
Debug.Log($"quest_stage={questStage}, reputation={reputation}");
}
private void StartNewGame(GameState game)
{
story = new Story(compiledInkJson.text);
PushGameOwnedVariables(game);
}
private void LoadGame(string inkStateJson, GameState game)
{
story = new Story(compiledInkJson.text);
// 先恢复 Ink 自己的完整状态,再同步 Unity 拥有的少量变量。
story.state.LoadJson(inkStateJson);
PushGameOwnedVariables(game);
}
private void PushGameOwnedVariables(GameState game)
{
story.variablesState["player_name"] = game.PlayerName;
story.variablesState["reputation"] = game.Reputation;
// quest_stage 不在这里写入,因为它属于 Ink。
}
}预期输出:
quest_stage=2, reputation=8quest_stage 保留存档中的 2,说明读档流程没有重新初始化剧情变量;reputation 变为 8,说明 Unity 只覆盖了自己拥有的状态。
给同步边界加上白名单
工程里最稳妥的做法是把同步变量显式列出,而不是遍历 variablesState 后全部复制。新增变量时,开发者必须明确选择“由 Ink 拥有”还是“由 Unity 拥有”,同步方向也随之确定。
保存时应保存完整的 story.state.ToJson(),因为 Story 状态不只有全局变量,还包含当前位置、访问计数、调用栈等运行信息。游戏自己的存档则单独保存 GameState。恢复时先恢复各自状态,再通过白名单桥接必要字段,就能避免重复初始化和错误回写互相污染。