Leonida:将 Xbox 版 GTA 6 静态重编译到 PC 的项目
Leonida – PC Recompilation of the Xbox Version of GTA 6
Leonida 是一个静态重编译项目,让 Xbox Series 版《GTA 6》在 Windows 上原生运行,需用户自备游戏副本(版本 1.0.2.1)。项目已完成全部 26,503 个 RDNA2 着色器到 SPIR-V 的翻译并通过 spirv-val,模型、纹理与音频资源也已导出。目前游戏尚无法启动,Xbox D3D12 到 Vulkan 的转换仍在进行中。
《侠盗猎车手 VI》(Xbox Series 版)在 Windows 上原生运行,由你在自己的 PC 上使用自己的游戏副本构建。
状态 | 如何构建 | 工作原理 | 想帮忙? | 致谢 | 许可证 | Discord
Leonida 是一个静态重编译项目。Xbox Series 的 CPU 与 PC 一样是 x86-64,因此游戏的代码会被加载并原生运行,而主机的系统软件则被重新实现。主机预编译的 RDNA2 GPU 程序会被翻译为 SPIR-V 以供 Vulkan 使用。游戏的模型、纹理和音频从你的包中读取。所有这些都在你的 PC 上、使用你自己的游戏副本完成。
重要
本仓库不包含游戏、密钥或可执行文件,也不说明如何获取它们。你需要自己的副本,且其文件已在磁盘上可读。此处没有任何内容会解密或绕过任何保护。构建所产生的一切(生成的着色器、提取的资源、运行时文件夹和你的存档)都来自你的游戏,并保留在你的 PC 上。切勿分享这些文件。
Discord:https://discord.gg/rexed
CA 8T3ztDSKxYK15SUBseqLeviqQwfcG9wUeDGP1wjBpump
项目状态
早期阶段。游戏尚无法启动。所有无需游戏可执行文件即可完成的工作均已就绪,因此一旦开发者拿到可执行文件,便可立即开始启动相关的工作。
| 项目 | 状态 |
|---|---|
| 查找并校验你的副本(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)上,计算和 mesh 着色器通过 wave64 模拟(--wave64-emulate,在这些平台上默认开启)可达到精确;顶点、像素和几何着色器中的跨半波操作仍为近似 |
| 着色器翻译器已在真实 GPU 上验证 | ⚠️ 手写的 GPU 测试(顶点获取、纹理采样、导出、ALU 操作、部分寄存器操作、重心坐标、波统一分支、计算 LDS/屏障/缓冲区存储、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,无几何或 mesh 阶段);以及 Mesa llvmpipe。Wave64 测试需要 64 宽子组(AMD)或 LEONIDA_W64_EMULATE=1。这些只是小型测试着色器:游戏自身的着色器由 spirv-val 和驱动管线创建(vk_pipeline_check)来验证,而非通过其输出验证 |
| 模型(带真实名称、UV、材质引用的 OBJ) | ✅ 已导出。并非所有布局都已解码 |
| 纹理字典和世界纹理池(DDS) | ✅ 已导出。以 BCPack 存储的池条目在导出时仍会被跳过;一个净室解码器(tools/bcpack.py)可重建 BC1、BC3、BC4 和 BC5,但尚未接入 rpf9dump(说明) |
| 音频库(AWC:Opus、XMA2) | ✅ 已完整导出。Opus 以无损方式重新封装为 Ogg Opus;PCM(编解码器 0/2)导出为 WAV;XMA2 使用 ffmpeg 解码。--wav 新增 16 位 PCM WAV(说明) |
| 音乐/电台配置 | ?已测量。1,589 条音频配置记录,包含精确时长和 AWC 流 ID;电台分组和内容 ID 列表;无逐轨起始偏移(备注) |
| PE 加载器和导入垫片 | ⚠️ 端到端运行一个替代可执行文件(gta6rt --run:CRT 启动、静态数据、堆、文件、线程、通过垫片的 GDK 导入、返回退出码)。未针对真实可执行文件测试 |
| Xbox D3D12 → Vulkan | ⚠️ 进行中。Xbox-ABI 代理背后的 Vulkan 后端设备可创建队列、命令列表、围栏、描述符堆、提交式和保留式资源、渲染目标和深度视图、纹理视图和采样器(进入无绑定集),以及查询堆。屏障、清除、上传、复制(包括 BC)、颜色解析和遮挡、时间戳和管线统计查询在 Vulkan 上运行,已在单个 GPU 上验证。尚无缓冲区视图、根签名、管线、绘制或交换链(计划) |
| 启动、故事模式、任何可玩内容 | ❌ 否 |
如何构建
移植版并非现成下载。它是在你的 PC 上使用你自己的副本构建的。
简单方法:
- 安装下面的先决条件。
- 下载此项目及其子模块:
git clone --recursive https://github.com/ItsNotRexed/Leonida。从 GitHub 的“下载 ZIP”会遗漏third_party/rpf9-explorer。如果安装了git,构建过程会获取它,否则会告诉你该怎么做。 - 双击
Build.bat。
它会自行找到你的游戏副本:它会查看下载、桌面、文档、游戏、你的主文件夹以及每个驱动器的顶层,深入两个文件夹。它通过几个文件大小识别版本,而不读取任何大文件。如果你有多个副本,它会询问是哪一个;如果找不到,它会要求你粘贴文件夹路径。开始前,它会检查下面所有内容是否已安装以及是否有足够的可用空间,并一次性列出所有缺失项。结果输出到 Documents\Leonida。停止的构建会从上次中断处继续。
你的游戏文件夹是包含 MicrosoftGame.Config 和 .rpf 归档(作为普通文件)的那个文件夹。
先决条件:
- 你自己的副本,Xbox Series 包,版本 1.0.2.1。
- Windows 10/11 x64,约 350 GB 可用空间用于工作文件。它们可以通过
--work放到另一个驱动器上。 - Python 3.12+(勾选“将 python.exe 添加到 PATH”)。
- .NET 8 SDK。
- 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 # list the copies found on this PC python -I make_game.py --check # check your copy, build nothing 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 # only some stages python -I make_game.py --game "D:\path\to\your\package" --wav # also decode Opus to PCM WAV (large) python -I make_game.py --wave64-emulate off # auto (default), on or off; see below
--wave64-emulate 决定是否将 wave64 计算和网格着色器转换为在任何子组大小上都精确
(参见 docs/design.md 中的“Wave64 模拟”)。NVIDIA 和 Intel GPU 具有 32 宽的子组,需要
它。默认值 auto 会询问 vulkaninfo(Vulkan SDK 的一部分),并在以下情况下启用它:除非每个 GPU 都报告 64 宽
子组,或者无法判断时;当运行时将使用的 GPU 无法让计算和网格着色器以 64 宽运行时,它也会启用。该模式保存在翻译后的着色器旁边,更改它会重新翻译它们。
使用 auto 时,之前使用模拟的工作文件夹会在后续翻译和重试中保留它,即使
当前 GPU 支持原生 wave64。使用 --wave64-emulate off 将其原生翻译。
构建会记录哪些翻译器源文件生成了着色器。对这些文件的更改会使用 保存的反汇编重新运行翻译。较旧的工作文件夹在升级后需要一次翻译来记录此信息。
各阶段按顺序运行:check、shaders、assets、runtime、pipelines(在您的
GPU 驱动程序上创建每个翻译后的着色器并保存管道缓存,因此首次启动时不会编译它们)。着色器翻译是最长的步骤:它在
--jobs 个进程上运行(默认情况下为 CPU 线程数的一半)。
--wav 默认关闭,因为 16 位 PCM WAV 比 Ogg Opus 大几倍。它在音频库步骤之后将重新打包的 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 上运行。pipelines 阶段使用上面构建的 vk_pipeline_check
(runtime/build/linux 或 runtime/build)。runtime 阶段仅在 Windows 上构建,因此在 Linux 上它需要
runtime/ 的 Windows 构建;没有它,该阶段会被排除在默认阶段之外,请求它会在任何
工作开始之前失败。
在 Linux 上运行加载器
加载器是一个 Windows 程序,在 Wine 或 Proton 下运行;CI 在每次更改
runtime/ 时在 Wine 下运行其测试(Runtime 工作流的 wine 作业)。给 runtime 阶段一个包含 gta6rt.exe 和
gta6rt_tls_host.dll 的文件夹,例如该工作流 windows 作业的 runtime-windows 工件,解压后:
python3 -I make_game.py --runtime-build ~/Downloads/runtime-windows它将两个文件复制到 --out 中,并在它们旁边写入 gta6rt.sh,这会使用 wine 启动 gta6rt.exe,或
使用 WINE 指定的 Wine(对于 Proton,为其 files/bin/wine)。相同的选项在 Windows 上跳过构建。
工作原理
| 组件 | 功能 | 位置 |
|---|---|---|
| 版本检查 | 每个受支持版本的每个包文件的名称、大小和 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 映像,将导入解析为垫片(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 记录了我们可能 阅读的先前技术及其许可限制。
想帮忙吗?
最大的开放部分:
- 硬件上的着色器翻译器:compute、mesh 和 geometry 现已支持翻译(参见
docs/design.md 中的翻译器约定);仍未解决的是顶点着色器输入布局(如果主机以 NGG 方式运行 VS,则
v0=VertexIndex尚未验证)以及 32 宽子组上 VS/PS/GS 中的 wave64 跨半代码。 - Xbox D3D12 → Vulkan:
d3d12_xs命令列表和描述符堆模型。 - 解码器目前拒绝的模型布局。
参见 CONTRIBUTING.md。切勿将游戏文件、提取的资源或生成的着色器附加到 issue 或 pull request 中。
致谢
- breadbbbb 的 rpf9-explorer:
tools/rpf9dump使用的 RPF9 模型、纹理池和 AWC 解码器(git 子模块)。 - Mesa(MIT):GFX10 资源描述符布局(
tools/gfx10_formats.json), 以及作为 16 位结果和着色器系统寄存器参考的 ACO/RADV 规则。 - Microsoft 的 libHttpClient(MIT):
third_party/xtaskqueue中的 XTaskQueue/XAsync 实现, 由离线xgameruntimeshim 使用。 - LLVM:AMDGPU 反汇编器。
- Logo:SteamGridDB 上 SlyDevil 的“Grand Theft Auto VI”图标。
- SPIRV-Tools:汇编和验证。
Grand Theft Auto 及所有相关名称均为其所有者的商标。本项目不隶属于他们, 也未获得他们的认可。
许可证
GPLv3(或任何更高版本)。参见 LICENSE。第三方代码保留其自己的许可证。
来源:Hacker News · github.com