骑砍2mod中自定义字段如何持久化保存？

Question

在开发《骑马与砍杀2：霸主》Mod时，如何将自定义字段（如角色新增属性、阵营状态等）实现持久化保存是一个常见难题。游戏原生存档系统不直接支持Mod添加的字段，若仅在内存中维护，重启或读档后数据将丢失。开发者常通过重写序列化逻辑、挂钩存档/读档事件或利用SaveGame类扩展来实现持久化。但面临版本兼容性差、字段结构变更导致旧存档崩溃等问题。如何安全地注册自定义数据并确保跨版本稳定读写，成为Mod长期维护的关键挑战。

Answer 1

一、问题背景与核心挑战

在开发《骑马与砍杀2：霸主》Mod过程中，实现自定义字段的持久化是确保Mod功能完整性的关键环节。游戏原生存档系统基于TaleWorlds引擎的序列化机制，仅对官方定义的对象结构进行处理，无法自动识别Mod新增的属性（如角色隐藏技能值、阵营亲密度、特殊状态标记等）。

若开发者仅在内存中维护这些数据（例如通过静态字典缓存），一旦玩家退出或读档，所有扩展信息将丢失，导致逻辑断裂甚至崩溃。因此，必须介入存档/读档流程，将自定义数据安全地嵌入到存档文件中。

二、常见技术路径分析

1. 重写对象序列化逻辑：通过继承或反射修改目标类（如Hero、Clan）的序列化行为，手动添加字段写入/读取操作。
2. 挂钩SaveGame事件：利用引擎提供的OnBeforeSave和OnAfterLoad事件，在存档前后注入自定义数据的保存与恢复逻辑。
3. 使用SaveGameManager扩展：创建独立的数据容器类，并注册为可序列化的子模块，由引擎统一管理其生命周期。
4. 外部存档映射表：将自定义数据存储于独立文件（如JSON、SQLite），通过GUID关联游戏角色，规避原生结构限制。

三、典型实现方案对比

方案	兼容性	维护成本	版本迁移难度	性能开销	推荐场景
重写序列化	低	高	极高	中	短期项目，结构稳定
事件挂钩	中	中	中	低	通用型Mod
SaveGame扩展	高	低	低	低	长期维护Mod
外部映射表	极高	中	低	中	跨Mod共享数据

四、深度解决方案：基于SaveGameExtension的安全持久化

推荐采用SaveGameExtendedData机制，该方式符合TaleWorlds设计规范，具备良好的向后兼容能力。核心步骤如下：

public class ModSaveDataProvider : SaveGameExtendedData
{
    private Dictionary<string, CustomHeroData> _heroData = new();

    public override void OnBeforeSave()
    {
        _heroData.Clear();
        foreach (var hero in Hero.All)
        {
            if (hero.HasModData())
                _heroData[hero.StringId] = hero.GetModData();
        }
    }

    public override void OnAfterLoad()
    {
        foreach (var kvp in _heroData)
        {
            var hero = Hero.FindFromId(kvp.Key);
            if (hero != null)
                hero.SetModData(kvp.Value);
        }
    }

    public override Type GetFactoryType() => typeof(ModSaveDataFactory);
}
    

五、版本兼容性保障策略

• 使用版本号标记：在序列化数据中加入DataVersion字段，用于判断结构变更。
• 实施反序列化容错机制：捕获SerializationException并尝试降级加载或默认初始化。
• 引入数据迁移管道：当检测旧版本数据时，自动转换至新格式。
• 避免依赖私有字段序列化，优先使用公共契约接口。
• 定期生成测试存档，验证跨版本读取稳定性。

六、高级架构设计：模块化持久层

为提升可维护性，建议构建分层架构：

graph TD
    A[Mod业务逻辑] --> B[持久化服务接口]
    B --> C[SaveGameExtension实现]
    B --> D[外部存储适配器]
    C --> E[引擎存档系统]
    D --> F[JSON/SQLite文件]
    G[版本管理器] --> C
    G --> D
    H[数据迁移器] --> G
    

七、实战注意事项与最佳实践

1. 始终启用XmlSerializer兼容模式以支持复杂类型。
2. 避免在OnAfterLoad中执行耗时操作，防止卡顿。
3. 对集合类字段使用[XmlElement]而非[Serializable]提高控制粒度。
4. 记录每次数据结构变更的日志，便于回溯。
5. 使用Guid而非索引作为唯一标识符。
6. 在开发阶段开启存档校验功能，及时发现序列化异常。
7. 提供“清除Mod数据”选项，方便用户调试。
8. 测试多Mod共存场景下的数据隔离性。
9. 关注TaleWorlds官方更新日志，预判API变动。
10. 建立自动化回归测试套件，覆盖主流存档路径。