Fork from https://github.com/hedge-dev/UnleashedRecomp
This repository is a recompilation project of the Xbox 360 version of Sonic Unleashed. By translating original PowerPC binaries into native machine code (ARM64 / x86-64). Fork includes Android support with Vulkan 1.3, Oboe High-Performance Audio, and NDK 29 optimizations.
Important
Game assets are NOT included. You must provide your own legally acquired Xbox 360 copy of Sonic Unleashed and its updates.
This fork has been optimized and modernized, still WIP so expect build to break.
- Advanced Architecture: Native optimization for ARMv8.2-A (including Crypto, CRC, DotProd, and FP16 instructions) on Android.
- Ultra-Aggressive Compilation: Utilizes Full LTO (Link Time Optimization), O3 optimization levels, and Fast Math.
- Parallel Execution Engine: Powered by Intel TBB and C++20 parallel algorithms to accelerate asset loading, hashing, and GPU pipeline pre-compilation.
- Background Pipeline Pre-compilation: Background compilation of graphics pipelines (MSAA, Blur, etc.) .
- Zero-Allocation I/O: High-performance STFS and SVOD parsing with zero-allocation string handling and memory-mapped I/O.
- Vulkan 1.3: Utilizes the latest Vulkan standards for rendering efficiency and modern GPU features.
- Oboe High-Performance Audio: Integrated Google's Oboe library for the lowest possible audio latency using AAudio.
- Sustained Performance Mode: Native Android API integration to lock CPU/GPU clocks and prevent thermal throttling.
- Enhanced HID & Input: Refined controller handling with dynamic button prompt switching (Xbox/PS) and optimized multi-touch overlay.
- Cross-Platform Mastery: Full native support for Windows and Linux (including Steam Deck).
- Visual Fidelity: Native support for Resolution Scaling, Ultrawide Aspect Ratio patches, and high-fidelity shadow resolution (up to 8K).
- Modding Support: Seamless integration with the Hedge Mod Manager ecosystem.
| Requirement | Android | Windows / Linux |
|---|---|---|
| Architecture | ARMv8.2-A 64-bit REQUIRED | x86-64 (Amd64) |
| OS Version | Android 8.0+ (Targeting Android 15) | Win 10/11 / Ubuntu 24.04+ |
| Graphics API | Vulkan 1.3 REQUIRED | Vulkan 1.2+ |
| RAM | 4 GB (Strict Guest Allocation) | 8 GB+ Recommended |
| Storage | 10-15 GB (High-speed internal) | 10-15 GB |
Build for any platform without local setup:
- Fork this repository.
- Go to the Actions tab -> Release workflow -> Run workflow.
- Select your target OS (Android, Windows, or Linux).
- Dynamic Asset Ingestion: Provide URLs for your assets (ZIP, RAR, 7Z, ISO, or XEX) — the CI extracts and prepares them automatically!
cmake(3.22+),git,ninja-build,libtbb-dev.- Android: Android SDK, NDK 29.0.14206865, Java 17.
- Windows: Visual Studio 2022 with Clang-cl and LLVM 18+.
- Linux:
gcc-13/g++-13and Vulkan SDK.
cmake --preset x64-Clang-Release
cmake --build out/build/x64-Clang-Release --config Release --parallelcmake --preset linux-release
cmake --build out/build/linux-release --config Release --parallel
# Optional Flatpak
flatpak-builder --user --install --force-clean build flatpak/io.github.hedge_dev.unleashedrecomp.json# 1. Build host-side tools first
chmod +x ./build_tools.sh && ./build_tools.sh
# 2. Set NDK path (REQUIRED: 29.0.14206865)
export ANDROID_NDK_HOME=/path/to/android-sdk/ndk/29.0.14206865
# 3. Compile the APK
chmod +x ./build_android.sh && ./build_android.shSonic Unleashed Recompiled is an unofficial fan-made project. It is not affiliated with, authorized, or endorsed by SEGA® or Sonic Team™. This project is intended for educational purposes and requires legally owned game assets.
