re:Blue Hook机制深度剖析:REX_FUNC与midasm_hook如何精准改写游戏引擎

原创2026-10-27 17:59:281,829 阅读

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 配置) 单条指令 任意存档、改帧率逻辑、扩展主菜单

re:Blue Hook机制(REX_FUNC与midasm_hook)改写引擎后带来的自定义安装向导与菜单界面

由 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++ 负责"做什么":

  1. 函数表:config/functions.toml —— 地址命名;
  2. 函数级 Hook:REX_HOOK / REX_HOOK_RAW(如 src/engine/game_options.cpp、src/vfs/disc_io.cpp);
  3. 指令级 Hook:config/hooks/ 下的 23 个 TOML(guest_debug、disc_io、hud_fade、output_resolution、pso_predictor…),生成 dispatch 后调用对应 C++ 函数;
  4. 构建保障: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 主机游戏"变成了一件工程化、可配置、可维护的事——这正是静态重编译相对传统模拟器的独特优势:你改的不是模拟层,而是游戏本身。

登录后查看全文
reblue