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

同步剧情变量与游戏状态

同步剧情变量与游戏状态

Ink 变量很适合表达“剧情正在怎么看待世界”,但任务进度、背包、金币等通常已有游戏代码负责。同步的关键不是把两边所有字段复制一遍,而是先划清谁拥有真值,再只在明确的边界上读写,避免剧情状态与游戏状态互相覆盖。

学习目标

  • 区分由 Ink 持有和由游戏代码持有的状态
  • 使用 VariablesState 在进入与离开剧情节点时同步必要变量
  • 避免双向同步、命名漂移和旧值覆盖新值

先确定状态所有权

最容易出错的设计,是同一个业务事实同时由 Ink 和游戏代码长期保存。例如 quest_stage 在 Ink 中会变化,任务系统里也会变化,那么任意一边晚一步写回,都可能把较新的状态覆盖掉。

更稳妥的做法是给每个字段指定唯一真值来源。剧情内部的临时标记,例如“本次对话是否追问过”,可以留在 Ink;跨场景、跨系统都会使用的数据,例如任务阶段、金币、角色好感度总值,通常由游戏代码持有。Ink 只在需要判断或表达时拿到一个同步值。

状态示例 建议真值来源 Ink 中的角色
本次对话已追问 Ink 直接读写
当前任务阶段 游戏代码 进入对话前写入 Ink
玩家金币 游戏代码 进入对话前写入,离开后不回写
剧情做出的阵营选择 视项目设计而定 若需影响全局,则在出口显式提交

Ink 与游戏状态的同步边界

用桥接层执行同步

下面示例假设项目已经通过 Ink.Runtime 创建了 Story。GameState 持有任务阶段和金币;剧情结束后,只把 Ink 中明确允许提交的 faction_choice 写回游戏状态。其余字段不会自动反向复制。

片段示例:以下桥接类依赖 Ink.Runtime,并要求调用方已经用编译后的 Ink JSON 创建 Story;脚本中还必须预先声明 quest_stage、coins、faction_choice。

csharp
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 反向覆盖。

预期结果

text
Ink quest_stage = <GAME_QUEST_STAGE>
Ink coins = <GAME_COINS>
Game factionChoice = <INK_COMMITTED_CHOICE>

在 Ink 中只声明需要同步的变量

Ink 侧只需要声明脚本真正会读取或修改的字段。片段示例:下面脚本依赖宿主在进入剧情前完成变量推送,用于验证这些字段在剧情中的读写方式。

text
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 负责叙事过程,游戏代码负责全局业务状态;跨边界的数据必须有明确方向、明确时机和明确字段。只要坚持单一真值来源,同步逻辑就会从“两个状态系统互相猜”变成可检查的接口。

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

目录与阅读设置

阅读设置

17

记录一个想法

同步剧情变量与游戏状态

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

登录哪都通