七日杀整合包制作与MOD打包调试指南

当你积累了多个 MOD，就需要学会整合包制作和打包调试。这篇文章讲清楚 MOD 排序、冲突排查和打包发布的完整流程。

整合包概念

整合包是将多个 MOD 打包在一起，提供统一的游戏体验。一个好的整合包需要：

• MOD 之间无冲突
• 版本兼容性好
• 配置统一合理
• 文档说明清晰

MOD 排序规则

加载顺序

七日杀按文件夹名字母顺序加载 MOD。文件夹名越靠后，优先级越高。

Mods/
├── 01-core-mod/      ← 最先加载
├── 02-gameplay-mod/
├── 03-visual-mod/     ← 最后加载

排序原则

命名技巧

用数字前缀控制加载顺序：

01-A00-HarmonyLib/
02-A01-CoreModule/
03-B00-WeaponsPack/
04-B01-ArmorPack/
05-C00-VisualMods/

冲突排查

常见冲突类型

排查步骤

1. 二分法：禁用一半 MOD，逐个启用定位冲突
2. 查看日志：output_log.txt 会记录 MOD 加载信息和报错
3. 对比配置：用文本对比工具检查两个 MOD 的 Config 文件
4. 测试功能：在测试世界中逐个验证 MOD 功能

冲突修复方法

XML 冲突修复

如果两个 MOD 都修改了 items.xml 中的同一物品：

<!-- MOD A 修改了手枪伤害 -->
<item name="gunPistol">
    <effect_group>
        <passive_effect name="EntityDamage" operation="base_add" value="10"/>
    </effect_group>
</item>

<!-- MOD B 也修改了手枪伤害（会被覆盖） -->
<item name="gunPistol">
    <effect_group>
        <passive_effect name="BlockDamage" operation="base_add" value="5"/>
    </effect_group>
</item>

解决方案：创建第三个 MOD 专门合并两者的修改。

DLL 冲突修复

使用 Harmony 的 Priority 属性控制补丁执行顺序：

[HarmonyPatch(typeof(ClassName))]
[HarmonyPatch("MethodName")]
[HarmonyPriority(Priority.High)]
static void Postfix() { }

打包规范

目录结构

MyModPack-v1.0/
├── Mods/
│   ├── mod1/
│   │   ├── ModInfo.xml
│   │   └── Config/
│   └── mod2/
│       ├── ModInfo.xml
│       └── Config/
├── 读我.txt          ← 使用说明
├── 版本说明.txt      ← MOD 列表和版本号
└── 备份/             ← 原版文件备份（可选）

版本说明模板

整合包名称：我的七日杀整合包
版本号：v1.0
兼容版本：V1.0-V1.1

MOD 列表：
1. mod1 v1.2.3 - 功能说明
2. mod2 v2.0.0 - 功能说明
3. mod3 v1.1.1 - 功能说明

已知问题：
- 问题1描述和解决方案

安装方法：
1. 将 Mods 文件夹复制到游戏目录
2. 启动游戏
3. 新建世界

卸载方法：
1. 删除 Mods 文件夹
2. 新建世界（旧存档可能不兼容）

调试技巧

日志分析

# 过滤 MOD 相关日志
grep -i "mod\|dll\|xml" output_log.txt

# 查看加载失败信息
grep -i "error\|fail\|exception" output_log.txt

测试流程

1. 单 MOD 测试：只安装一个 MOD 测试基础功能
2. 组合测试：两两组合测试兼容性
3. 全量测试：安装所有 MOD 测试完整体验
4. 性能测试：监控内存和 CPU 使用率

热重载

服务器端可以使用 reload 命令重新加载 XML 配置（不需要重启）：

# 在控制台输入
reload

注意：DLL MOD 的修改需要重启游戏才能生效。

发布注意事项

• 确保所有 MOD 都有合法的使用许可
• 注明 MOD 原作者和来源链接
• 测试完整的游戏流程
• 提供清晰的安装和卸载说明
• 保留版本历史记录

参考来源

• 七日杀中文MOD网 MOD安装教程：https://www.7risha.com/85010.html
• 版本适配方法：https://www.7risha.com/71668.html
• MOD冲突修复案例：https://www.7risha.com/81907.html