这个项目有什么用
Leonida 是一个静态重编译(static recompilation)项目,目标是把 Xbox Series 版《Grand Theft Auto VI》的代码在 Windows PC 上原生运行。由于 Xbox Series 的 CPU 本身就是 x86-64 架构,项目直接加载并执行游戏代码,同时重新实现主机系统软件,并把主机预编译的 RDNA2 GPU 程序翻译成 Vulkan 使用的 SPIR-V。所有处理都在你自己的 PC 上、基于你自己的游戏副本完成。
需要先明确一点:README 明确写着「Early. The game does not boot yet.」,即项目处于早期阶段,游戏目前还无法启动。目前完成的是所有不依赖游戏可执行文件的部分,一旦有开发者拿到可执行文件,就可以开始启动相关的工作。
典型使用场景
- 研究主机游戏静态重编译与 GPU 着色器翻译的技术路径;
- 在 PC 上验证 Xbox Series 资源包(模型、纹理、音频)的解析与转换流程;
- 为后续的启动调试、D3D12 到 Vulkan 的转换工作搭建本地构建环境。
适合对主机逆向、图形栈移植感兴趣的个人开发者或小团队;如果你只是想直接玩游戏,当前阶段并不适合。
核心特性
- 静态重编译而非模拟:利用 Xbox Series CPU 与 PC 同为 x86-64 的特点,游戏代码被原生加载执行,主机系统软件则由项目重新实现。
- 着色器翻译到 SPIR-V:主机预编译的 RDNA2 GPU 程序被翻译为 Vulkan 可用的 SPIR-V,并支持把翻译结果预先在 GPU 驱动上创建管线、保存管线缓存,减少首次启动时的编译开销。
- 资源从自有副本读取:模型、纹理与音频直接读取你提供的游戏包,构建过程完全在本地完成。
- 自动定位游戏目录:构建脚本会自行在 Downloads、Desktop、Documents、Games、用户主目录以及各磁盘根目录(向下两层)中查找游戏副本,并通过少量文件大小识别版本,不读取大文件。
- 可断点续建的构建流程:构建被中断后可以从上次的位置继续;阶段按
check、shaders、assets、runtime、pipelines顺序执行,也可以只跑其中部分阶段。
怎么安装
项目不提供现成的移植版下载,必须在你自己的 PC 上、用你自己的游戏副本构建。前提条件如下:
- 你自己的 Xbox Series 游戏包,版本 1.0.2.1;
- Windows 10/11 x64,约 350 GB 可用空间用于工作文件(可通过
--work放到其他磁盘); - Python 3.12+(安装时勾选「Add python.exe to PATH」);
- .NET 8 SDK;
- Vulkan SDK,用于
spirv-as/spirv-val; - LLVM 21+,且带 AMDGPU target 以提供
llvm-mc。官方 Windows 构建不含 AMDGPU target,可用scriptsbuild_llvm_mc.ps1构建原生llvm-mc.exe(需要 git 与 Visual Studio C++ 工具),或安装 WSL 中的llvm-21并把LLVM_MC设为完整命令:LLVM_MC="wsl -d Ubuntu -e /usr/lib/llvm-21/bin/llvm-mc";Linux 上 PATH 中的llvm-mc即可; - Visual Studio 2022,含 Desktop development with C++,用于 runtime 阶段;
- PATH 中的
ffmpeg(可选:用于解码 XMA2 流,使用--wav时必需)。
最简构建步骤:
- 安装上述全部前提条件。
- 带 submodule 克隆仓库(GitHub 的「Download ZIP」会缺少
third_party/rpf9-explorer):git clone --recursive https://github.com/ItsNotRexed/Leonida - 双击
Build.bat。它会自动查找游戏副本、识别版本、检查依赖与剩余空间,并把结果输出到DocumentsLeonida。
你的游戏文件夹是包含 MicrosoftGame.Config 与 .rpf 归档(以普通文件形式存在)的那个目录。
怎么使用
除双击脚本外,也可以在终端中调用 make_game.py,行为一致但控制更细。先确认本机有哪些副本、以及副本是否完整:
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:pathtoyourpackage" --out "D:GamesLeonida" --work "E:leonida-work"
常见进阶用法:
- 只跑部分阶段,例如只做着色器与资源:
python -I make_game.py --stages shaders,assets - 额外把 Opus 解码为 PCM WAV(体积较大,默认关闭):
python -I make_game.py --game "D:pathtoyourpackage" --wav # also decode Opus to PCM WAV (large) - 控制 wave64 模拟开关:
python -I make_game.py --wave64-emulate off # auto (default), on or off; see below默认值
auto会调用vulkaninfo判断,除非所有 GPU 都报告 64 宽 subgroup(或无法判断)否则开启;NVIDIA 与 Intel GPU 的 subgroup 为 32 宽,需要该模拟。该模式与翻译后的着色器保存在一起,切换后会重新翻译。
着色器翻译是最耗时的阶段,默认使用 CPU 线程数一半的进程(--jobs)。
适用场景与注意事项
适合:想研究主机代码静态重编译、RDNA2 着色器到 SPIR-V 翻译、以及 Xbox 资源包解析流程的开发者;愿意自行搭建完整工具链并接受较长构建时间的用户。
不适合:期望开箱即玩的人——README 明确说明游戏目前无法启动,且需要自备 1.0.2.1 版本的游戏包。
需要注意的点:
- 项目以 GPL-3.0 协议开源,使用与分发时需遵守该协议。
- 构建需要大量磁盘空间(约 350 GB 工作文件)和多个外部工具链,缺一不可;脚本会在开始前一次性列出缺失项。
runtime阶段目前只能在 Windows 上构建;在 Linux 上运行make_game.py时不带--stages会自动跳过该阶段,显式请求则会在开始前失败。- Linux 下的 Vulkan 诊断需要 CMake 3.24+、C++20 编译器以及 Vulkan 开发头文件与 loader,构建后把包含
index.json与翻译后 SPIR-V 的目录传给vk_pipeline_check。 - 项目方明确要求:不要在 issue 或 pull request 中附带游戏文件、提取的资源或生成的着色器。
- README 未说明运行时的具体性能表现,官方文档亦未给出相关数据。
项目地址
仓库地址:https://github.com/ItsNotRexed/Leonida
作者/组织:ItsNotRexed
协议:GPL-3.0
Leonida 目前仍处于早期阶段,完成的是不依赖游戏可执行文件的基础设施,其价值更多体现在重编译与着色器翻译的技术实现上,而非可直接游玩的成品。
















iphone duo wireless charging 11天前0
iphone duo wireless charging