Gabrick75 / fh2-recompiled

# FH2 Recompiled
**An unofficial static recompilation of Forza Horizon 2 (Xbox 360) for Android and Linux**
Português · Third-party notices · License: GPL-3.0
> [!IMPORTANT]
> This is a non-commercial fan project for interoperability and preservation research. It is **not** affiliated
> with, endorsed by or sponsored by Microsoft, Xbox Game Studios, Playground Games, Turn 10 Studios or any other
> rights holder. **This repository contains no game files and no game code. The APKs in Releases contain no game
> data and do nothing without files extracted from your own legally obtained copy of the game.** See
> Legal.
## Table of contents
- Overview
- How it works
- Project status
- Requirements
- Building from source
- Running on Android
- Repository layout
- Contributing
- Credits
- Legal
- License
## Overview
FH2 Recompiled translates the PowerPC code of the Xbox 360 executable of Forza Horizon 2 into C++ ahead of time
and compiles it into a native program for ARM64 Android phones and x86-64 Linux. It is built on the
ReXGlue SDK, which provides the Xbox 360 kernel, the runtime and the
emulation of the console's Xenos GPU on Vulkan. An experimental native renderer, which draws the game's GPU
commands straight in Vulkan with translated shaders, is also available.
The Android application includes a launcher with graphics and performance settings, the game read straight from
its disc image (.iso), custom Vulkan drivers, an achievements page, touch controls with an editor, gamepad support
and an in-game performance overlay.
## How it works
| Part | How it runs |
|---|---|
| Game code (CPU) | Recompiled ahead of time: the PowerPC instructions of `default.xex` become C++, built into a native library. There is no interpreter or JIT for the game code. |
| Xbox 360 kernel and system libraries | Reimplemented by the ReXGlue SDK (derived from the Xenia project). |
| GPU (Xenos), emulated | The default. The GPU command stream is interpreted, the EDRAM is reproduced with Vulkan render targets and the shaders are translated to SPIR-V while the game runs. |
| GPU, native (experimental) | Adapted from nfsmw-nx: reads the same command stream and draws it straight in Vulkan with shaders translated ahead of time (XenosRecomp) into a library, `fh2_shaders.nfsp`, built from your own game files. Much faster, with some image errors left. |
| Audio, input, video | ReXGlue SDK, SDL3 and FFmpeg. |
When you build from source, the code generated from the game is produced on your own machine from your own copy
of the game; it is excluded from this repository by `.gitignore`.
## Project status
Work in progress. The game boots, plays its menus and races, but it is far from the original console's frame
rate on phones.
What this project adds on top of the SDK:
- An Android launcher: emulated or native renderer, render resolution in percent, MSAA/FXAA, anisotropic
 filtering, shadow quality (native), world detail (grass, objects, reflections, shadow distance and crowd from
 0.25x t