Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

ItsNotRexed/Leonida

Games

A static recompilation project that builds an Xbox Series game runtime from your own package on Windows.

106
8
Python
GPL-3.0
new today

What it is

Leonida is a static recompilation project that aims to run the Xbox Series build of Grand Theft Auto VI natively on Windows. Because the console CPU is x86-64, the approach is to load and execute the game code directly while reimplementing the console system software. Precompiled RDNA2 GPU programs are translated to SPIR-V for Vulkan, and models, textures and audio are read from the user's own game package.

The repository does not include the game, keys or an executable, and it does not explain how to obtain them. The project is explicitly early: the game does not boot yet. The version check, shader carving and disassembly (all 26,503 shaders), and asset export for models, textures and audio banks are reported as working. SPIR-V translation covers about 97.4% of vertex/pixel shaders, while compute, mesh and geometry shaders are untranslated. The PE loader is a skeleton, Xbox D3D12 to Vulkan has not started, and nothing is playable.

Build from your own copy

You need the Xbox Series package version 1.0.2.1, readable on disk as plain files, plus a Windows 10/11 x64 machine with roughly 350 GB free for work files. Install Python 3.11+, the .NET 8 SDK, the Vulkan SDK for spirv-as/spirv-val, LLVM 21+ with llvm-mc on PATH, and Visual Studio 2022 with Desktop development for C++.

Clone with the submodule, since a ZIP download omits third_party/rpf9-explorer:

git clone --recursive https://github.com/ItsNotRexed/Leonida

Then either double-click Build.bat or drive the build from a terminal:

python -I make_game.py --find
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"

The stages run as check, shaders, assets, runtime; Build.bat locates the game copy automatically and writes output to Documents\Leonida. A stopped build resumes where it left off. The shader translation stage is currently the longest, taking several hours on one core. See the design notes for the translator's runtime contract and format details, and CONTRIBUTING.md for open work items.

Constraints

  • The project does not supply the game or any bypass for its protections; a user-owned, readable package is a hard prerequisite.
  • The build is Windows-only and requires substantial free disk space, with a work directory that can move to another drive via --work.
  • This is not a finished port: booting, story mode and playable content are all absent, and the PE loader has not been tested against the real executable.
  • Generated assets, shaders and saves should stay on the user's machine and must not be attached to issues or pull requests.
  • Licensed under GPLv3 or later; bundled third-party components keep their own licenses (license).

HotRepo's take

The repository appeared on HotRepo's new-project list on 2026-11-20, gaining its first 102 stars and 7 forks within a few hours of creation. That is a fast early signal, but it reflects interest in the premise rather than a working result: the README itself lists booting and playable content as not started, and the most visible technical milestone is partial shader translation. The project is worth watching as a recompilation research effort, not yet as a way to play the game.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. florinp93/hells-gate-recompPorts Dante's Inferno from Xbox 360 to native PC by static recompilation, with a Vulkan renderer, for players who own the game.C++800
  2. OAleex/OpenShaoA native PC port of Mortal Kombat: Shaolin Monks built by static recompilation, for players who still own the original Xbox disc.C++221
  3. mzzvxm/LARecompA static recompilation of Midnight Club: Los Angeles that turns the Xbox 360 disc you own into a native Windows executable.C++201
  4. SerenityG4K/SpaceAnimalsRecompBuild a native Windows version of your own Star Fox Switch 2 copy via static ARM64-to-C++ recompilation.C++121
  5. Spark198rus/black-pcRun the original Xbox version of BLACK natively on Windows using your own game disc, without an emulator.C++331