HarmonyRecomp：恶魔城绝望和声静态重编译

项目简介

HarmonyRecomp 是《恶魔城：绝望和声》（Castlevania: Harmony of Despair，Xbox Live Arcade 版，title ID 58410A7A）的静态重编译项目，目标是让这款游戏在 Windows 上原生运行。它基于 ReXGlue SDK，构建时把 default.xex 与角色模块的 PowerPC 代码翻译成 C++，再为 x86-64 原生编译；图形、音频和 Xbox 系统服务由 ReXGlue 运行时（源自 Xenia）提供。

仓库本身不包含任何游戏代码或数据，必须自备游戏副本。

主要功能

• 在 Windows 上原生运行完整游戏：基础游戏的全部关卡与角色
• F6 设置菜单（支持手柄操作）：分辨率缩放、抗锯齿、各向异性过滤、帧率上限（60/90/120/144/不限）、全屏；手柄按键重映射、键鼠按键绑定；联机开关与玩家名称
• F2 显示 FPS 计数器
• 不依赖 Xbox Live 的在线合作：最多 6 人，可通过局域网或虚拟局域网联机
• DLC 支持：全部角色与关卡包，来自自备的 DLC 包和 title update 2
• 崩溃报告写入 logs/，便于反馈问题

安装与使用

一键安装

1. 从最新 release 下载 HarmonyRecomp-Setup.exe 并运行。Windows 可能提示程序未签名，点击「更多信息 → 仍要运行」。
2. 选择自己的游戏文件：控制台转储中 58410A7A\000D0000\ 下没有扩展名、以 LIVE 开头的那个文件；可选选择包含 DLC 包与 title update 的文件夹。
3. 点击 Install 并等待。安装程序会下载构建工具（约 1 GB），若未安装 Visual Studio 还会安装微软 C++ 组件（约 400 MB），随后在本机翻译并编译游戏，视 CPU 需要 10 到 30 分钟。过程中约占 10 GB 磁盘，完成后约 1 GB。
4. 点击 Play，或使用桌面快捷方式启动。

手动构建

需要 Windows 10/11 x86-64、自备 XBLA 游戏包，以及 Clang 20 以上的构建工具，例如：

scoop install llvm cmake ninja git python

把游戏包放进 game\（只能有一个文件），DLC 包与 title update 放进 dlc\，然后执行：

python scripts\build.py

脚本会依次解包、克隆并编译 SDK、运行代码生成、编译游戏。完成后运行：

.\harmonyrecomp.exe

常用按键：F2 帧率，F3 SDK 调试覆盖层，F4 SDK 运行时设置，F6 设置菜单，^ 日志控制台。

在线联机

在 F6 > Online 中打开在线合作、填写名字，保存后重启。v0.5.0 起无需 VPN：游戏连接 HarmonyRecomp 社区服务器，房主会在大厅获得房间码（如 R78QSH），好友凭码加入私密房间，公开房间可由游戏内搜索找到。也可以继续用 Radmin VPN、ZeroTier、Tailscale 组建虚拟局域网联机。防火墙需放行 UDP 47658（大厅）与 UDP 1000（游戏流量）。

存档位于 Documents\harmonyrecomp\B13EBABEBABEBABE\58410A7A\00000001\dchd_savedata\，备份该文件夹即可保留进度。

注意事项

• 必须使用自己从主机转储或购买的游戏副本；不要分享 game/、assets/、dlc/、generated/，它们包含游戏本体或由其衍生的代码。
• 联机所有玩家都需要 v0.5.0，版本不一致（有无 title update）的大厅会被隐藏并在屏幕下方提示原因。
• 若游戏只有 30 FPS 或卡顿，检查 NVIDIA 控制面板等驱动工具是否为其设置了帧率上限：与 G-SYNC 叠加可能让帧率减半，请改用 F6 菜单中的帧率限制。
• 若安装程序报错「the rexglue tool could not start」，请安装最新的 Microsoft Visual C++ Redistributable (x64) 后重试。
• 设置保存在 exe 旁的 harmonyrecomp.toml 中，升级安装时设置与存档会保留。

---

本作品整理自 GitHub 开源项目 Wrexxial/HarmonyRecomp，原作者 @Wrexxial。中文介绍由 AI 根据项目 README 整理，以原仓库为准。