一次更新，三个MOD，三种坏法

先描述一个模拟场景，版本号和字段名都是示例。游戏从1.4更新到1.5，更新说明里有三条改动：

  • Rules中的“黄牌累计停赛”字段拆成了联赛和杯赛两个独立字段。
  • Character新增“体能恢复速度”字段，旧数据里没有。
  • 球员模型重新做了UV布局，改善了长袖球衣的褶皱表现。

一位玩家本地启用了三个AI生成的MOD：一个16队的“海湾联赛”MOD、一个让对手更爱高位逼抢的战术MOD、一套给星港队做的复古球衣。更新后，三个MOD的表现各不相同：

MOD被哪条更新击中 失效表现危险程度
海湾联赛MOD 黄牌字段拆分 能加载，但杯赛里停赛规则不生效 高：错误不显眼
高位逼抢战术MOD 新增体能恢复字段 加载时报缺少字段，无法启用 中：玩家立刻发现
星港复古球衣UV布局变化 号码位置错位，比赛正常低：肉眼可见

最危险的不是打不开的那个，而是能打开却算错的那个。玩家可能踢了十轮才发现，核心球员在杯赛里吃了五张黄牌依然正常上场。

为什么AI生成的MOD更容易在更新后出问题

手工制作的MOD，作者通常知道自己改了哪些字段。AI生成的MOD往往一次改动几十个对象，玩家并不清楚每个字段从哪里来。如果生成时没有记录它基于哪个版本、读取了哪些它没修改的对象，更新后系统就只能靠加载时报错来发现问题，而像黄牌字段拆分这种“语义变化”，加载阶段根本不会报错。

所以兼容处理的起点不在更新那天，而在MOD生成那天。在乐鱼体育的MOD设计里，每个AI生成的MOD都附带一份依赖声明，至少包括：

  • 基线版本：生成时的游戏版本和数据结构版本。
  • 修改对象：改了哪些Team、Character、League、Rules字段。
  • 读取对象：没有修改但运行时依赖的对象，例如球衣MOD依赖的球员模型。
  • 外部依赖：依赖的其他MOD及其版本。

系统处理顺序：先查、再迁、后修、能退

游戏更新以后，乐鱼体育的MOD系统按下面的顺序处理每个MOD：

读取依赖声明对照更新差异Schema迁移自动修复试运行通过则启用，失败则回退
  1. 对照更新差异：拿MOD的修改对象和读取对象，去比对本次更新改了哪些字段。没有交集的MOD直接标记为兼容。三个示例MOD都有交集，进入下一步。
  2. Schema迁移：对结构变化做确定性的映射。黄牌字段拆分后，旧值同时写入联赛和杯赛两个新字段，这是最保守的迁移；新增的体能恢复字段按游戏默认值补齐。这一步应由迁移规则执行，而不是让语言模型临场猜。
  3. 自动修复：迁移解决不了的，再让AI介入。比如球衣号码错位，AI可以按新的UV布局重新对齐号码和胸前图案，生成一个修复候选。
  4. 试运行：修复后的MOD先跑一场或一个短赛季。联赛MOD要验证停赛规则在杯赛中能否触发；战术MOD要看高位逼抢在新的体能恢复参数下，会不会导致AI球员到60分钟就跑不动；球衣MOD要截取默认镜头下的号码截图。
  5. 回退：任何一步失败，就把这个MOD保持在停用状态，并保留更新前的版本，不要把半修好的状态直接交给玩家。

迁移结果要让玩家看得见，而且能选

自动迁移不等于替玩家做主。黄牌字段拆分以后，玩家原本设计的可能是“联赛累计5张停赛”，迁移后杯赛也变成了5张，而玩家也许希望杯赛更宽松。系统应该把迁移结果做成可对比的版本：

模拟示例：海湾联赛MOD的版本记录

  • V1：玩家与AI在1.4版本下生成，16队双循环，累计5张黄牌停赛。
  • V2：玩家手动把晋级名额改成前4名。
  • V3：1.5更新后自动迁移，联赛与杯赛停赛阈值都设为5张，标注“待确认”。

玩家可以对比V2和V3的差异，只看到停赛字段的变化；可以把杯赛阈值改成3张后确认；也可以恢复V2，在1.4兼容模式下继续踢完当前赛季。

这里的关键是“当前赛季”。联赛踢到一半时更新游戏，最稳妥的做法通常是让进行中的赛季继续使用旧规则，新赛季开始时再切换到迁移后的版本，避免前半程和后半程按两套规则计分。换设备或更新乐鱼体育App后版本记录不同步的问题，也要按同样的思路先确认版本再迁移。

多个MOD之间的连锁兼容

还有一类问题只在多个MOD同时启用时出现。比如一个球衣包依赖海湾联赛MOD里新增的8支球队，联赛MOD回退到V2时，球衣包的外部依赖版本也要随之核对。系统应在回退任何一个MOD前，列出所有依赖它的MOD，提示“回退此MOD会影响2个其他MOD”，而不是静默处理。扩军类联赛MOD的依赖链尤其长，虚拟联赛MOD那篇列出的六项系统，在更新后也都应该重新过一遍。

更新前后，玩家可以做的检查

最该担心的不是报错的MOD，而是没报错却悄悄改变了规则的MOD。
  • 更新前：确认重要的联赛MOD有明确的版本记录，必要时手动存一个版本节点。
  • 更新后：先看系统给出的兼容报告，把“已迁移、待确认”的MOD逐个打开对比差异。
  • 联赛进行中：优先选择让当前赛季沿用旧规则，新赛季再启用迁移版本。
  • 发现规则异常：直接恢复更新前的版本，再让AI基于新版本重新生成需要改动的部分。
  • 多MOD组合：回退任何一个MOD前，先看它被哪些MOD依赖。