Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/hedge-dev/UnleashedRecomp/llms.txt

Use this file to discover all available pages before exploring further.

Unleashed Recompiled brings the Xbox 360 version of Sonic Unleashed to PC through the process of static recompilation — converting the game’s original PowerPC code and Xenos shaders directly into optimized C++ and HLSL. The result is a native PC build that supports Windows, Linux, and macOS with a wide range of enhancements that go far beyond what emulation can offer.
This project does not include any game assets. You must provide files from your own legally acquired copy of Sonic Unleashed for Xbox 360 (US or EU — JP is not supported).

System Requirements

Check the minimum CPU, GPU, RAM, and OS requirements before you get started.

Acquire Game Files

Learn how to dump your game files from an Xbox 360 hard drive or USB device.

Install the Game

Run the built-in installer wizard to set up the game on Windows or Linux.

Configuration Reference

Explore every option in config.toml — video, audio, input, and more.

Mod Support

Use Hedge Mod Manager to install and manage mods for Unleashed Recompiled.

Build from Source

Compile Unleashed Recompiled yourself on Windows, Linux, or macOS.

What Makes This Different

Unlike emulation, static recompilation converts the original game code ahead of time into native machine code. This approach unlocks improvements that are simply impossible in an emulator.

Zero Shader Stutter

Pipeline compilation is integrated into the asset loading process, eliminating in-gameplay stutter entirely.

High Frame Rates

Play at 60 FPS, 120 FPS, or uncapped — with extensive fixes for frame-rate-dependent game bugs.

High Resolution & Ultrawide

Full support for any resolution with MSAA, enhanced depth of field, and 21:9+ aspect ratios.

Native Mod Support

Compatible with Hedge Mod Manager and the Sonic Generations mod format out of the box.

Quick Start

1

Check System Requirements

Make sure your PC meets the minimum requirements — specifically AVX CPU support and a GPU with D3D12 or Vulkan 1.2.
2

Dump Your Game Files

Follow the Xbox 360 Hard Drive guide or USB guide to extract your legally owned copy of Sonic Unleashed.
3

Download and Run the Installer

Download the latest release, extract it, and run the executable. The built-in wizard will guide you through the rest.
4

Configure and Play

Adjust graphics, audio, and input settings from the in-game Options Menu accessible on the title screen.
Save data and configuration are stored at %APPDATA%\UnleashedRecomp\ on Windows and ~/.config/UnleashedRecomp/ on Linux. Create a portable.txt file in the install directory to store everything locally instead.

Build docs developers (and LLMs) love