GitHub 热门项目推荐:Leonida(Python|5590 Star)

这个项目有什么用

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 时必需)。

最简构建步骤:

  1. 安装上述全部前提条件。
  2. 带 submodule 克隆仓库(GitHub 的「Download ZIP」会缺少 third_party/rpf9-explorer):
    git clone --recursive https://github.com/ItsNotRexed/Leonida
  3. 双击 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 目前仍处于早期阶段,完成的是不依赖游戏可执行文件的基础设施,其价值更多体现在重编译与着色器翻译的技术实现上,而非可直接游玩的成品。

© 版权声明
THE END
喜欢就支持一下吧
点赞10 分享