Leonida
Grand Theft Auto VI(Xbox Series)在 Windows 上原生运行,由你自己的游戏副本在你的 PC 上构建。
状态 | 如何构建 | 工作原理 | 想帮忙? | 致谢 | 许可证 | Discord
Leonida 是一个静态重编译项目。Xbox Series 的 CPU 与 PC 一样是 x86-64,因此游戏的代码被加载并原生运行,主机的系统软件则被重新实现。主机预编译的 RDNA2 GPU 程序被转换为面向 Vulkan 的 SPIR-V。游戏的模型、纹理和音频从你的包中读取。这一切都发生在你的 PC 上,来自你自己的游戏副本。
本仓库不包含游戏、密钥或可执行文件,也不说明如何获取它们。你需要自己的副本,且其文件已在磁盘上可读。此处不会解密或绕过任何保护。构建所产生的一切(生成的着色器、提取的资源、运行时文件夹和你的存档)都来自你的游戏,并留在你的 PC 上。切勿分享这些文件。
Discord:https://discord.gg/rexed
项目状态
早期阶段。游戏尚无法启动。所有不依赖游戏可执行文件就能完成的工作都已就绪,因此一旦开发者拿到可执行文件,就可以开始启动相关的工作。
| 项目 | 状态 |
|---|---|
| 查找并校验你的游戏副本(Xbox Series 1.0.2.1) | ✅ 可用 |
| 着色器:提取、解包原生 RDNA2 代码、反汇编 | ✅ 全部 26,503 个 |
| 着色器:RDNA2 → SPIR-V 翻译 | ✅ 全部 26,503 个(使用 LLVM 21 反汇编;LLVM 23 目前仍有 1,471 个被拒绝,#644):2,236 个 VS、12,101 个 PS、2,689 个 CS、9,282 个 mesh、195 个 geometry。全部通过 spirv-val,并附带逐着色器元数据索引用于创建管线。⚠️ 其中 21,545 个是 wave64:在 64 宽子组(AMD)上精确。在 32 宽子组(NVIDIA、Intel)上,compute 和 mesh 着色器配合 wave64 模拟(--wave64-emulate,在这些平台上默认开启)可精确;vertex、pixel 和 geometry 着色器中的跨半波操作仍为近似 |
| 着色器翻译器在真实 GPU 上的验证 | ⚠️ 手写的 GPU 测试(vertex fetch、纹理采样、导出、ALU 操作、部分寄存器操作、重心坐标、波统一分支、compute 的 LDS/barrier/buffer store、wave64 掩码)已在 30 多种 GPU 与驱动组合上运行,结果见 #166:NVIDIA Turing、Ampere、Ada 和 Blackwell(Windows 与 Linux);AMD GCN3、RDNA1、RDNA2、RDNA3 和 RDNA4(Windows 驱动与 RADV);Intel Gen9(ANV);Apple M1(MoltenVK,无 geometry 或 mesh 阶段);以及 Mesa llvmpipe。wave64 测试需要 64 宽子组(AMD)或 LEONIDA_W64_EMULATE=1。这些只是小型测试着色器:游戏自身的着色器由 spirv-val 和驱动管线创建(vk_pipeline_check)来校验,而非校验其输出 |
| 模型(OBJ,含真实名称、UV、材质引用) | ✅ 已导出。并非所有布局都已解码 |
| 纹理字典与世界纹理池(DDS) | ✅ 已导出。以 BCPack 存储的池条目在导出时仍被跳过;一个净室解码器(tools/bcpack.py)可重建 BC1、BC3、BC4 和 BC5,尚未接入 rpf9dump(notes) |
| 音频库(AWC:Opus、XMA2) | ✅ 完整导出。Opus 无损重新封装为 Ogg Opus;PCM(codec 0/2)导出为 WAV;XMA2 用 ffmpeg 解码。--wav 会额外输出 16 位 PCM WAV(notes) |
| 音乐/电台配置 | ? 已测量。1,589 条音频配置记录,含精确时长和 AWC 流 id;电台分组和 content-id 列表;无逐轨起始偏移(notes) |
| PE 加载器与导入 shim | ⚠️ 端到端运行了一个替身可执行文件(gta6rt --run:CRT 启动、静态数据、堆、文件、线程、通过 shim 的 GDK 导入、退出码返回)。尚未对真实可执行文件测试 |
| Xbox D3D12 → Vulkan | ⚠️ 进行中。Xbox-ABI 代理之后由 Vulkan 支撑的设备可创建队列、命令列表、fence、描述符堆、committed 和 reserved 资源、渲染目标和深度视图,以及纹理视图和采样器(进入 bindless 集合)。barrier、clear、上传、拷贝(含 BC)和颜色 resolve 在 Vulkan 上运行,已在一个 GPU 上验证。尚无 buffer view、root signature、管线、绘制或 swapchain(plan) |
| 启动、故事模式、任何可玩内容 | ❌ 无 |
如何构建
这个移植版并非下载即用。它由你在自己的 PC 上,用你自己的游戏副本构建。
简单方法:
- 安装下面的前置依赖。
- 连同子模块一起下载本项目:git clone --recursive https://github.com/ItsNotRexed/Leonida。从 GitHub 下载的“Download ZIP”会遗漏 third_party/rpf9-explorer。如果安装了 git,构建过程会自动拉取;否则会提示你该怎么做。
- 双击 Build.bat。
它会自行找到你的游戏副本:它会查看 Downloads、Desktop、Documents、Games、你的主文件夹以及每个驱动器的根目录,向下两层。它通过几个文件大小来识别版本,而不读取任何大文件。如果你有多个副本,它会询问用哪一个;如果一个都找不到,它会请你粘贴文件夹路径。开始之前,它会检查下面所有依赖是否已安装,以及是否有足够的可用空间,并一次性列出所有缺失项。结果输出到 Documents\Leonida。中断的构建会从上次中断处继续。
你的游戏文件夹是包含 MicrosoftGame.Config 和 .rpf 归档(作为普通文件)的那个文件夹。
文章标题:Leonida – 将 Xbox 版 GTA 6 重编译到 PC
前置条件:
- 你自己的 Xbox Series 包副本,版本 1.0.2.1。
- Windows 10/11 x64,约 350 GB 空闲空间用于工作文件。它们可以放在另一个驱动器上,用 --work 指定。
- Python 3.12+(勾选“Add python.exe to PATH”)。
- Vulkan SDK,用于 spirv-as / spirv-val。
- LLVM 21+,带 AMDGPU 目标以支持 llvm-mc。官方 Windows 构建没有 AMDGPU 目标。在 Windows 上,scripts\build_llvm_mc.ps1 会用它构建一个原生的 llvm-mc.exe(不需要 WSL;需要 git 和下面的 Visual Studio C++ 工具)并设置 LLVM_MC。或者在 WSL 中安装 llvm-21,并将 LLVM_MC 设为完整命令,LLVM_MC="wsl -d Ubuntu -e /usr/lib/llvm-21/bin/llvm-mc"(见 docs/design.md)。在 Linux 上,PATH 中的 llvm-mc 就够了。
- Visual Studio 2022,带“使用 C++ 的桌面开发”和 Windows SDK 10.0.26100 或更新版本,用于运行时阶段(运行时使用版本 1.2 根签名,旧版 SDK 不声明这些)。
- PATH 中有 ffmpeg(可选:解码 XMA2 流,--wav 需要它)。
在终端中操作,行为相同且控制更多:
python -I make_game.py --find # 列出此 PC 上找到的副本
python -I make_game.py --check # 检查你的副本,不构建任何内容
python -I make_game.py --game "D:\path\to\your\package" --out "D:\Games\Leonida" --work "E:\leonida-work"
python -I make_game.py --stages shaders,assets # 只运行部分阶段
python -I make_game.py --game "D:\path\to\your\package" --wav # 还将 Opus 解码为 PCM WAV(很大)
python -I make_game.py --wave64-emulate off # auto(默认)、on 或 off;见下文
--wave64-emulate 决定是否将 wave64 计算和网格着色器翻译为在任何子组大小下都精确(见 docs/design.md 中的“Wave64 emulation”)。NVIDIA 和 Intel GPU 的子组宽度为 32,需要它。默认值 auto 会询问 vulkaninfo(Vulkan SDK 的一部分),除非所有 GPU 都报告 64 宽子组,或者无法判断时,否则会将其打开;当运行时将使用的 GPU 无法让计算和网格着色器以 64 宽运行时,它也会将其打开。该模式保存在翻译后的着色器旁边,更改它会重新翻译它们。使用 auto 时,已经用模拟翻译过的着色器会被保留,即使本次运行不会模拟(它们在每个 GPU 上都是精确的);--wave64-emulate off 会原生翻译它们。
阶段按顺序运行:check、shaders、assets、runtime、pipelines(在你的 GPU 驱动上创建每个翻译后的着色器并保存管道缓存,这样首次启动时不会编译它们)。着色器翻译是最长的步骤:它在 --jobs 个进程上运行(默认为 CPU 线程数的一半)。
--wav 默认关闭,因为 16 位 PCM WAV 比 Ogg Opus 大好几倍。它在音频 bank 步骤之后将重新打包的 Ogg Opus 流解码到 work\assets\audio\wav;构建恢复时,现有的 WAV 文件会被跳过。
Linux 上的 Vulkan 诊断
使用 CMake 3.24+、C++20 编译器和已安装的 Vulkan 开发头文件及加载器:
cmake -S runtime -B runtime/build/linux
cmake --build runtime/build/linux --parallel
./runtime/build/linux/vk_pipeline_check /path/to/spirv
将包含 index.json 和翻译后的 SPIR-V 文件的目录传递给 vk_pipeline_check。
make_game.py 也能在 Linux 上运行,但没有 runtime 阶段,该阶段目前仅在 Windows 上构建:没有 --stages 时它会被排除,请求它会在任何工作开始前失败。pipelines 阶段使用上面构建的 vk_pipeline_check(runtime/build/linux 或 runtime/build)。
工作原理
| 组件 | 作用 | 位置 |
|---|---|---|
| 版本校验 | 每个受支持版本中每个包文件的名称、大小和 SHA-256 | game/ 、 make_game.py |
| 着色器管线 | 从 shaders.rpf 中剥离 DXBC 容器,不依赖其加密的目录表。解包 XBCH → FSSM 原生 RDNA2 程序,用 LLVM ( gfx1013 ) 反汇编并转换为 SPIR-V | tools/shader_carve.py 、 fssm_unpack.py 、 shader_disasm.py 、 rdna2spirv.py |
| 资源导出 | 在 RPF9 归档和散放的 .ttpf 纹理池中查找已校验的资源 | tools/rpf9dump (基于 rpf9-explorer 的 Core) |
| 运行时 | 映射 PE 映像,将导入解析到 shim(GDK、XMem、d3d12_xs ) | runtime/ |
| 研究工具 | PE/RTTI 检查、原始剥离、纹理平铺探测、GPU 测试框架 | tools/ 、 runtime/test/ |
翻译器的运行时契约(用户 SGPR、推送常量、内存模型、无绑定图像、顶点获取、系统值)以及所有格式说明位于 docs/design.md;格式、资源、运行时和校验说明的索引位于 docs/README.md。Xbox D3D12 方案位于 docs/d3d12_vulkan.md。音频库格式和导出工具位于 docs/audio.md;docs/related_projects.md 记录了我们可能参考的先前工作及其许可限制。
想要帮忙?
最大的未完成部分:
- 硬件上的着色器翻译器:计算、网格和几何着色器现已可翻译(见 docs/design.md 中的翻译器契约);仍未完成的是顶点着色器输入布局(如果主机以 NGG 方式运行 VS,则 v0 = VertexIndex 尚未验证)以及 32 宽子组上 VS/PS/GS 中 wave64 跨半部分代码。
- Xbox D3D12 → Vulkan:d3d12_xs 命令列表和描述符堆模型。
- 目前解码器拒绝的模型布局。
见 CONTRIBUTING.md。切勿将游戏文件、提取的资源或生成的着色器附加到 issue 或 pull request 中。
致谢
- rpf9-explorer,作者 breadbbbb:tools/rpf9dump 使用的 RPF9 模型、纹理池和 AWC 解码器(git 子模块)。
- Mesa(MIT):GFX10 资源描述符布局(tools/gfx10_formats.json),以及作为 16 位结果和着色器系统寄存器参考的 ACO/RADV 规则。
- libHttpClient(MIT),作者 Microsoft:third_party/xtaskqueue 中的 XTaskQueue/XAsync 实现,供离线 xgameruntime shim 使用。
- LLVM:AMDGPU 反汇编器。
- 标志:“Grand Theft Auto VI”图标,作者 SlyDevil,来自 SteamGridDB。
- SPIRV-Tools:汇编与校验。
Grand Theft Auto 及相关名称均为其各自所有者的商标。本项目与它们无关联,也未获其认可。
许可证
GPLv3(或任何更高版本)。见 LICENSE。第三方代码保留其自身许可证。