《天国：拯救2》模组合并工具带图形界面MOD

《天国：拯救2》模组合并工具带图形界面MOD以直观图形界面为核心，实现多MOD的一站式整合打包，通过智能合并本地化文件、打包零散数据、优化存档结构，解决MOD冲突、加载顺序混乱等核心痛点，让玩家无需复杂操作即可畅享海量MOD组合的沉浸式体验。​

前置MOD

Brain>>>点击查看

Hands>>>点击查看

Python 3>>>点击查看

安装方法：

将文件夹放置在游戏目录下的 Mods 文件夹内。

卸载步骤：

直接删除MOD文件即可。

模组合并工具带图形界面MOD说明：

核心功能与特性

1、智能本地化合并

多语言支持：与仅处理英文的旧工具不同，本程序会扫描所有本地化 PAK 文件(例如：French_xml.pak, English_xml.pak, Czech_xml.pak 等)。

XML 节点合并：从本地化存档中提取 XML 文件，解析它们，并在内存中合并 XML 树。这确保模组 A 和模组 B 的文本字符串能同时在游戏中出现。

内存优化：合并过程在内存中进行;工具直接创建最终的 Localization/*.pak 文件，而无需向磁盘写入数千个临时 XML 文件。

2、高级数据处理(PAK 文件与松散文件)

松散文件打包 (zzz_merged_loose.pak)：

工具会检测非位于 .pak 内的“松散”文件(即文件夹中的原始 .xml、.dds、.tbl 文件)。

它自动将这些文件打包到一个名为 zzz_merged_loose.pak 的新存档中。

优先级逻辑：zzz_ 前缀确保该存档在 CryEngine/KCD2 引擎中最后加载，保证你的松散文件覆盖优先级高于原版数据或其他已打包的模组。

智能去重：

在打包松散文件之前，工具会检查各模组间的重复项。

性能：它首先比较文件大小。只有在大小匹配时才计算 SHA-256 哈希值。这极大减少了对大型模组的处理时间。

冲突解决：如果两个模组修改了同一个松散文件，将应用“后写优先”策略(基于按字母顺序的模组文件夹顺序)，并记录冲突。

现有 PAK 文件管理：

源模组中现有的 .pak 文件会被复制到输出目录。

冲突避免：如果在两个不同模组中同时存在 textures.pak，它们会自动重命名(例如 textures_ModName.pak)以防止覆盖。

3、模组清单生成

自动生成有效的 mod.manifest XML 文件。

允许通过 GUI 输入自定义元数据：名称、模组 ID、描述、作者、版本。

自动以 ISO 8601 UTC 格式生成时间戳作为创建日期。

4、用户体验与安全性

排除过滤器：支持通配符过滤(例如 _*)，以在合并过程中排除备份文件夹、隐藏文件或特定模组。

GUI 验证：如果关键路径缺失或字段为空，则阻止合并运行。

安全检查：如果输出目录非空，会警告用户，以防止意外数据丢失。

确定性顺序：模组按字母顺序处理，以确保每次构建结果的一致性。

局限性

XML 合并策略(仅追加)：

工具通过将节点从一个文件追加到另一个文件来合并 XML。它不执行“深度”逻辑合并或特定 XML 行内的冲突解决。

示例：如果模组 A 设置 RPG 参数 strength=5 而模组 B 设置 strength=10，两项条目都可能被写入 XML。游戏引擎通常会读取最后加载的条目。

二进制文件冲突：

工具无法合并二进制文件的内容(例如现有 PAK 内的纹理)。它并排复制 PAK 文件。如果两个 PAK 包含完全相同的内部文件路径，引擎会根据 PAK 名称/加载顺序决定加载哪一个。

加密存档：

工具假定使用 KCD/CryEngine 的标准 Zip 压缩(Deflate)。它不支持加密或自定义格式的 PAK 文件(尽管这在模组中很罕见)。

松散文件优先级：

松散文件相对于本工具生成的 PAK 文件具有优先级(因为 zzz 名称)，但用户应注意，游戏根目录中的松散文件仍可能覆盖模组文件，具体取决于游戏特定的加载行为。

运行方法

选项 A：Windows

确保已安装 Python 3(安装时勾选“Add Python 3 to PATH”)。

双击 RunModMerge.cmd。

启动器会自动检查 Python 3 和 Tkinter。

选项 B：Linux

确保已安装 Python 3 和 Tkinter：

Ubuntu/Debian：sudo apt install python3 python3-tk

Arch：sudo pacman -S python tk

使脚本可执行：chmod +x RunModMerge.sh

运行脚本：./RunModMerge.sh

选项 C：直接使用 Python 运行

在文件夹中打开终端/命令提示符并运行：python3 ModMerge.py

使用指南

模组源文件夹：选择存放你解压后模组的文件夹。

结构：SourceFolder -> ModName -> Data/Localization

输出包文件夹：选择你想要放置结果的根文件夹。

工具会使用你提供的 Mod ID 创建一个子文件夹。

设置：

排除过滤器：(可选)输入模式如 _* 以跳过以下划线开头的文件夹。留空则包含所有内容。

清单信息：填写模组详情(名称、ID、版本等)。

合并：点击 MERGE MODS 按钮。

结果：

进入输出文件夹。

将生成的文件夹复制到你的游戏 Mods 目录中。

面向模组作者的详细信息

松散文件打包：工具创建 Data/zzz_merged_loose.pak。此命名约定是为了利用 CryEngine 按字母顺序加载的特性，确保这些文件覆盖更早的资产。

哈希算法：SHA-256(64KB 块)仅在文件大小不同时使用，确保在 HDD 和 SSD 上实现最大 I/O 性能。

多线程处理：合并过程在单独的线程中运行，以保持 UI 响应(GUI 不会卡住)。

使用反馈：

如果您在使用过程中出现错误或者希望有更多mod，欢迎在下方评论区反馈，感谢使用！