# xboxrecomp 初代 Xbox 静态重编译工具包

> 面向初代 Xbox 游戏的静态重编译工具包：Python 流水线解析零售版 XBE，进行反汇编、识别库函数、恢复调用约定，并将每个 x86 函数提升为 C 代码。生成的代码在独立的游戏项目中编译，并链接工具包的运行时库；这些库替代 Xbox 内核，并将 Direct3D 8、NV2A、音频和输入转换到 Direct3D 11 与 Win32 API，在 Linux 和 macOS 上则转换到 SDL2 与 OpenGL。

- 类型：工具
- 目标：二进制 · 游戏
- 类别：游戏分析工具
- 关联：基础工具
- 来源复核于：2026-10-19
- 收录于：2026-10-19
- 原始资源：<https://github.com/sp00nznet/xboxrecomp>
- 一手来源：<https://github.com/sp00nznet/xboxrecomp/blob/eb0aa1d5fcb1ca34cdb6470fcfa471d87f431d73/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/xboxrecomp/>
- 记录 JSON：<https://awesomerea.org/resources/xboxrecomp/record.json>
- 英文版：[English](https://awesomerea.org/resources/xboxrecomp/index.md)

## 使用条件与局限

- v0.14.0（2026-10-16，即所审阅的提交）的 README 称工具包与具体游戏无关，但开发时以 Burnout 3: Takedown 为参考；重编译后的游戏首次运行必定崩溃，每款游戏都需要反复添加桩函数、修复间接调用并补充运行时。作者自己的移植仍处于早期：README 撤回了 Burnout 3 此前“可游玩”的说法，其重编译路径目前只到引擎初始化，Wreckless 和 Blood Wake 分别处于可启动和刚搭好框架的阶段。
- 使用者需从自己的初代 Xbox 光盘镜像中提供 default.xbe 和游戏数据文件。仓库不含任何游戏代码或资产，只构建库，不会产出游戏可执行文件；生成的 C 代码往往多达数百万行，写入使用者依据随附模板创建的游戏项目中。
- 流水线需要 Python 3.10+ 和 Capstone（测试另需 pytest）；Ghidra 或 IDA 为可选项，仅用于恢复符号名。运行时使用 CMake 3.20+ 构建：Windows 上用 Visual Studio 2022 或 MinGW-w64（D3D11、XInput、XAudio2、Media Foundation），x86-64 与 arm64 的 Linux 和 macOS 上用 Clang/GCC 加 SDL2、libepoxy 和 pkg-config，但这两个平台没有 FMV 解码。v0.14.0 发布版本不含二进制文件。
- 单元测试不需要游戏文件，其中若干项会编译提升器自身的输出并对照 x86 定义检查，同时配有反向对照；README 给出的完整通过结果为 812 项通过、0 项跳过。一致性测试在真实的 32 位 x86 CPU 上，用相同输入分别运行提升后的 C 代码和原始指令；在 Linux 和 macOS 上由 Docker 镜像提供 GCC 以及在 Wine 下运行的 MSVC。README 称提升器覆盖率良好但未量化，仓库中也没有 CI 工作流。
- 采用 MIT 许可证，但取自 xemu 的 MCPX APU 源码和 NV2A 寄存器定义保留 LGPL-2.1-or-later 许可，具体文件列于 NOTICE。README 致谢 Claude Code 参与了 AI 辅助开发。

## 一手来源

1. <https://github.com/sp00nznet/xboxrecomp/blob/eb0aa1d5fcb1ca34cdb6470fcfa471d87f431d73/README.md>
2. <https://github.com/sp00nznet/xboxrecomp/blob/eb0aa1d5fcb1ca34cdb6470fcfa471d87f431d73/docs/GETTING_STARTED.md>
3. <https://github.com/sp00nznet/xboxrecomp/blob/eb0aa1d5fcb1ca34cdb6470fcfa471d87f431d73/templates/new-game/CMakeLists.txt>
4. <https://github.com/sp00nznet/xboxrecomp/blob/eb0aa1d5fcb1ca34cdb6470fcfa471d87f431d73/tools/conformance/mkxbe.py>
5. <https://github.com/sp00nznet/xboxrecomp/blob/eb0aa1d5fcb1ca34cdb6470fcfa471d87f431d73/LICENSE>
6. <https://github.com/sp00nznet/xboxrecomp/blob/eb0aa1d5fcb1ca34cdb6470fcfa471d87f431d73/NOTICE>
7. <https://github.com/sp00nznet/xboxrecomp/releases/tag/v0.14.0>

## 同分区更多条目：游戏

- [PCSX-Redux PlayStation 1 调试模拟器](https://awesomerea.org/zh/resources/pcsx-redux/index.md) · 工具
- [Il2CppInspector Unity IL2CPP 静态分析工具](https://awesomerea.org/zh/resources/il2cppinspector/index.md) · 工具
- [MelonLoader Unity 游戏模组加载器](https://awesomerea.org/zh/resources/melonloader/index.md) · 工具
- [BepInEx Unity/.NET 游戏插件与修补框架](https://awesomerea.org/zh/resources/bepinex/index.md) · 工具
- [ReXGlue Xbox 360 静态重编译 SDK](https://awesomerea.org/zh/resources/rexglue-sdk/index.md) · 工具
- [ps3recomp PS3 静态重编译工具包](https://awesomerea.org/zh/resources/ps3recomp/index.md) · 工具

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。