How to Build Leonida
Leonida is not downloaded ready-made. It is built on your own PC, from your own copy of the game. This page explains what the build needs and what its stages do, in plain language.
Read this first: the game does not boot yet. Running the build today is useful for testers and contributors. It will not let you play.

Build Readiness Check
Tick what you already have. The list follows the prerequisites in the project README. Your ticks stay in this browser only.
Your build readiness, saved only on this device
The project lists these prerequisites and about 350 GB of free space for work files. Tick each one you have and enter your free space to see what is still missing.
The Build, Step by Step
- Install the tools. Python, the .NET 8 SDK, the Vulkan SDK, a suitable LLVM and Visual Studio 2022. The list above has the details.
- Get the code with its submodule. Clone with the recursive option. A ZIP download leaves a required folder out.
- Start the build. On Windows, double-click
Build.bat. It checks that every tool is installed and that there is enough free space, and lists anything missing in one go. - Let it find your copy. It searches common folders and the top of every drive, two folders deep. If it finds several copies it asks which one. If it finds none it asks for the folder.
- Wait. The stages run in order. Shader translation is the long one. If you stop the build, it carries on from where it stopped next time.
- Find the result. By default it goes to a Leonida folder inside Documents.
The same build can be run from a terminal with make_game.py for more control, for example to put the work files on another drive or to run only some stages.
The Five Stages
| Stage | What it does |
|---|---|
check | Confirms your copy is a supported version |
shaders | Extracts, disassembles and translates the graphics programs |
assets | Exports models, textures and audio |
runtime | Builds the Windows loader |
pipelines | Creates every shader once on your GPU and saves a cache |
Stage names from the project README, November 22, 2026.
About "Your Own Copy"
The build expects the Xbox Series package, version 1.0.2.1, as ordinary files in a folder: the one that holds MicrosoftGame.Config and the .rpf archives.
That is the hard part, and it is worth being honest about it. A game installed on a console is not sitting there as plain files you can copy. The project says clearly that it does not contain the game or keys, does not decrypt anything, and does not explain how to get a readable copy.
We follow the same line. This site does not host, link to or describe how to obtain game files. Copies offered for download on other sites are not yours, and they are one of the most common ways malware is spread right now. See the safety page.
Graphics Card Options in the Build
Most people can leave these alone. They exist because the console's shaders were written for one specific AMD chip.
- Wave64 emulation. On by default when your card needs it, which includes NVIDIA and Intel cards. The setting is saved, and changing it translates the shaders again.
- Fallback flags. Four switches cover cards that lack a specific Vulkan feature, such as mesh shaders.
- Jobs. Shader translation uses half of your CPU threads unless you tell it otherwise.
The README and its design notes describe each option in full. If the words above mean nothing to you, the defaults are the right choice.
Hardware That Helps With Big Builds
Disclosure: As an Amazon Associate we earn from qualifying purchases made through the hardware links on this page at no extra cost to you.
Internal NVMe SSDs, 1 TB and Up
The build asks for about 350 GB of free space for work files alone. A spare fast drive keeps it off your system disk.
Portable USB-C SSDs
The work folder can live on another drive with the --work option, so an external SSD is a simple way to add room.
PC Game Controllers
The runtime reads controllers through SDL3, which covers most modern pads. Useful for the PC games you can play today.
Building Leonida: Common Questions
Can I build Leonida and play GTA 6 on PC?
You can run the build stages that exist, but you cannot play. On November 22, 2026 the project said the game does not boot yet. A finished build gives you translated shaders and exported assets, not a working game.
How much disk space does the Leonida build need?
The README asks for about 350 GB of free space for work files, on top of the game package itself. The work folder can be placed on another drive.
Do I need to own GTA 6 to use Leonida?
Yes. The project is built around your own copy of the Xbox Series version and ships no game files. It does not explain how to get the game's files onto a PC, and this site does not either.
Does the build work on Linux?
The build script runs on Linux, and the README describes cross-building the Windows runtime and running the loader under Wine or Proton. The easy double-click path is Windows only.
Which step takes the longest?
Shader translation. The README says it is the longest step and that it runs on half of your CPU threads by default. A stopped build continues where it left off.