游戏叙事与剧情 / 系统课时
更新规则后旧存档怎么兼容
更新规则后旧存档怎么兼容
关系规则升级后,旧存档最危险的不是“字段缺失”,而是旧数据还能读,却被新规则解释成了另一种含义。本节用版本化存档和迁移函数处理字段新增、数值区间调整与规则重算,让旧档进入新版本时有明确、可测试的转换路径。
学习目标
- 为关系数据设计可判定的存档版本
- 区分直接迁移、重算和保持旧语义三种策略
- 用可重复执行的迁移流程验证旧存档兼容性
先给关系数据一个明确版本
不要通过“有没有某字段”猜存档来自哪个版本。关系数据应携带独立版本号,例如 relationSchemaVersion。游戏版本和关系数据版本可以不同,因为一次客户端更新未必会改变存档结构。
{
"relationSchemaVersion": 1,
"characters": {
"npc_anna": {
"affinity": 72
}
}
}这里的版本只描述关系数据结构和语义。后续如果把好感度从 0~100 改成 0~1000,即使字段名仍叫 affinity,也应该提升版本,因为同一个数值已经不再代表同一尺度。
选择迁移还是保留旧语义
规则变化并不都适合“把旧档按新规则重新算一遍”。如果历史事件已经无法完整还原,重算反而会制造新错误。可以按变化类型选择策略:字段新增时补默认值;线性尺度变化时做确定性换算;历史判定规则变化但缺少原始事件时,通常保留旧结果,只让新规则影响迁移后的新增事件。

用逐版本迁移避免跨版本分支失控
迁移函数最好一次只处理一个版本,并允许连续执行。这样从版本 1 升到版本 3 时,依次执行 1 → 2、2 → 3,不必维护 1 → 3、1 → 4 等大量组合。
def migrate_relation(data: dict) -> dict:
version = data["relationSchemaVersion"]
if version == 1:
for character in data["characters"].values():
# v2 将 0~100 的好感度尺度扩展为 0~1000。
character["affinity"] *= 10
character["relationshipTier"] = "normal"
data["relationSchemaVersion"] = 2
version = 2
if version == 2:
for character in data["characters"].values():
# v3 新增锁定字段,不改写已有关系结果。
character["locked"] = False
data["relationSchemaVersion"] = 3
return data
old_save = {
"relationSchemaVersion": 1,
"characters": {"npc_anna": {"affinity": 72}}
}
print(migrate_relation(old_save))预期输出:
{'relationSchemaVersion': 3, 'characters': {'npc_anna': {'affinity': 720, 'relationshipTier': 'normal', 'locked': False}}}迁移完成后再写回新版本。不要先覆盖原存档再迁移;生产实现应先备份或写入临时槽位,校验成功后再替换正式数据,这样迁移中断时仍能回退。
迁移必须满足的三个性质
首先是确定性:同一份旧档执行迁移应得到相同结果。其次是可重复检查:已经迁移到最新版本的数据再次进入加载流程时,不应重复放大数值或重复补偿。最后是可观测:至少记录迁移前版本、迁移后版本和失败原因,便于定位玩家个案。
测试不要只造一个“标准旧档”。至少准备边界值、缺少可选字段、多个角色、已达到关系上限和中途迁移失败的样本。验收时重点确认旧档能加载、关系语义没有意外改变、新规则只从约定的时间点开始生效,并且迁移失败不会破坏原始存档。