# itsnotrexed/leonida

> leonida is a static recompilation project for running the Xbox Series version of Grand Theft Auto VI natively on Windows. It loads the game's x86-64 code directly on the PC, reimplements the console's system software, and translates the RDNA2 GPU programs to SPIR-V for Vulkan. The repository does not contain the game, so the build uses the user's own copy. Python is the main language, with C++ and C# files as well.

Source: https://github.com/itsnotrexed/leonida
Indexed: commit 91b36cf on 2026-11-22 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Language: Python
- Stars: 9,792 at index time
- License: GPL-3.0
- Code health: 6.4/10, Fair
- Last commit: 2026-11-22
- Contributors: 77

## Install

From the README: https://github.com/itsnotrexed/leonida

Clone the leonida repository.
    git clone https://github.com/itsnotrexed/leonida.git

Move into the leonida folder.
    cd leonida

From a terminal, build against your copy of the game, with the output in a chosen folder and the work files on another drive.
    python -I make_game.py --game "D:\path\to\your\package" --out "D:\Games\Leonida" --work "E:\leonida-work"

## How it works

make_game.py is the build driver. It runs the stages check, shaders, assets, runtime and pipelines in order, and its version check compares each package file's name, size and SHA-256 with the supported versions. The shader pipeline starts in tools/shader_carve.py, which carves DXBC containers out of shaders.rpf, and fssm_unpack.py then unpacks the native RDNA2 program. shader_disasm.py disassembles that program with LLVM for gfx1013, and rdna2spirv.py translates it to SPIR-V. Asset export runs through tools/rpf9dump, which finds resources inside RPF9 archives and the loose .ttpf texture pools. The runtime in runtime/ maps the PE image and resolves its imports to shims for GDK, XMem and d3d12_xs, with runtime/src/main.cpp as its entry point. The finished build is written to Documents\Leonida by default.

- runtime/src/main.cpp: entry point
- tools/rpf9dump/Program.cs: entry point
- .github/ISSUE_TEMPLATE/bug_report.yml: central file
- .github/ISSUE_TEMPLATE/config.yml: central file
- .github/dependabot.yml: central file
Modules: tests, tools, runtime, third_party, scripts, root, viewer. 389 files, 94,913 lines, 7,772 symbols.

## Code health

- Score: 6.4/10 (Fair)
- Rank: #192 of 4,000+ indexed repos
- Hotspots: runtime/shims/d3d12_vulkan_device.cpp, runtime/src/vulkan_replay.h, make_game.py, runtime/src/pe_loader.cpp, runtime/src/root_signature.cpp
- Lowest file: tools/rdna2spirv.py
- Dead code: none found

## Maintenance

- Last commit 2026-11-22, first commit 2026-11-20, 635 commits
- 77 contributors, bus factor 5

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/itsnotrexed/leonida/security

## More

- Page: https://repowise.dev/repo/itsnotrexed/leonida
- Ask this codebase: https://repowise.dev/repo/itsnotrexed/leonida/chat
- Docs: https://repowise.dev/repo/itsnotrexed/leonida/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/itsnotrexed/leonida
