GRB模组管理器

GRB Mod Manager

版本 1.2.6 — 便携版

概述

GRB Mod Manager 是一款面向 Windows 桌面的应用程序，专为 Ghost Recon Breakpoint 打造，用于解决常见的模组问题：两个模组修改同一个游戏存档，最后安装的那个会覆盖前一个。兼容的模组不会相互覆盖，而是在资源级别进行合并；而真正不兼容的条目会被报告为冲突，由你选择保留哪一个。

该管理器会自动检测你的游戏安装位置，直接导入模组存档，重建受影响的 ​.forge 存档（支持一键回滚），并将 Cheat Engine ​.ct 表应用到正在运行的游戏，无需安装 Cheat Engine。

一切均为便携式：无需安装程序，不写入注册表键，你的模组、配置和备份在应用更新后依然保留。

主要功能

智能冲突解决

• ​.data 容器会按 ClassID 逐资源深度合并，因此两个模组的修改都能保留。
• BuildTable 和 Database 资源会合并到它们所指向的共享容器中（ ​DBContainerEntry_…、 ​Game Bootstrap Settings、 ​TEAMMATE_Template 等）。
• 单资源条目——网格、纹理、材质、骨骼、原始数据库条目和原始 forge 载荷——无法有意义地合并，需通过选择获胜模组来解决。
• 重新排序模组以更改优先级。冲突分析会实时更新。
• 重复的资源 ID 由最高加载顺序决定。

直接导入模组

• 导入 ​.zip、 ​.7z、 ​.rar、 ​.tar、 ​.gz、 ​.tgz、 ​.bz2、 ​.xz、 ​.cab、 ​.iso 存档或普通文件夹。
• 嵌套存档会自动解压。
• 大型 ​.data 文件通过范围读取（仅读取文件头和第一个块）进行检查，因此数兆字节的纹理会瞬间完成分类，而无需加载整个文件。
• 可识别 ATK 导出文件，包括放在 ​... .data 文件夹中的类型化资源，以及 ​<Name>.forge/ 文件夹内的原始 forge 载荷。
• 带有 ​.MetaFile 或 ​.PrefetchInfo 等扩展名的未知原始载荷会被部署到匹配的 forge 条目，而不是被忽略。
• 附带 Wwise ​.pck 包音频模组会安装到 ​sounddata\pc\ 并完整备份。

安全部署与回滚

• Deploy Loadout 会按照零售版布局重建受影响的 forge 存档，然后重新读取并验证新索引，之后才视为部署成功。
• Restore Vanilla 会返回到部署前记录的精确状态。
• 备份是条目级清单（原始偏移量、长度、信息记录和样本哈希），而不是完整的多 GB forge 副本，因此回滚快速且节省磁盘空间。
• 每个被修改的条目都会保留原始 blob 字节，因此即使存档被重写，恢复仍然保持字节精确。
• 部署或恢复时游戏必须关闭。

原生作弊表支持

• 将 Cheat Engine ​.ct 表应用到正在运行的游戏——无需安装 Cheat Engine。
• 支持字节、2/4/8 字节、浮点、双精度、字符串、Unicode 字符串、字节数组、位字段、组和指针链。
• 支持实用的 Auto Assembler 子集： ​aobscan、 ​aobscanmodule、 ​aobscanregion、 ​alloc/ ​globalalloc/ ​dealloc、 ​registersymbol/ ​unregistersymbol、 ​assert、 ​define、 ​label、 ​nop、直接内存补丁和 x86-64 代码洞穴。
• 代码洞穴由内置的 x86-64 汇编器在写入任何一个字节之前完成汇编。
• 脚本会记住其状态和参数，并在每次附加后自动重新应用。
• 支持 ​GRB.exe 和 ​GRB_UPP.exe。Vulkan 变体会被拒绝并给出明确提示。
• 当作弊被禁用、管理器关闭或游戏退出时，一切都会自动恢复。

界面

• 现代战术 UI，提供深色、浅色和跟随 Windows 主题。
• 九种语言：英语、法语、德语、西班牙语、意大利语、葡萄牙语、俄语、中文和日语。
• 减少动态效果模式。

系统要求

• Windows 10 或 11，64 位。
• 通过 Ubisoft Connect 安装的 Ghost Recon Breakpoint。
• 管理员权限：应用会写入游戏文件夹并读取游戏内存。启动时会弹出 UAC 提示。
• 部署或恢复时游戏必须关闭，应用作弊表时游戏必须运行。

安装

1. 将存档解压到任意位置。
2. 运行 ​GRB Mod Manager-1.2.6-portable.exe 并接受 UAC 提示。
3. 不会安装任何内容，也不会写入注册表键。

模组、配置和备份存储在 ​%APPDATA%\grb-mod-manager。

启动新版本前请关闭任何旧版本：同一时间只能运行一个实例。

快速开始

1. 启动管理器并让其检测游戏。如果检测失败，打开 Settings → Game installation → Browse 并选择包含 ​GRB.exe 的文件夹。
2. 使用 Import Mods 或拖放来导入模组。
3. 查看 Conflicts 视图，必要时重新排序模组。
4. 关闭游戏，然后点击 Deploy Loadout。
5. 要返回原版，点击 Restore Vanilla。
6. 对于作弊功能，启动游戏，导入 ​.ct 表并点击 Apply。

工作原理

• ​.forge 存档使用针对 Scimitar 容器格式的自定义读写器：文件集、偏移量表和 192 字节信息记录，索引最后写入并在写入后验证。
• ​.data 容器使用 ​CompressedFileData 解析器/构建器；资源按 ClassID 合并。
• 压缩通过 ​koffi FFI（Oodle，32 KB 块）使用游戏自带的 ​oo2core_7_win64.dll。
• 存档使用捆绑的 ​7za.exe 和 ​node-unrar-js 处理。
• 作弊表使用无依赖的 XML 读取器、Auto Assembler 解析器、小型 x86-64 汇编器以及基于 ​koffi 构建的 Win32 内存层。

当前限制

• 访问游戏内存的 Lua 块（ ​writeBytes、 ​readInteger、 ​createThread、 ​autoAssemble 等）不会被执行。仅用于配置 Cheat Engine 的 Lua 会被忽略，该条目会被标记为在游戏内没有可应用的内容。
• 内置汇编器子集之外的指令（特殊 SIMD、 ​rep 前缀字符串操作、x87）不受支持。
• 为旧版游戏构建编写的表可能会 AOB 扫描失败。在这种情况下不会写入任何内容。
• 杀毒软件可能会标记任何写入其他进程内存的工具。如有需要，请将便携版可执行文件加入白名单。
• 作弊仅修改 ​GRB.exe 内存，绝不会写入游戏文件，因此重启游戏后会恢复为原版数值。

版本 1.2.6 亮点

• 原始 forge 载荷（ ​.MetaFile、 ​.PrefetchInfo、未知扩展名）现在会被部署，而不是被忽略。
• 修复了来自 “REQUIRED - RESOURCES PATCH 01” 模组的两条警告。
• 现有模组会在首次启动时自动重新扫描，无需重新导入。
• 对使用相同布局的未来 ATK 导出文件提供通用支持。

故障排除

症状	修复方法
“Write access” 显示为红色	以管理员身份运行；探测会写入真实的 forge
部署拒绝启动	关闭 GRB.exe 和 Ubisoft Connect 覆盖层
缺少 oo2core_7_win64.dll	在 Ubisoft Connect 中验证游戏文件
RAR 导入失败	使用未设置密码保护的存档
“Launch Ghost Recon Breakpoint first”	启动游戏并等待进入主菜单
某个作弊项灰显为 “Unsupported”	内存 Lua、不支持的指令或无法映射的变量类型
“AOB pattern not found”	该表针对旧版游戏构建；未写入任何内容
杀毒软件标记便携版	对未签名的 Electron 构建而言属正常现象；请将其加入白名单

---

GRB Mod Manager 是一款非官方社区工具，与 Ubisoft 无关联。