Skip to content

An unofficial PC port of the Xbox 360 version of Grand Theft Auto V created through the process of static recompilation. Based on LibertyRecomp

License

Notifications You must be signed in to change notification settings

OZORDI/SanRecomp

Repository files navigation

San Recompiled

GTA V Xbox 360 Static Recompilation Project


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.

San Recompiled is an unofficial PC port of the Xbox 360 version of Grand Theft Auto V 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 San Recompiled.

XenonRecomp is the main recompiler used for converting the game's original PowerPC code into compatible C++ code. The development of this recompiler was directly inspired by N64: Recompiled, which was used to create Zelda 64: Recompiled.

Table of Contents

Project Status

This project is in early development. Current progress:

Completed

  • XenonRecomp integration for PowerPC → C++ translation
  • Cross-platform build system (Windows, Linux, macOS)
  • Installer wizard with ISO/folder/XContent support
  • Platform-specific install directory support

In Progress

  • XenosRecomp integration for Xenos → HLSL shader conversion
  • RAGE engine structure reverse engineering
  • GPU/rendering pipeline implementation
  • Game-specific patches and fixes
  • Audio system implementation
  • Save data handling
  • Input remapping for GTA V controls

Installation

Platform Install Directories

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

Game Files Required

You need a legal copy of GTA V 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

Building

Check out the building instructions here.

Quick Start

# Clone with submodules
git clone --recurse-submodules https://github.com/OZORDI/SanRecomp.git
cd SanRecomp

# Add game files to SanRecompLib/private/
# - default.xex
# - Files from GTA V Xbox 360

# Configure and build (macOS example)
cmake . --preset macos-release
cmake --build ./out/build/macos-release --target SanRecomp

Documentation

Document Description
Building Guide Build instructions for all platforms
Dumping Guide How to extract game files from Xbox 360

About

An unofficial PC port of the Xbox 360 version of Grand Theft Auto V created through the process of static recompilation. Based on LibertyRecomp

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published