主角的脸为什么是黑的?Fable-2-Recomp纹理变形bug根因与一行hook修复

原创2026-11-14 15:26:112,126 阅读

主角的脸为什么是黑的?Fable-2-Recomp纹理变形bug根因与一行hook修复

Fable-2-Recomp 是一个用 ReXGlue SDK 把 Xbox 360 经典《Fable 2:年度版》(GOTY) 在 PC 上原生运行的开源重编译项目。不少玩家加载存档后发现主角的脸和狗的毛发整片纯黑——这就是著名的纹理变形(Texture Morphing)bug。本文讲清楚它为什么变黑,以及开发者如何用一行 mid-asm hook 把它修好(默认已开启)。

Fable-2-Recomp PC重编译启动器界面,纹理变形bug修复默认已启用

Fable 2 重编译项目的启动器界面,可配置分辨率、渲染缩放、抗锯齿与帧率上限

黑色主角的脸:这个 bug 长什么样?

运行游戏并加载存档后,你会看到:

  • 🖤 主角的脸部、狗的身体渲染成纯黑,没有贴图细节
  • 其他角色、场景、UI 显示完全正常
  • 不崩溃、不卡死,纯粹是"贴图是黑的"

这不是渲染管线崩了,而是一个内存架构问题——下面拆解它的完整根因。

根因分析:主角的脸不是图片,是"实时画出来的"

纹理变形:一张脸是怎么拼出来的

主角的皮肤贴图(年龄、善恶值、疤痕、妆容……)并不是打包在游戏里的静态图片,而是由游戏的 **Texture Morphing(纹理变形/混合)**系统在运行时把多层效果叠加"画"出来的。每次外观变化——读档、换装、善恶值改变——都会触发一次重建。

游戏为这次重建提供了两种输出模式,由每个变形请求里的一个"realtime"字节决定:

模式 流程 CPU 是否读结果
Baked(默认) 每级 mipmap 画进临时渲染目标 → resolve 拷入访客内存(0x12704000 纹理)→ CPU 加锁只读、DXT 压缩成最终纹理 ✅ 是
Realtime(RealTimeTextureMorphing) GPU 直接画进最终纹理,mipmap 也在 GPU 上生成 ❌ 否

真正的元凶:统一内存 vs 分离内存

  • Xbox 360(统一内存):CPU 和 GPU 共享同一片内存,resolve 一落地,CPU 立刻能读到,所以默认的 Baked 模式"刚好能用"。
  • PC(分离内存):显存和系统内存物理分离。GPU 把像素写进显存后,CPU 去读访客内存里的地址,读到的还是初始黑值——于是 DXT 压缩出来的最终纹理整张全黑,主角的脸就黑了。

一句话总结:Baked 模式强依赖"CPU 能读到 GPU 刚写的像素",而 PC 做不到。

一行 hook 修复:强制切换 Realtime Texture Morphing

修复思路:把 0 改成 1

既然游戏自己就有 Realtime 模式(GPU 直写最终纹理、CPU 完全不读结果),那最简单的解法就是:让所有纹理变形任务都走 Realtime 模式。而模式开关,只是请求结构体里的一个字节。

hook 打在哪

所有变形请求都会经过 sub_82A76018 变成变形任务(morph job)。在这条 PPC 指令处:

lbz r9, 0x20(r30)   ; 地址 0x82A7607C,把请求里的 realtime 字节装入 r9

Fable-2-Recomp 就在这个指令之后注册了 mid-asm hook fable2_hook_realtime_texture_morphing,它只做一件事(完整实现见 src/core/fable2_hooks.cpp):

void fable2_hook_realtime_texture_morphing(PPCRegister& r9) {
  if (!fable2::config::Get().realtime_texture_morphing) return;
  r9.u64 = 1;   // 强制所有纹理变形任务以 Realtime (GPU) 模式运行
}

hook 在 fable_2_manifest.toml 中注册(地址 0x82A7607C、after_instruction = true)。GPU 直写最终纹理后,CPU 从不去读它,分离内存的问题自然绕开——一行 r9 = 1 就是全部修复。

如何开启与验证

修复由配置项 realtime_texture_morphing 控制,默认 true,开箱即用。在 config/fable2_config.toml 中可以看到两个相关选项:

[patches]
# 强制 Realtime 纹理变形(GPU 直写),默认 true
realtime_texture_morphing = true
# 旧的 CPU readback 兜底方案,默认 false(仅上面那项关掉时才有用)
hero_dog_texture_readback = false

验证方法(A/B 检查):

  1. 保持默认 → 主角和狗正常显示,日志打印一次 [texture-morph] building hero/dog textures in realtime (GPU) mode
  2. 改成 false → 黑脸回归,证明修复确实来自这个 hook
  3. 也可在游戏内按 F3 打开控制台实时切换

💡 代价很小:Realtime 模式的纹理以非压缩格式存储,多占几 MB 访客内存;而纹理变形只在外观变化时重建(读档瞬间集中跑一波),正常游玩时零开销。

兜底方案:CPU readback(现已默认关闭)

在 Realtime 方案落地之前,项目先用过另一条路——plans/hero-dog-texture-readback.md:监控目标地址 0x12704000 的 resolve 拷贝,只在它发生时单独做一次 CPU readback(对应配置 hero_dog_texture_readback)。它能修好黑脸,但 mipmap 落位复杂、容易残留狗贴图闪烁等瑕疵,因此现在默认 false,仅作为 realtime_texture_morphing 关闭时的后备。

相关文件与延伸阅读

想深挖这个 bug 的完整排查过程(含 mipmap 链偏移、A/B 实验记录),可以读这几份资料:

📌 小结:主角黑脸的根因是 Baked 纹理变形依赖 CPU 读回 GPU 刚写入的像素,而 PC 的分离内存做不到;Fable-2-Recomp 用一个一行赋值的 mid-asm hook 把所有变形任务切到游戏自带的 Realtime 模式,问题就此消失——这正是"读懂引擎内部逻辑后,最小改动解决大问题"的典型案例。

登录后查看全文
Fable-2-Recomp