游戏叙事与剧情 / 系统课时
区分脚本内容和运行状态
区分脚本内容和运行状态
对话脚本负责描述“有哪些节点、台词和分支规则”,运行状态则回答“这一局已经发生了什么”。把两者分开,才能让脚本可复用、存档可迁移,也避免修改一句台词就破坏玩家进度。
学习目标
- 区分 Yarn 脚本内容、Yarn 变量、游戏任务数据和玩家存档的职责
- 判断哪些信息应该持久化,哪些只应保留在内容资产中
- 建立对话系统与游戏存档系统之间清晰的边界
脚本内容不是玩家存档
Yarn 文件属于内容资产。节点名、台词、选项、条件表达式和变量声明描述的是“剧情可以怎样运行”,它们通常随游戏版本发布,而不是随某个玩家不断改写。
例如下面的节点声明了一个剧情变量,并根据它选择不同台词:
title: Gate
---
<<declare $met_guard = false>>
Guard: 站住。
<<if $met_guard>>
Guard: 我记得你,可以进城。
<<else>>
Guard: 第一次来?先登记。
<<set $met_guard to true>>
<<endif>>
===预期结果:同一运行会话内第一次进入节点时走首次见面分支;变量被改为 true 后,再次进入会走已见过守卫的分支。
第一次:Guard: 站住。 / Guard: 第一次来?先登记。
再次进入:Guard: 站住。 / Guard: 我记得你,可以进城。这里的节点结构和两段台词属于脚本内容;$met_guard 在某次游戏中的当前值属于运行状态。脚本仍然可以保持不变,但不同玩家读取到的变量值可以不同。
四类数据要分开负责
最容易混淆的是 Yarn 变量、任务系统状态和存档文件。可以把它们理解为四个层次:脚本提供规则,变量记录对话判断所需的小状态,游戏系统维护真正的业务数据,存档系统负责把需要跨会话保留的数据序列化。

Yarn 变量适合保存直接参与对白分支的简单值,例如是否见过某角色、某阵营声望或某段剧情是否完成。任务目标、物品数量、角色位置等应由各自游戏系统持有,不要为了“对话里能访问”就复制一份到 Yarn 变量中。
判断一个值是否应该保存
判断标准不是“它是不是 Yarn 变量”,而是“玩家重新启动游戏后,是否必须保留这个结果”。例如 $met_guard 会影响后续剧情,通常应保存;仅用于当前一句动画节奏的临时标记,即使放在变量存储里,也未必值得持久化。
还要区分“剧情进度”与“解释器执行现场”。通常应保存稳定的剧情检查点、关键变量和游戏状态,而不是尝试序列化正在播放到第几句、当前等待哪个 UI 回调等瞬时执行细节。后者与代码版本、节点结构和界面生命周期耦合很强,恢复成本高且容易失效。
给保存系统一个明确边界
更稳妥的设计是让存档系统统一发起保存:它向对话变量存储获取需要持久化的值,同时向任务、背包等系统取得各自快照,再写入同一个玩家存档。加载时顺序反过来,先恢复底层状态,再进入对应的剧情检查点。
这样做的直接收益是:Yarn 脚本仍然只负责表达剧情;对话运行时只管理当前变量;真正的持久化策略、版本迁移和存档槽管理都留在游戏保存系统。后续即使重写某段台词,只要关键变量和检查点的语义保持稳定,旧存档也更容易继续使用。