游戏叙事与剧情 / 系统课时
状态表怎么写才方便查
状态表怎么写才方便查
剧情变量一多,最先失控的往往不是代码,而是“这个字段从哪来、谁能改、什么时候能读”。本节把状态变量整理成一张可检索的状态表,让新增分支、排查异常和修改规则时都能快速找到依据。
学习目标
- 为每个剧情状态记录类型、来源、修改入口、读取条件和持久化范围
- 用统一命名和有限值约束减少歧义
- 能用状态表反查“谁写了它”和“哪些分支依赖它”
状态表先解决什么
状态表不是把变量名集中抄一遍,而是为每个状态建立“使用契约”。当某个分支结果不对时,你应该能从表里回答三个问题:这个值最初怎么得到、哪些逻辑允许修改、它会影响哪些判断。
如果只记录字段名和说明,维护时仍要全局搜索代码。真正有用的状态表至少要把写入来源和读取条件放在一起,因为剧情错误通常来自“写错了”或“读早了”。
一行字段至少写清六件事
下面是一份适合剧情项目的最小状态表。字段可以存放在数据库、存档文件或运行时对象中,但文档中的定义应保持一致。
| 字段 | 类型 | 来源 | 修改入口 | 读取条件 | 持久化范围 |
|---|---|---|---|---|---|
player.gold |
整数 | 新存档初始值、任务奖励 | 奖励结算、商店消费 | 购买判断、财富分支 | 存档级 |
quest.blacksmith |
枚举 | 接取铁匠任务 | 任务流程服务 | 对话与任务分支 | 存档级 |
npc.mira.affinity |
整数 | 新存档初始值 | 对话选择、事件奖励 | 好感度门槛 | 存档级 |
flags.sawBridge |
布尔 | 默认 false |
首次到达桥场景 | 首见与重访文本 | 存档级 |
类型决定允许写入什么值;来源说明初始值或首次产生位置;修改入口限定谁有权改变它;读取条件记录哪些规则会依赖它;持久化范围则回答切场景、读档或开新档后是否还应保留。
命名和取值要让人一眼能查
字段名最好体现所属对象和语义,例如 npc.mira.affinity 比 miraValue 更容易搜索,也不容易和别的数值混淆。布尔字段使用能够直接读成“是或否”的名字,如 flags.sawBridge,避免 bridgeStatus 这类需要额外解释的命名。
有限状态不要用随意字符串扩散到各处。比如任务状态可以约定为 NOT_STARTED、ACTIVE、DONE、FAILED。状态表中应列出允许值和含义;代码里再用枚举或常量约束,避免出现 complete、completed、finish 同时存在的情况。
用状态表反查读写关系
状态表最有价值的用法是反查。当 quest.blacksmith 意外变成 DONE,先看“修改入口”,就能把排查范围缩小到任务流程服务;当某段对话错误出现,再看“读取条件”,确认该节点到底依赖任务状态还是好感度。
维护时可以按下面顺序检查:
- 新增字段时,先写清类型和初始来源,再允许代码引用。
- 新增写入逻辑时,更新“修改入口”,避免出现未登记的旁路修改。
- 新增分支条件时,更新“读取条件”,让依赖关系可追踪。
- 改变存档策略时,逐项检查“持久化范围”,确认哪些值需要迁移或重置。
一张好查的状态表,本质上是在变量名之外补齐“谁产生、谁修改、谁依赖、活多久”四类信息。只要这些信息能被稳定维护,剧情分支增长后仍能快速定位状态来源,而不必每次从全文搜索开始。