游戏叙事与剧情 / 系统课时
大改剧情时先检查哪些变量
大改剧情时先检查哪些变量
剧情大改最容易出问题的地方不是新内容,而是旧变量还在被某些节点、存档或结局条件依赖。本节建立一套变更检查顺序,分别处理删除、重命名和作用域调整,让你在改主线前先圈出受影响路径,再决定迁移还是清理。
学习目标
- 能按固定顺序检查变量定义、写入点、读取点和持久化数据
- 能判断删除、重命名与改作用域分别会破坏哪些剧情路径
- 能用脚本对变量使用清单做一次基础影响检查
先查定义,再查谁写谁读
第一步先确认变量当前的定义:名称、类型、默认值、作用域、是否持久化。随后分别检查写入点和读取点。顺序不要反过来,因为如果你连变量语义和生命周期都没确认,只看使用位置很容易误判。
推荐检查顺序是:变量定义 → 写入事件 → 条件读取节点 → 结局与成就 → 存档或迁移逻辑。前四项决定运行中的剧情,最后一项决定旧玩家能否继续读取已有状态。

如果一个变量只在编辑器中显示却从未被读取,删除风险可能很低;反过来,即使它只出现两次,只要其中一次是结局判定或存档字段,也必须慎重处理。
三类改动分别会破坏什么
删除变量最典型的问题是残留读取:节点条件仍访问旧变量,结果可能报错,也可能默认为假,从而悄悄改变剧情。删除前要先找到所有读取点,再确认是否需要替代条件。
重命名变量不仅是文本替换。运行时脚本可以全部改成新名,但旧存档里仍可能保存旧字段。若产品要兼容旧存档,就需要迁移映射;如果明确不兼容,则必须让版本策略和提示保持一致。
修改作用域更隐蔽。把全局变量改成章节变量后,进入新章节时它可能被重置;把局部变量提升为全局后,又可能把本应独立的多段剧情串在一起。检查重点是变量“何时创建、何时重置、谁能读取”。
用使用清单做一次影响扫描
项目规模不大时,可以先维护一份变量使用清单。下面的脚本模拟删除 trust 前的扫描:只要变量仍有读取点或存档依赖,就不能直接删除。
variables = {
"trust": {
"writes": ["event:help_merchant"],
"reads": ["node:secret_room", "ending:ally"],
"persisted": True,
},
"temp_hint": {
"writes": ["event:tutorial"],
"reads": [],
"persisted": False,
},
}
def check_delete(name: str) -> None:
info = variables[name]
blockers = []
if info["reads"]:
blockers.append(f"仍有读取点 {info['reads']}")
if info["persisted"]:
blockers.append("仍写入存档")
if blockers:
print(f"{name}: 不可直接删除;" + ";".join(blockers))
else:
print(f"{name}: 可进入删除评审")
check_delete("trust")
check_delete("temp_hint")预期输出:
trust: 不可直接删除;仍有读取点 ['node:secret_room', 'ending:ally'];仍写入存档
temp_hint: 可进入删除评审真实项目里,使用清单可以来自代码搜索、剧情编辑器导出或静态分析。这个脚本只负责表达检查逻辑,不替代完整扫描。
变更完成后怎么验证
改完变量后,不要只验证“新剧情能走通”。至少选一条受影响主路径和一条不应受影响的旁路,分别从干净新档和旧存档执行。前者验证新逻辑,后者验证兼容性。
如果是重命名,重点确认旧名不会继续产生新数据;如果是删除,确认运行时和内容资源里都没有残留读取;如果是改作用域,确认进入、离开和重新加载章节时变量值符合预期。