游戏叙事与剧情 / 系统课时
同步剧情变量与游戏状态
同步剧情变量与游戏状态
Ink 变量很适合表达“剧情正在怎么看待世界”,但任务进度、背包、金币等通常已有游戏代码负责。同步的关键不是把两边所有字段复制一遍,而是先划清谁拥有真值,再只在明确的边界上读写,避免剧情状态与游戏状态互相覆盖。
学习目标
- 区分由 Ink 持有和由游戏代码持有的状态
- 使用
VariablesState在进入与离开剧情节点时同步必要变量 - 避免双向同步、命名漂移和旧值覆盖新值
先确定状态所有权
最容易出错的设计,是同一个业务事实同时由 Ink 和游戏代码长期保存。例如 quest_stage 在 Ink 中会变化,任务系统里也会变化,那么任意一边晚一步写回,都可能把较新的状态覆盖掉。
更稳妥的做法是给每个字段指定唯一真值来源。剧情内部的临时标记,例如“本次对话是否追问过”,可以留在 Ink;跨场景、跨系统都会使用的数据,例如任务阶段、金币、角色好感度总值,通常由游戏代码持有。Ink 只在需要判断或表达时拿到一个同步值。
| 状态示例 | 建议真值来源 | Ink 中的角色 |
|---|---|---|
| 本次对话已追问 | Ink | 直接读写 |
| 当前任务阶段 | 游戏代码 | 进入对话前写入 Ink |
| 玩家金币 | 游戏代码 | 进入对话前写入,离开后不回写 |
| 剧情做出的阵营选择 | 视项目设计而定 | 若需影响全局,则在出口显式提交 |

用桥接层执行同步
下面示例假设项目已经通过 Ink.Runtime 创建了 Story。GameState 持有任务阶段和金币;剧情结束后,只把 Ink 中明确允许提交的 faction_choice 写回游戏状态。其余字段不会自动反向复制。
片段示例:以下桥接类依赖 Ink.Runtime,并要求调用方已经用编译后的 Ink JSON 创建 Story;脚本中还必须预先声明 quest_stage、coins、faction_choice。
using Ink.Runtime;
public sealed class GameState
{
public int QuestStage { get; set; }
public int Coins { get; set; }
public string FactionChoice { get; set; } = "";
}
public sealed class NarrativeStateBridge
{
private readonly Story story;
private readonly GameState gameState;
public NarrativeStateBridge(Story story, GameState gameState)
{
this.story = story;
this.gameState = gameState;
}
public void PushGameStateToInk()
{
// 这些变量的真值在游戏侧,进入剧情前覆盖 Ink 中的镜像值。
story.variablesState["quest_stage"] = gameState.QuestStage;
story.variablesState["coins"] = gameState.Coins;
}
public void PullCommittedInkState()
{
// 只回收被设计为“剧情提交结果”的字段,避免全量双向同步。
object value = story.variablesState["faction_choice"];
gameState.FactionChoice = value?.ToString() ?? "";
}
}验证方法:进入剧情前调用 PushGameStateToInk(),检查 Ink 读取到的任务阶段与金币是否与游戏状态一致;剧情结束且 faction_choice 已被赋值后调用 PullCommittedInkState(),游戏侧只应更新阵营选择,任务阶段和金币不应被 Ink 反向覆盖。
预期结果
Ink quest_stage = <GAME_QUEST_STAGE>
Ink coins = <GAME_COINS>
Game factionChoice = <INK_COMMITTED_CHOICE>在 Ink 中只声明需要同步的变量
Ink 侧只需要声明脚本真正会读取或修改的字段。片段示例:下面脚本依赖宿主在进入剧情前完成变量推送,用于验证这些字段在剧情中的读写方式。
VAR quest_stage = 0
VAR coins = 0
VAR faction_choice = ""
=== hub ===
{ quest_stage >= 2:
任务已经进入第二阶段。
- else:
任务还没有推进到第二阶段。
}
{ coins >= 100:
你看起来准备得很充分。
}
+ [加入守望者]
~ faction_choice = "watchers"
-> END
+ [暂不表态]
-> END这是 Ink 脚本片段,生效行为是:quest_stage 与 coins 只参与剧情判断,faction_choice 由玩家选择产生。验证时应在进入对话前推送游戏状态,在剧情结束后检查游戏侧是否只接收到允许提交的字段。
选择同步时机而不是持续镜像
推荐把同步点放在明确生命周期边界:创建或进入 Story 前推送一次游戏状态;剧情产生需要提交的结果时显式拉取;如果对话过程中游戏状态确实可能变化,再针对那个字段设计额外同步事件。
不要每帧遍历所有变量,也不要看到变量同名就默认双向绑定。持续镜像会让“谁最后写入”变成隐式规则,排查覆盖问题非常困难。真正需要实时联动时,也应把联动做成单独事件,而不是扩大成全量同步。
处理缺失变量与类型变化
VariablesState 依赖 Ink 中已经存在的变量名。重命名脚本变量时,桥接代码也要同步修改;把整数改成字符串等类型变化,也应作为接口变更处理。生产代码可以在加载新剧情资源时做一次字段契约检查,并在发现缺失变量时阻止进入剧情,而不是静默忽略。
最重要的边界是:Ink 负责叙事过程,游戏代码负责全局业务状态;跨边界的数据必须有明确方向、明确时机和明确字段。只要坚持单一真值来源,同步逻辑就会从“两个状态系统互相猜”变成可检查的接口。