游戏叙事与剧情 / 系统课时

大改剧情时先检查哪些变量

大改剧情时先检查哪些变量

剧情大改最容易出问题的地方不是新内容,而是旧变量还在被某些节点、存档或结局条件依赖。本节建立一套变更检查顺序,分别处理删除、重命名和作用域调整,让你在改主线前先圈出受影响路径,再决定迁移还是清理。

学习目标

  • 能按固定顺序检查变量定义、写入点、读取点和持久化数据
  • 能判断删除、重命名与改作用域分别会破坏哪些剧情路径
  • 能用脚本对变量使用清单做一次基础影响检查

先查定义,再查谁写谁读

第一步先确认变量当前的定义:名称、类型、默认值、作用域、是否持久化。随后分别检查写入点和读取点。顺序不要反过来,因为如果你连变量语义和生命周期都没确认,只看使用位置很容易误判。

推荐检查顺序是:变量定义 → 写入事件 → 条件读取节点 → 结局与成就 → 存档或迁移逻辑。前四项决定运行中的剧情,最后一项决定旧玩家能否继续读取已有状态。

剧情大改前的变量变更检查流程

如果一个变量只在编辑器中显示却从未被读取,删除风险可能很低;反过来,即使它只出现两次,只要其中一次是结局判定或存档字段,也必须慎重处理。

三类改动分别会破坏什么

删除变量最典型的问题是残留读取:节点条件仍访问旧变量,结果可能报错,也可能默认为假,从而悄悄改变剧情。删除前要先找到所有读取点,再确认是否需要替代条件。

重命名变量不仅是文本替换。运行时脚本可以全部改成新名,但旧存档里仍可能保存旧字段。若产品要兼容旧存档,就需要迁移映射;如果明确不兼容,则必须让版本策略和提示保持一致。

修改作用域更隐蔽。把全局变量改成章节变量后,进入新章节时它可能被重置;把局部变量提升为全局后,又可能把本应独立的多段剧情串在一起。检查重点是变量“何时创建、何时重置、谁能读取”。

用使用清单做一次影响扫描

项目规模不大时,可以先维护一份变量使用清单。下面的脚本模拟删除 trust 前的扫描:只要变量仍有读取点或存档依赖,就不能直接删除。

python
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")

预期输出:

text
trust: 不可直接删除;仍有读取点 ['node:secret_room', 'ending:ally'];仍写入存档
temp_hint: 可进入删除评审

真实项目里,使用清单可以来自代码搜索、剧情编辑器导出或静态分析。这个脚本只负责表达检查逻辑,不替代完整扫描。

变更完成后怎么验证

改完变量后,不要只验证“新剧情能走通”。至少选一条受影响主路径和一条不应受影响的旁路,分别从干净新档和旧存档执行。前者验证新逻辑,后者验证兼容性。

如果是重命名,重点确认旧名不会继续产生新数据;如果是删除,确认运行时和内容资源里都没有残留读取;如果是改作用域,确认进入、离开和重新加载章节时变量值符合预期。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

大改剧情时先检查哪些变量

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通