游戏叙事与剧情 / 系统课时
声明变量并保存对话状态
声明变量并保存对话状态
剧情分支要“记住”玩家做过什么,关键不是把状态写死在某个节点里,而是把它保存成 Yarn 变量。本节用布尔值、数字和字符串建立最小状态模型,并说明这些值在节点之间如何共享,以及运行时状态与存档持久化的边界。
学习目标
- 能用
<<declare>>声明布尔值、数字和字符串变量 - 能用
<<set>>更新变量,并在台词中读取当前值 - 能区分“跨节点可读”的对话状态与“跨游戏会话保存”的持久化状态
把剧情事实变成变量
变量名以 $ 开头。布尔值适合记录“是否发生过”,数字适合累计次数、好感度或货币,字符串适合保存称呼、路线名等文本状态。一个变量声明后应保持同一种类型,不要先把它当数字,后面又写入字符串。
| 剧情事实 | 适合的类型 | 示例 |
|---|---|---|
| 是否见过角色 | Boolean | $hasMetMira |
| 当前信任值 | Number | $trust |
| 玩家称呼 | String | $playerName |
显式声明还能给状态一个确定的初始值。即使某些情况下 Yarn 能推断未声明变量的类型,也更建议在正式剧情中主动声明,避免默认值和类型判断变得隐蔽。
声明、读取与更新
下面是片段示例,用于已有 Yarn 节点的正文区域;它不是完整 .yarn 文件,因为没有包含节点头部。示例声明三种变量,随后在对话中读取字符串,并修改布尔值和数字。
<<declare $hasMetMira = false>>
<<declare $trust = 0>>
<<declare $playerName = "Traveler">>
Mira: Hello, {$playerName}.
<<set $hasMetMira to true>>
<<set $trust to $trust + 1>>
Mira: Our trust is now {$trust}.预期结果
Mira: Hello, Traveler.
Mira: Our trust is now 1.
状态变化:
$hasMetMira = true
$trust = 1
$playerName = "Traveler"{$playerName} 是把变量值插入台词,<<set>> 则真正修改状态。后续节点只要读取同一个变量,就能知道玩家已经见过 Mira,也能继续使用当前信任值。
理解变量的作用范围
Yarn 变量不是“某一行台词的临时值”,也不是天然只属于声明它的节点。运行中的对话会通过变量存储读写这些状态,因此一个节点修改 $hasMetMira 后,之后进入的其他节点仍可依据同名变量判断剧情。

这里要区分两个概念:对话流程中的保存表示变量值仍存在于当前 Variable Storage;游戏存档中的保存则要求把这些值写入持久化存储,并在读档时恢复。只使用内存型变量存储时,退出游戏后未持久化的状态会丢失。
设计状态时避免三个坑
不要为同一事实创建多个近义变量,例如 $metMira、$sawMira、$knowMira 同时存在会让分支互相矛盾。应先确定一个“单一事实来源”,再让所有相关节点读取它。
数值变量要约定含义和范围。例如 $trust 是 0~5 还是可以无限增长,应在剧情设计阶段确定;否则后期判断条件会出现大量难以解释的魔法数字。字符串则更适合展示或标识,不要用 "yes"、"no" 代替真正的布尔值。
当状态会影响任务、战斗、背包等非对话系统时,也应提前决定谁是权威数据源。Yarn 变量可以承担纯剧情状态;跨系统核心状态则更适合接入游戏自己的存档体系,再由对话层读取。