X4 解包工具

杀毒软件警告说明： 读取游戏存档和扫描 Windows 注册表的工具往往会触发杀毒软件的启发式检测——这纯粹是这类工具的功能特性。源代码在 GitHub 公开，您可以自行验证，且上传内容已通过 Nexus 审核批准。

两个工具，同一项任务：从 X4 的 .cat/.dat 压缩包中提取文件。无论你想要一个点击式界面，还是能放入批处理脚本的工具，这里都有相应的可执行文件。两者都能自动处理补丁顺序。如果文件出现在多个目录中，你将始终获取最新版本。签名文件（_sig.cat）会被忽略，零字节删除条目会被跳过。

X4 解包器图形界面.exe

双击即可运行。如果你不确定具体需要什么，或者只想在提取前浏览一下，GUI 是更好的起点。

当它打开时，会通过检查常规的 Steam、GOG 和 Epic 路径以及注册表自动找到你的 X4 安装位置。然后你可以选择要提取的内容：

• 内容选择 — 基础游戏与各 DLC/扩展包分开列出，以便你只勾选所需内容
• 实时大小估算 — 随着您更改选择而实时更新，让您在点击"开始"前就能了解存储成本
• 筛选配置文件 — 一键预设常见需求（标准文本文件、所有文件、所有文件除音频外）、特定扩展名的复选框列表，以及用于自定义内容的原始正则表达式字段
• 进度追踪 — 可滚动日志、传输速度、进度条和预计剩余时间
• 附加选项 — 线程数、强制覆盖开关，以及复制当前活跃扩展的 content.xml 文件的选项

X4unpackerCLI.exe

Run it with no arguments and it walks you through setup step by step. Same auto-detection, same filter options, just in your terminal. Run it with arguments and the wizard is skipped entirely, which is what you want for batch scripts or anything automated.

语法

X4unpackerCLI.exe [选项] <模式> <来源> <命令> [过滤器] [<目标目录>]

模式

• file — 指定特定的 .cat 文件（或通过通配符指定文件）
• 文件夹 — 仅扫描源目录的根目录
• all_folders — 遍历整个目录树，包括 extensions/ 下的 DLC 文件夹

source — 指向 .cat 文件或游戏/模组目录的路径

命令

• x — 将匹配的文件提取到目标目录
• ls — 列出匹配的文件及其大小，不写入磁盘

过滤器 — 在目录中匹配的内容。可以是通配符（.xml、assets/textures/.dds）或路径前缀（assets/units）。如需使用正则表达式，请通过向导或图形界面操作。

dest_dir — 提取文件的存放位置。x 需要此参数，ls 忽略此参数。

选项

• -t / --threads （默认值：4） — 1–2 用于机械硬盘，4–6 用于 SATA 固态硬盘，8+ 用于 NVMe
• -f / --force — 覆盖已经存在的文件。不使用此选项时，已存在的文件会被跳过，以便您可以安全地继续部分运行。

示例

列出根目录下的每个 .xml 文件，不提取任何内容：

X4unpackerCLI.exe 文件夹 "C:\...\X4 Foundations" 列出 "*.xml"

仅从单个目录中拉取 .lua 文件：

X4unpackerCLI.exe file "C:\...\X4 Foundations\01.cat" x "*.lua" "C:\X4_Unpacked"

使用 8 个线程从整个游戏目录（基础版 + DLCs）中提取所有 .xml 文件：

X4unpackerCLI.exe all_folders "C:\...\X4 Foundations" x "*.xml" "C:\X4_Unpacked" --threads 8

提取特定资源路径下的所有内容：

X4unpackerCLI.exe all_folders "C:\...\X4 Foundations" x "assets/units" "C:\X4_Unpacked"

补丁覆盖如何工作

.cat 文件按顺序处理。如果同一个内部文件同时出现在 01.cat 和 09.cat 中，则以 09.cat 中的条目为准——你总是得到游戏实际加载的版本。零字节条目（标记为补丁删除的文件）会被检测并跳过。

免责声明 此工具并非由 Egosoft GmbH. 'X4: Foundations' 和 'Egosoft' 是 Egosoft GmbH. 的商标。 所有提取的游戏素材均为 Egosoft GmbH 的知识产权。 本软件按"原样"提供，不提供任何形式的明示或暗示。使用后果自负。开发者不承担任何损坏责任、数据丢失，或因使用此工具或修改版本导致的游戏不稳定。请不要就由此产生的问题联系 Egosoft 官方支持。使用此工具的风险自负。