andrewnakas/gtav-recomp

项目用途

这个项目把《GTA V》Xbox 360 版（Title Update 27）的 PowerPC 可执行文件静态重编译成原生 C++ 代码，运行在 Windows、Linux、macOS、iPhone 和 Android 上。它基于 ReXGlue v0.10.0，并自带 Vulkan 渲染器（Apple 设备走 MoltenVK）；游戏着色器首次出现时翻译为 SPIR-V。

安装流程会从 Disc 1、Disc 2 和标题更新读取游戏文件，用 SHA-256 校验后，在本地用随包附带的 LLVM/clang 把可执行文件编译成 gtav_game.dll、.so 或 .dylib。仓库和发行包都不含游戏数据，光盘由用户自备。手机版本必须先在电脑上装好游戏再生成包，因为 iOS 和 Android 无法运行编译器或着色器翻译器。

Windows 快速开始

1. 从发行页下载 gtav-recomp-windows-x64.zip，解压到空间足够的目录。
2. 运行 gtav_launcher.exe，选择 Disc 1、Disc 2 和 Title Update 27 文件或文件夹，点击 Install。首次重编译约需 15-30 分钟。
3. 安装完成后点击 Play。之后直接运行 gtav_launcher.exe 即可进入游戏；启动时按住 Shift 可重新打开安装窗口或构建手机版本。日志位于 data\logs。

Linux 和 macOS 流程相同，只是使用对应平台的安装包；各平台的精确命令见平台章节，例如 Linux 终端安装命令 ./gtav_launcher --setup "Disc 1.iso" "Disc 2.iso" tu00000009_00000000。

使用条件

• 需要 Windows 10/11 x64 且 CPU 支持 AVX2、具备 Vulkan 驱动；或 x86-64 Linux（glibc 2.35、GCC 13 libstdc++）；或 Apple silicon 且 macOS 15 以上。
• 内存至少 8 GB，安装期间约需 25 GB 空闲空间，完成后约 17 GB。推荐使用手柄；Mac 和 Linux 支持键盘。
• 只支持 Title Update 27。其他版本、损坏的 ISO 或被修改的 dump 会在哈希校验中失败。
• iPhone 版本需要 iPhone 12 或更新机型、iOS 17 以上，以及 Sideloadly 或 AltStore 等侧载工具；免费 Apple ID 需每 7 天重新签名。Android 版本需要较新的骁龙手机，安装期间约 40 GB 空闲空间。
• 生成的游戏文件仅供自己使用，项目要求不要分享游戏目录、GTAV.ipa 或 Android 包。代码采用 GPL-3.0 或更高版本，随包的第三方组件保留各自许可证。

从源码构建

项目由本仓库加上打过补丁的 ReXGlue、XenosRecomp 和 plume 上游代码树组成；每次发行都附带对应提交的完整源码压缩包。README 中给出了清洁室与发行流程、iOS 移植说明和 Android 状态等文档入口。

HotRepo 点评

该仓库没有全部语言日榜排名记录；唯一快照是 2026-11-03 的 C++ 新项目榜，显示 103 Star、6 Fork，且在约一小时的窗口内净增 2 Star。这个窗口太短，不足以判断趋势。就技术文档而言，它对一个重编译项目算相当具体：说明了哈希校验、随包 codegen/LLVM 流水线、15-30 分钟的一次性编译、各平台系统要求以及手机端的实测帧率。但主要交付物是预编译启动器包，材料没有说明发布者身份，也没有证明二进制与仓库源码的对应关系，使用前应结合这一点权衡。