七日杀 V3.0 是一次重大版本更新，V3.1 在此基础上进行了优化。这篇总结梳理了主要变更点和对 MOD 兼容性的影响。
V3.0 主要变更
游戏系统变更
| 系统 | 变更内容 | MOD 影响 |
|---|
| 物品系统 | 物品属性重新平衡 | 武器/工具数值需要重新适配 |
| 技能系统 | Perk 效果调整 | 技能相关 MOD 需要更新 |
| 制作系统 | 制作配方更新 | 制作配方 MOD 需要同步 |
| AI 系统 | 丧尸行为优化 | AI 相关 MOD 可能需要调整 |
| UI 系统 | 界面布局变化 | UI MOD 需要适配新布局 |
XML 配置变更
V3.0 对多个 XML 配置文件进行了结构调整：
<!-- items.xml 变更示例 -->
<!-- 旧版本 -->
<item name="gunPistol">
<property name="CustomIcon" value="pistol"/>
</item>
<!-- V3.0 新版本 -->
<item name="gunPistol">
<property name="CustomIcon" value="pistol"/>
<property name="DisplayType" value="Ranged"/>
<property name="Tags" value="weapon,ranged,pistol"/>
</item>
关键配置项变更
| 配置项 | 变更说明 |
|---|
| Tags | 新增更多标签分类 |
| effect_group | 效果组结构优化 |
| Recipe | 制作配方格式调整 |
| Spawning | 刷新规则参数变化 |
V3.1 优化内容
V3.1 b13 主要更新
| 更新项 | 说明 |
|---|
| 性能优化 | 减少卡顿和掉帧 |
| Bug 修复 | 修复多个已知 Bug |
| 平衡调整 | 部分武器/技能数值微调 |
| 新增功能 | 部分新物品和机制 |
V3.1 配置变化
<!-- V3.1 新增的配置项 -->
<property name="NewFeature" value="true"/>
<!-- 部分旧配置项被弃用 -->
<!-- <property name="DeprecatedSetting" value="xxx"/> -->
MOD 兼容性处理
检查清单
升级到 V3.0/V3.1 后，检查以下内容：
# 1. 检查 MOD 版本说明
cat Mods/*/ModInfo.xml | grep -i version
# 2. 检查 XML 语法错误
grep -r "Error\|error" output_log.txt
# 3. 检查 DLL 加载状态
grep -i "dll\|load" output_log.txt
适配步骤
- 备份当前 MOD 配置
- 更新引用的 Assembly-CSharp.dll
- 重新编译 DLL MOD
- 检查 XML 配置兼容性
- 测试所有功能
常见适配问题
| 问题 | 原因 | 解决方案 |
|---|
| XML 解析错误 | 标签结构变化 | 对照新版本 XML Schema 修复 |
| DLL 编译失败 | API 变更 | 更新引用并修复编译错误 |
| 功能异常 | 数值平衡调整 | 根据新数值重新配置 |
| UI 错误 | 界面布局变化 | 调整 UI 坐标和元素 |
版本迁移建议
从 V2.x 升级到 V3.0
- 大改动：需要全面检查 MOD 兼容性
- 建议：先在测试环境验证，再应用到正式环境
- 时间：预计需要 1-2 天适配时间
从 V3.0 升级到 V3.1
- 小改动：大部分 MOD 直接兼容
- 建议：重点测试修改过的功能
- 时间：预计需要 2-4 小时验证
新建 MOD 的版本策略
- 推荐：同时支持 V3.0 和 V3.1
- 方法：使用版本检测条件加载
- 测试：在两个版本上分别测试
参考来源
