主角的脸为什么是黑的?Fable-2-Recomp纹理变形bug根因与一行hook修复
主角的脸为什么是黑的?Fable-2-Recomp纹理变形bug根因与一行hook修复
Fable-2-Recomp 是一个用 ReXGlue SDK 把 Xbox 360 经典《Fable 2:年度版》(GOTY) 在 PC 上原生运行的开源重编译项目。不少玩家加载存档后发现主角的脸和狗的毛发整片纯黑——这就是著名的纹理变形(Texture Morphing)bug。本文讲清楚它为什么变黑,以及开发者如何用一行 mid-asm hook 把它修好(默认已开启)。
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 检查):
- 保持默认 → 主角和狗正常显示,日志打印一次
[texture-morph] building hero/dog textures in realtime (GPU) mode - 改成
false→ 黑脸回归,证明修复确实来自这个 hook - 也可在游戏内按 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 实验记录),可以读这几份资料:
- 根因与最终方案:plans/hero-dog-realtime-texture-morphing.md
- readback 兜底方案:plans/hero-dog-texture-readback.md
- 狗的 mipmap 链排查实录:plans/hero-dog-shifty-texture-mipmap.md
- 配置项解析逻辑:src/core/fable2_config.cpp
- 启动器中的开关 UI:launcher/Fable2.Launcher/MainWindow.xaml.cs
- 其他运行时修复(如狗毛深度偏置):docs/RUNTIME_FIXES.md
📌 小结:主角黑脸的根因是 Baked 纹理变形依赖 CPU 读回 GPU 刚写入的像素,而 PC 的分离内存做不到;Fable-2-Recomp 用一个一行赋值的 mid-asm hook 把所有变形任务切到游戏自带的 Realtime 模式,问题就此消失——这正是"读懂引擎内部逻辑后,最小改动解决大问题"的典型案例。
