Caution
This recompilation is in early development and is NOT meant for public use. This is a work-in-progress fork based on the MarathonRecomp framework.
Liberty Recompiled is an unofficial PC port of the Xbox 360 version of Grand Theft Auto IV created through the process of static recompilation. The port aims to offer Windows, Linux, and macOS support.
This project does not include any game assets. You must provide the files from your own legally acquired copy of the game to install or build Liberty Recompiled.
The runtime is powered by a fork of the ReXGlue SDK (our fork), which handles PowerPC → C++ recompilation and Xenos shader translation. The development of static recompilation tooling in this space was directly inspired by N64: Recompiled, which was used to create Zelda 64: Recompiled.
This project is in early development. Current progress:
- ReXGlue SDK integration for PowerPC → C++ translation and shader conversion
- Cross-platform build system (Windows, Linux, macOS)
- Installer wizard with ISO/folder/XContent support
- Shader extraction pipeline (RAGE FXC → Xbox 360 → platform-native)
- Platform-specific install directory support
- FusionFix-compatible mod overlay system
- RAGE engine structure reverse engineering
- GPU/rendering pipeline implementation
- Game-specific patches and fixes
- Audio system implementation (XMA decoder, SDL2 driver)
- Save data handling (full save system with GTA IV format support)
- Input remapping for GTA IV controls (SDL HID driver, GTA4 input patches)
- Network/multiplayer stubs (NetDll_XNetStartup, XLive stubs)
- Online multiplayer via GameNetworkingSockets (P2P with NAT traversal, no VPN required)
- File system and RPF archive handling (VFS)
| Platform | Install Directory |
|---|---|
| Windows | %LOCALAPPDATA%\LibertyRecomp\ |
| Linux | ~/.local/share/LibertyRecomp/ |
| macOS | ~/Library/Application Support/LibertyRecomp/ |
You need a legal copy of GTA IV for Xbox 360. Supported formats:
- Xbox 360 disc images (
.iso) - Extracted game folders
- XContent packages
See Dumping Guide for detailed extraction instructions.
| Argument | Description |
|---|---|
--install |
Force reinstallation (useful if game files were modified) |
--install-dlc |
Force DLC installation only |
--install-check |
Verify file integrity |
Liberty Recompiled includes FusionFix-compatible mod loading. Mods can override game files by placing them in overlay folders.
- Create an
update/folder next to the LibertyRecomp executable - Place mod files inside, mirroring the game's folder structure
- Launch the game - mod files automatically override base files
LibertyRecomp/
├── game/ # Extracted game files
└── update/ # Place mods here
└── common/
└── data/
└── handling.dat # Overrides base handling.dat
| Priority | Location | Description |
|---|---|---|
| 100 | mods/update/ |
Highest priority |
| 50 | update/ |
Standard FusionFix location |
| 40 | GTAIV.EFLC.FusionFix/update/ |
Alternative location |
See MOD_SUPPORT.md for detailed documentation.
Install the platform prerequisites, then:
git clone https://github.com/OZORDI/LibertyRecomp.git
cd LibertyRecomp
python3 tools/setup_repo.pySetup fetches all pinned dependencies and applies the required source patches.
On Windows use py -3 instead of python3. After pulling an update:
git -c submodule.recurse=false pull --ff-only
python3 tools/setup_repo.pySee Building Liberty Recompiled for build presets, CMake 4 support, prerequisites, and recovery from incomplete/manual dependency downloads.
| Document | Description |
|---|---|
| Building Guide | Build instructions for all platforms |
| Dumping Guide | How to extract game files from Xbox 360 |
| Mod Support | FusionFix-compatible mod loading |
| Installation Architecture | Platform paths and install flow |
| Online Multiplayer Guide | Setup guide for online play |
Performance comparison of GTA IV running on macOS using different methods:
| Method | Screenshot |
|---|---|
| Crossover (Wine) |  |
| Xenia (Xbox 360 Emulator) |  |
| RPCS3 (PS3 Emulator) |  |