游戏叙事与剧情 / 系统课时
整理最终变量与分支清单
整理最终变量与分支清单
分支剧情完成后,真正决定它能否交接和继续扩展的,不是流程图画得多漂亮,而是别人能否快速回答三个问题:有哪些变量、在哪里修改、哪些节点读取它们。本节把这些信息整理成一份可测试、可维护的最终清单。
学习目标
- 为剧情变量建立统一、无歧义的定义表
- 汇总变量的修改位置、读取节点与对应分支规则
- 形成可以直接用于评审、测试和后续扩展的交接文档
先固定变量定义
最终整理时,第一步不是复制所有条件表达式,而是建立变量字典。每个变量至少要说明名称、类型、默认值和语义,并确保同一个概念没有多个近义变量。
例如 guard_trust 表示守卫对玩家的信任程度,就不应该同时存在语义近似的 guard_relation,除非两者确实承担不同职责。布尔变量也要写清楚它表达的是“当前状态”还是“某件事是否曾经发生”,因为这两类变量的生命周期通常不同。
一个可交接的变量表可以保持如下粒度:
| 变量 | 类型 | 默认值 | 含义 |
|---|---|---|---|
has_pass |
Boolean | false |
玩家当前是否持有通行证 |
guard_trust |
Integer | 0 |
守卫对玩家的信任值 |
gate_opened |
Boolean | false |
城门是否已经打开 |
gate_event_done |
Boolean | false |
开门事件是否已经完整执行 |
默认值必须和首次进入剧情时的真实状态一致。如果某个变量没有合理默认值,应明确要求它必须在更早的初始化节点写入,而不是让后续节点自行猜测。
把修改位置和读取位置放在一起
只有变量定义还不足以排查剧情问题。维护者还需要知道“谁写了它”和“谁依赖它”。因此每个重要变量应补充写入节点与读取节点,形成最小的数据流记录。
| 变量 | 主要写入节点 | 主要读取节点 | 修改规则 |
|---|---|---|---|
has_pass |
获得通行证、交付通行证 | 守卫检查、城门节点 | 获得时设为 true,交付后设为 false |
guard_trust |
对话选择、任务完成 | 守卫分支、支援事件 | 按明确事件增减,避免重复结算 |
gate_opened |
城门开启节点 | 城门交互、后续区域入口 | 开启后保持 true |
gate_event_done |
城门事件结束位置 | 城门事件入口 | 成功执行一次后设为 true |
这张表的价值在于快速发现“有人写但没人读”和“有人读但没人负责初始化”的变量。前者可能是废弃状态,后者通常意味着潜在的缺省条件问题。
把分支规则写成可测试条件
分支清单不要只写“关系好时放行”这类自然语言。测试人员需要能直接构造输入,因此条件应该对应到明确变量和值。
可以把关键节点整理成以下形式:
| 节点 | 条件 | 结果 | 副作用 |
|---|---|---|---|
| 守卫检查 | gate_opened=true |
直接放行 | 无 |
| 守卫检查 | gate_opened=false 且 has_pass=true |
执行开门流程 | 消耗通行证 |
| 守卫检查 | 无通行证且 guard_trust>=60 |
信任放行 | 开启城门 |
| 守卫检查 | 其他情况 | 拒绝进入 | 无 |
这里最重要的是分支顺序。多个条件可能同时成立时,应按照实际执行顺序排列,并保证前面的规则不会意外吞掉更具体的分支。例如“门已经打开”通常应优先于“是否还有通行证”,因为通行证可能已经在开门过程中被消耗。
增加交接时必须回答的信息
最终清单应让接手者不打开所有剧情节点也能理解核心状态关系。对于每个关键变量和分支,至少能够追溯到定义、写入、读取和结果四个位置。
此外要标记一次性事件、不可逆状态和允许回溯的选择。测试人员据此才能区分真正的缺陷与设计允许的重新选择,也能更容易构造“首次进入、重复进入、读档恢复、状态冲突”等测试场景。
用清单完成最后一次一致性检查
交付前从两个方向检查一次。先从变量出发,确认每个变量都有定义、默认值、写入位置和至少一个有效读取位置;再从关键节点出发,确认每个分支引用的变量都能在变量表中找到,并且所有条件组合都有明确去向。
如果一个分支依赖多个变量,还要检查是否存在同时满足多个规则的情况。此时应明确优先级,而不是依赖实现顺序碰巧得到正确结果。对于已经废弃的剧情变量和分支,最好直接从最终清单中删除,而不是保留“可能以后再用”的状态。
最终得到的清单不是剧情设计的附录,而是变量、节点和测试之间的共同接口。只要每个状态都能追溯来源、每个分支都能构造输入、每个副作用都能确认执行次数,这套分支剧情就具备继续维护和扩展的基础。