游戏叙事与剧情 / 系统课时
剧情变量命名避免歧义
剧情变量命名避免歧义
剧情变量一旦进入条件判断、存档和多人协作,含糊命名就会迅速变成维护成本。本节建立一套面向剧情设计的命名规则,让设计者仅看变量名,就能判断它记录了什么对象、什么状态,以及大致如何取值。
学习目标
- 能从变量名中识别事件、对象和状态含义
- 能区分布尔、枚举、计数和关系类变量的命名方式
- 能发现并修正容易产生歧义或语义漂移的变量名
变量名先回答三个问题
一个可长期维护的剧情变量,至少应该让人快速回答三个问题:它描述谁或什么、记录哪种状态、这个状态如何解释。例如 door_open 比 door 明确,因为后者既可能表示门是否存在,也可能表示门是否打开。
事件类变量同样要带上结果或阶段。ritual 很难判断含义,而 ritual_completed 明确表示仪式已经完成。如果记录的是是否发现过线索,则 clue_letter_found 比 letter 更适合作为条件判断依据。
用稳定结构组织变量名
同一项目最好采用固定结构,例如“对象或事件 + 状态”。涉及角色关系时,可以使用“关系类型 + 角色”;涉及多个阶段时,再补充阶段或结果。
| 用途 | 推荐命名 | 表达含义 |
|---|---|---|
| 场景状态 | vault_door_open |
金库门当前是否打开 |
| 事件结果 | bridge_repaired |
桥梁是否已经修复 |
| 线索获得 | clue_map_found |
是否获得地图线索 |
| 角色关系 | trust_mira |
玩家与 Mira 的信任值 |
| 事件次数 | guard_warning_count |
守卫警告过玩家的次数 |
如果项目里有大量同类变量,还应统一词汇。例如全项目都使用 found 表示“已发现”,就不要同时混用 discovered、seen、got。词汇统一能直接减少条件配置时的误选。
让命名反映取值类型
布尔变量适合使用能够形成明确真假判断的名称,例如 gate_locked、quest_failed。看到变量名时,应能自然地问“它现在是 true 还是 false”。gate_state 则更像枚举变量,不适合直接作为布尔量使用。
枚举变量应描述“当前处于哪一种状态”,例如 alarm_state 可以约定取值为 idle、active、disabled。计数变量最好显式带 count,如 retry_count;数值型关系变量则直接表达维度,如 trust_mira、reputation_city。
避免会变质的命名
flag1、temp、special_event 这类名称的问题不只是“不好看”,而是它们无法建立稳定语义。剧情扩展后,新成员无法判断变量对应哪个事件,旧成员也可能把同一变量重复利用到新的含义上。
还要避免把当前文案直接当成变量名。例如某段对白现在写着“相信她”,变量却命名为 believe_her;角色关系调整后,“她”究竟指谁就会失去上下文。使用 trust_mira 这类带明确对象的名称更安全。
当一个变量的业务含义已经改变时,优先新建名称并迁移引用,而不是继续沿用旧名字。变量名应该描述当前事实,而不是记录它最初是为哪段剧情临时创建的。
命名完成后的检查方法
提交变量前,可以把名称单独复制出来,不看变量说明和所在节点,再检查自己是否还能解释它。一个合格名称通常能够直接说清对象与状态,并且不会与项目中其他变量产生明显重叠。
还要检查同类变量是否遵循同一词汇和结构。若已有 clue_key_found,新增线索变量就继续使用 clue_<name>_found;若关系值统一使用 trust_<character>,就不要突然新增 mira_affection_score 表示同一种关系维度。稳定的命名体系会让后续条件分支更容易检索、审查和批量修改。