圣甲虫 - MW5资源目录生成器

Scarab 是一个独立的 Windows x64 实用工具，可从本地安装的《机甲战士 5：雇佣兵》生成结构化资源目录。

它会发现基础游戏资源以及 MW5 当前启用的模组，按游戏合并顺序扫描其 pak 文件，并生成描述该安装中可用物品、机甲、原装机甲模板以及飞行员或机甲特性的目录。

Scarab 主要设计为存档编辑器及其他需要准确 MW5 资源数据的工具的后端和开发实用程序。[url=https://www.nexusmods.com/mechwarrior5mercenaries/mods/1466]JJ 的《机甲战士 5：雇佣兵》存档编辑器[/url] 使用 Scarab 作为其目录生成后端，但 Scarab 是独立维护和分发的。

[color=#00ffff][size=4]JJ 的 MW5 存档编辑器用户请注意[/size][/color]

JJ 的 MW5 存档编辑器的普通用户无需手动操作 Scarab，除非编辑器或其文档特别指示这样做。编辑器会自动管理 Scarab。请遵循编辑器文档中关于放置 scarab.exe 文件位置的要求。

[color=#00ff00][size=4]SCARAB 的功能[/size][/color]

Scarab 可以：

• 扫描 MW5 基础游戏和已启用的模组 pak 文件 • 检测 MW5 当前启用的模组 • 遵循模组加载顺序 • 生成物品目录 • 生成机甲目录 • 生成原装机甲模板 • 生成飞行员和机甲特性目录 • 生成压缩 JSON、纯 JSON 或 Python 兼容输出 • 使用现有的受信任目录包作为基础层，并将已启用模组合并到其上

Scarab 仅读取游戏和模组数据。它不会修改 MW5 文件、模组文件、存档、模组配置或游戏已启用模组列表。 它不使用 Steam API，也不要求访问 Steam 账户。

[color=#ff0000][size=4]SCARAB 不是[/size][/color]

Scarab 不是：

• 一个游戏玩法模组 • 一个存档编辑器 • 一个 pak 浏览器 • 一个通用资源浏览器

[color=#00ffff][size=4]安装[/size][/color]

1. 下载 Scarab 压缩包。
2. 将所有文件解压到一个普通可写目录。
3. 不要将 Scarab 放入 MW5 的 Mods 目录。
4. 从 PowerShell、命令提示符或与 Scarab 集成的程序运行 scarab.exe。

基本命令：

[code]scarab.exe --mw5-dir "D:\Path\To\MW5Mercs" --output generated-catalog[/code] 输出路径必须相对于包含 scarab.exe 的目录。

运行：

[code]scarab.exe --help[/code] 以获取完整选项列表和支持的目录格式。

[color=#ffff00][size=4]发布验证[/size][/color]

官方 Scarab 发布包含多种形式的完整性和来源信息：

• 一个经过 Authenticode 签名并带时间戳的 Windows 可执行文件 • 一个 SHA-256 校验和文件 • 一个与确切可执行文件哈希绑定的 VirusTotal 发布清单 • 一个不可变的 GitHub Release • GitHub 发布来源和证明信息

发布流程要求完成 VirusTotal 结果报告，且零恶意和零可疑检测后才能发布。

VirusTotal 结果是发布时的额外证据，并不绝对保证软件没有恶意行为。

[color=#00ffff][size=4]系统要求[/size][/color]

• Windows x64 • 本地安装的《机甲战士 5：雇佣兵》 • 读取所选 MW5 安装的权限 • 在 Scarab 输出位置创建文件的权限

[color=#00ff00][size=4]支持[/size][/color]

Scarab 的错误和功能请求通过公开的 Scarab GitHub 仓库处理。公开仓库还包含 Scarab 的完整文档。

报告目录生成问题时，请包含 Scarab 版本、所使用的命令或选项、相关控制台输出，以及可用时的诊断文件 catalog_build_report.json。

提交报告时，请勿上传受版权保护的 MW5 游戏资源或完整的商业游戏 pak 文件。

[color=#ff00ff][size=4]项目链接[/size][/color]

Scarab 项目页面、源代码和完整文档： [url=https://github.com/FiendishDrWu/Scarab]GitHub 上的 Scarab[/url] 错误报告和功能请求： [url=https://github.com/FiendishDrWu/Scarab/issues]Scarab 问题跟踪器[/url] 安全信息以及 Scarab 签名发布流程的详细信息： [url=https://github.com/FiendishDrWu/Scarab/blob/main/SECURITY.md]安全和发布验证政策[/url] Scarab 被用作以下项目的资源目录生成后端： [url=https://github.com/jonayetjubaer-cmyk/JJs-MW5-Merc-Save-Editor]JJ 的《机甲战士 5：雇佣兵》存档编辑器[/url]

项目状态

Scarab 是一个独立实用工具。它不是 Piranha Games、EG7、Microsoft 或 Nexus Mods 的官方产品，也不是 JJ 的《机甲战士 5》存档编辑器的一部分。