Grand Theft Auto IV · Liberty Recompiled

<p align="center"> <img src="docs/images/banner_repo.png" alt="Liberty Recompiled" width="800"/> </p>

---

[!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.

Table of Contents

• Project Status
• Installation
• Mod Support
• Building
• Documentation

Project Status

This project is in early development. Current progress:

Completed

• 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

In Progress

• RAGE engine structure reverse engineering
• GPU/rendering pipeline implementation
• Game-specific patches and fixes

Completed (Previously TODO)

• 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)

Installation

Platform Install Directories

Platform	Install Directory
Windows	%LOCALAPPDATA%\LibertyRecomp\
Linux	~/.local/share/LibertyRecomp/
macOS	~/Library/Application Support/LibertyRecomp/

Game Files Required

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.

Launch Arguments

Argument	Description
--install	Force reinstallation (useful if game files were modified)
--install-dlc	Force DLC installation only
--install-check	Verify file integrity

Mod Support

Liberty Recompiled includes FusionFix-compatible mod loading. Mods can override game files by placing them in overlay folders.

Quick Start

1. Create an update/ folder next to the LibertyRecomp executable
2. Place mod files inside, mirroring the game's folder structure
3. 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

Supported Overlay Locations

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.

Building

Install the platform prerequisites, then:

git clone https://github.com/OZORDI/LibertyRecomp.git
cd LibertyRecomp
python3 tools/setup_repo.py

Setup 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.py

See Building Liberty Recompiled for build presets, CMake 4 support, prerequisites, and recovery from incomplete/manual dependency downloads.

Documentation

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

Performance comparison of GTA IV running on macOS using different methods:

Method	Screenshot
Crossover (Wine)
Xenia (Xbox 360 Emulator)
RPCS3 (PS3 Emulator)