re:Blue Hook机制深度剖析:REX_FUNC与midasm_hook如何精准改写游戏引擎
re:Blue Hook机制深度剖析:REX_FUNC与midasm_hook如何精准改写游戏引擎
re:Blue 是一个《蓝光/Blue Dragon》(Xbox 360)的**静态重编译(static recompilation)**项目:它不模拟主机,而是把原版 PPC 代码翻译成原生代码直接运行,并借助 Hook 机制精准改写引擎行为,从而实现 4K 分辨率、解锁帧率、任意地点存档等原生功能。本文将从 REX_FUNC 到 midasm_hook,带你读懂 re:Blue 的 Hook 系统是如何"外科手术式"地改写游戏引擎的。
为什么 Hook 是 re:Blue 的核心
重编译项目面临一个特殊问题:原版代码是"黑盒"——开发者没有源码,只有一份被重新编译、可直接执行的引擎镜像。想给它加新功能,最干净的办法就是在关键位置挂钩子:要么整体接管某个函数,要么在某一条指令处"插一脚"。
re:Blue 的 Hook 体系正好分成这两层,对应两套完全不同的设施:
| 层级 | 机制 | 粒度 | 典型场景 |
|---|---|---|---|
| 函数级 | REX_FUNC / REX_HOOK / REX_HOOK_RAW |
整个函数 | 重定向存档、接管 CRT 调用 |
| 指令级 | midasm_hook(TOML 配置) |
单条指令 | 任意存档、改帧率逻辑、扩展主菜单 |
由 Hook 机制深度融入引擎后,re:Blue 能直接改造游戏的安装与菜单流程(上图为安装向导界面)
第零步:给地址取名字(functions.toml)
一切 Hook 的前提是知道"这个地址是什么函数"。re:Blue 用一份巨大的函数表来建立 PPC 虚拟地址 → 函数名 的映射,见 config/functions.toml:
[functions]
0x822B8DF0 = { name = "Chara__Update" }
0x824046C0 = { name = "issCamera__Update" }
0x820C54B0 = { name = "bdMainLoop" }
全表超过 1600 行,从角色更新到主循环(bdMainLoop)一应俱全。构建系统(CMakeLists.txt)会基于这张表做 codegen,生成头文件供 Hook 代码引用——Hook 代码里写的永远是"函数名",而不是裸地址,可维护性由此而来。
函数级 Hook:REX_FUNC 与 REX_HOOK
REX_FUNC:声明"有意为之的空实现"
在 src/core/hooks.h 中,REX_FUNC(subroutine) 是底层宏:它声明一个 extern "C" 函数,参数是重编译运行时传入的寄存器上下文 ctx 与内存基址 base。项目用它封装了两个便捷宏:
BD_NOOP—— 把一个重编译函数变成静默的 no-op(不产生日志),用于宿主机无需模拟的调用;BD_NOOP_RETURN—— 同样的 no-op,但往r3返回一个常量,供调用方判断结果。
这两个宏是"函数级 Hook"的骨架:接管一个函数后,你可以选择什么都不做,也可以返回固定值。
REX_HOOK:整体接管一个函数
REX_HOOK(原函数名, 你的C++函数) 把原版函数完全替换为你的实现。例如 src/core/guest_crt.cpp 直接用标准库接管了数学函数:
REX_HOOK(rex_atan2, GuestAtan2);
REX_HOOK(rex_atof, GuestAtof);
更典型的例子是存档系统。原版《Blue Dragon》的存档走 Xbox 360 的 XAM 内容管理器,在宿主机上这条路根本不存在,于是 src/engine/save/save_hooks.cpp 用 Hook 把 XContentCreate 系列调用整体重定向到本地存档目录;save_hooks.cpp 又接管了 ContentTask__OnDeviceSelected 等枚举函数,让"读取存档"列表直接扫描宿主机的 profiles\default\。
REX_HOOK_RAW:直接操作寄存器的"裸"Hook
REX_HOOK_RAW(name) { ... } 拿到的是原始寄存器上下文(ctx.r3、ctx.r4…),适合需要精细控制或有条件回落到原版的场景。比如 save_hooks.cpp 中的 rex_XContentCreateWrapper:
REX_HOOK_RAW(rex_XContentCreateWrapper) {
if (!root || std::strncmp(root, "save", 5) != 0 || !content) {
__imp__rex_XContentCreateWrapper(ctx, base); // 非存档请求:交还原版
return;
}
// "save" 根:改走本地存档槽
}
这个"先判断、必要时放行"的模式在音频(src/audio/mix.cpp)、输入(src/engine/virtual_buttons.cpp)等模块反复出现,是函数级 Hook 精准性的关键。
💡 一个容易踩坑的细节:CMakeLists.txt 特意把公共代码编成 OBJECT 库而非静态库,注释写明原因——"an archive drops the REX_HOOK symbols"(静态归档会丢弃未引用的 REX_HOOK 符号)。这是保证每个 Hook 都被链接进最终二进制的工程保障。
指令级 Hook:midasm_hook 配置详解
函数级接管有时还不够——有些逻辑埋在某个大函数中间,你只想改其中一条指令的判断。这就是 config/hooks/ 目录下的 midasm_hook(mid-instruction assembly hook)登场的位置。全项目共有 23 个 TOML 文件、上百个 Hook 点。
配置格式:五个字段定一个 Hook
每个 <a href="https://link.gitcode.com/i/6f2547ad68c06bde20b6d94ff59176eb" target="_blank">[midasm_hook]] 块(以 [config/hooks/save.toml 为例):
[[midasm_hook]]
address = 0x822D7640 # 插入点:原版函数内某条指令的地址
name = "bdCampSaveAnywhereHook" # 对应的 C++ 函数名
registers = [] # 作为参数传给 C++ 函数的寄存器
after_instruction = false # 在该指令执行前(false)或后(true)触发
jump_address_on_true = 0x822D7694 # C++ 返回 true 时,跳转到此地址
工作模型非常清晰:运行时执行到 address 这条指令时,暂停 PPC 流,调用由 name 指定的 C++ 函数(参数由 registers 列表从寄存器中取值);函数返回 true 时,可选地跳到 jump_address_on_true——等效于改写了原版的分支走向。
以"营地任意存档"为例,注释说明原版 Camp_IsSaveAvailable(0x822D7630)会扫描范围内是否存在存档点,而 Hook 点选在函数序言之后、跳转前:C++ 侧只需一行——
// src/engine/save/save_hooks.cpp
bool bdCampSaveAnywhereHook() {
return bd::engine::Settings::Get().SaveAnywhere();
}
返回 true 就跳到函数自带的 li r3,1("返回可用")路径,不动任何原字节,仅改变控制流。
帧率解锁:批量"拆除"Tick 闸门
解锁帧率的难点在于原版大量逻辑写死了 30fps 的 tick 节奏。config/hooks/frame_interp.toml(469 行,全项目最大的 Hook 配置)里,bdTickGateHook 被重复挂载在几十个地址上:
[[midasm_hook]]
address = 0x82433570
name = "bdTickGateHook"
registers = []
jump_address_on_true = 0x82433574 # 跳过下一条指令(tick 等待)
jump_address_on_true 指向地址 +4,即直接跳过一条指令——这正是 midasm_hook 的精髓:跳过的不是函数,而是"节拍器"。Hook 本体实现于 src/engine/frame_interp.cpp,配合 src/engine/frame_clock.cpp 构成完整的帧率/插帧系统。
主菜单扩展:往原版导航里塞新行
config/hooks/title_menu.toml 展示了更复杂的多点配合:一个 Hook 扩大光标边界(bdTitleNavBoundsHook),一个 Hook 拦截 A 键派发、true 时跳到引擎派发之外的自定义分支(bdTitleModsDispatchHook,带 jump_address_on_true),还有 6 处同名的 bdTitleActionButtonHook 挂在不同的 r5 寄存器读取点上,保证自定义行(配置/调试菜单/退出)对确认键和取消键都响应正确。Hook 本体在 src/engine/menus/title_menu.cpp。
一张表看懂:从配置到落地
每个 Hook 点由两部分协作,TOML 负责"在哪、拿什么",C++ 负责"做什么":
- 函数表:config/functions.toml —— 地址命名;
- 函数级 Hook:
REX_HOOK/REX_HOOK_RAW(如 src/engine/game_options.cpp、src/vfs/disc_io.cpp); - 指令级 Hook:config/hooks/ 下的 23 个 TOML(
guest_debug、disc_io、hud_fade、output_resolution、pso_predictor…),生成 dispatch 后调用对应 C++ 函数; - 构建保障:OBJECT 库 +
reblue_codegen依赖(CMakeLists.txt),确保所有 Hook 符号进入最终可执行文件。
总结:精准,是 re:Blue 的答案
re:Blue 的 Hook 机制可以概括为三级武器:
- 🎯 REX_FUNC / BD_NOOP:把重编译函数标记为可控的空实现;
- 🎯 REX_HOOK / REX_HOOK_RAW:整体接管函数,且能按条件"放行原版";
- 🎯 midasm_hook:在任意一条指令处插入 C++ 逻辑,用
jump_address_on_true改写控制流,最小代价、最大精度。
得益于 ReXGlue SDK 提供的重编译运行时(rex/hook.h、rex/ppc.h 等头文件被预编译进每个编译单元),re:Blue 把"修改一台 360 主机游戏"变成了一件工程化、可配置、可维护的事——这正是静态重编译相对传统模拟器的独特优势:你改的不是模拟层,而是游戏本身。
