游戏叙事与剧情 / 系统课时
存档恢复后剧情突然跳转
存档恢复后剧情突然跳转
剧情恢复后直接跳到后面的节点,通常不是“存档坏了”这么简单,而是 Ink 的 Story 状态、Unity 自己的游戏数据和恢复后的第一次推进顺序不一致。定位重点是先明确保存了哪些状态,再保证恢复期间没有提前 Continue() 或二次覆盖关键变量。
学习目标
- 能区分 Ink Story 状态与 Unity 外部游戏数据各自负责的内容。
- 能按正确顺序恢复外部函数、Story 状态和游戏侧数据。
- 能通过恢复前后快照与日志定位“多推进一次”或“恢复后覆盖”的问题。
先把存档拆成两类状态
一个可靠的剧情存档通常至少包含两部分:story.state.ToJson() 生成的 Ink 状态,以及金币、任务、角色属性等由 Unity 业务系统维护的外部数据。前者保存 Ink 的当前指针、变量和调用栈等运行状态;后者是否进入 Ink,取决于你的同步设计。
问题往往出在恢复时把这两类状态混在一起。例如,先 LoadJson() 恢复了 Ink 中的 coins=30,随后 Unity 又把默认角色数据 coins=0 写回 Story,下一次条件判断就会进入完全不同的路径。

固定恢复顺序
推荐把恢复过程写成一个封闭事务:恢复完成前,任何 UI 刷新、自动播放协程或“进入场景即继续剧情”的逻辑都不能调用 Continue()。
下面是片段示例,依赖项目已安装 Ink Unity Integration,save.inkStateJson 来自之前同一份已编译剧情内容的 story.state.ToJson(),save.coins 是 Unity 侧持久化数据。示例假设游戏侧金币是权威来源,所以在加载 Ink 状态后再同步一次金币。
using Ink.Runtime;
using UnityEngine;
public sealed class StoryRestoreController : MonoBehaviour
{
[SerializeField] private TextAsset inkJson;
private Story story;
private int coins;
private bool restoreCompleted;
public void Restore(SaveData save)
{
restoreCompleted = false;
story = new Story(inkJson.text);
BindExternalFunctions();
Debug.Log("restore: externals-bound");
story.state.LoadJson(save.inkStateJson);
Debug.Log("restore: ink-loaded");
coins = save.coins;
Debug.Log("restore: game-data-loaded");
// 本项目约定金币由游戏系统负责,因此恢复后再同步进 Ink。
story.variablesState["coins"] = coins;
Debug.Log("restore: reconciled");
restoreCompleted = true;
}
public void ContinueOnce()
{
if (!restoreCompleted || !story.canContinue)
{
return;
}
Debug.Log(story.Continue().Trim());
}
private void BindExternalFunctions()
{
// 在真实项目中这里绑定可能被后续剧情调用的 External Function。
}
[System.Serializable]
public sealed class SaveData
{
public string inkStateJson;
public int coins;
}
}调用 Restore(save) 时,预期日志顺序为:
restore: externals-bound
restore: ink-loaded
restore: game-data-loaded
restore: reconciled此时不会自动打印剧情文本;只有之后显式调用 ContinueOnce() 才推进一次。这个区别很关键,因为很多“恢复后跳转”其实是恢复函数和 UI 初始化各调用了一次 Continue()。
查找重复推进
Ink 的恢复不是“加载后自动重新输出当前行”,而是恢复到保存时的运行状态。你的界面层如果为了刷新文本主动调用 Continue(),就已经在推进 Story;如果场景进入逻辑、打字机控制器或自动播放协程又推进一次,用户看到的就是“刚读完的节点被跳过”。
定位时给所有 Continue()、ContinueMaximally() 以及封装后的剧情推进函数增加统一日志,至少记录调用入口和当前业务阶段。恢复路径中第一次推进只能有一个明确负责人,例如 StoryViewController,其他系统只读取缓存的当前显示文本,不直接碰 Story。
对齐外部数据的权威来源
如果同一个事实同时保存在 Ink 与 Unity,例如金币、好感度或任务完成状态,就必须为每个字段定义一个权威来源。否则恢复时无法判断谁覆盖谁。
如果 Ink 是权威来源,LoadJson() 后不要再用 Unity 默认值回写对应变量,而应从 story.variablesState 读出并同步到游戏系统。如果 Unity 是权威来源,则像示例那样在 LoadJson() 后进行一次受控回写。两边都“各自恢复再互相覆盖”是最危险的设计。
对关键字段可以在恢复结束前做一致性检查。发现 Ink 与 Unity 的值不一致时,记录两边值和最终采用哪一边,而不是静默覆盖。这样下一次出现跳转时,可以直接从日志看出分支输入是否被改写。
验证存档内容与剧情版本
还有一种容易被忽略的情况:存档来自旧版 Ink 内容,而当前客户端加载的是重新编译后的新剧情。即使 LoadJson() 成功,修改过的 knot、choice、变量结构或剧情顺序也可能让恢复位置与用户记忆中的位置不再一致。
发布会影响存档兼容的剧情改动时,给游戏存档增加自己的剧情版本号,并在恢复前判断版本是否受支持。版本不兼容时,应执行明确的迁移策略或阻止直接恢复,而不是让旧状态进入新剧情后再观察“会不会跳”。
修复后的验收不要只测一个存档点。至少覆盖普通文本后、条件分支前、选项出现时和分支进入后的存档;每个存档都记录“恢复前位置、恢复后首次可见文本、第一次主动推进后的文本”。只要恢复完成前没有推进、权威数据没有被错误覆盖,同一存档就应稳定回到同一剧情位置。