RanggaCasper / ShaolinMonks-Android

# Mortal Kombat: Shaolin Monks for Android
An unofficial native Android port of the original Xbox version of *Mortal Kombat: Shaolin Monks*, with touch controls, controller and keyboard support and extended graphics options.
The game's x86 code is statically recompiled ahead of time to C++ with XboxXBE-Recomp, then built for arm64. Drawing goes through Vulkan, and windowing, input and audio through SDL3. No emulator is involved. The Android host (Vulkan renderer, DirectSound, touch controls, settings panel) comes from Black-Android.
*Gameplay on a Xiaomi Pad 7 at 60 FPS (watch on YouTube).*
> [!NOTE]
> 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.
> [!WARNING]
> Work in progress. The port builds, but it has not been played through on a device yet. See Status.
## Installation
1. Install the APK.
2. Open **Shaolin Monks** and allow **all files access** when it asks (on Android 10, the **storage** permission).
3. Copy the game into `/storage/emulated/0/ShaolinMonks`, or into a `ShaolinMonks` folder at the top of your SD card: either the disc image (`.iso`) or `default.xbe` with the rest of the disc's files and folders (`GAMEDATA.WA*`, `front`, `English`, `classic`, ...). The app creates the folder on the phone's storage once access is allowed, and starts the game as soon as it finds the files.
If you don't grant that access, `Android/data/com.racas.shaolinmonks/files/assets` works too.
Settings (`shaolinmonks.toml`, `android.toml`, `layout.toml`), saves (`hdd`), logs and the shader cache are stored in `Android/data/com.racas.shaolinmonks/files`.
The disc is the same for the USA and Europe releases (one `default.xbe`, SHA-1 `20e283c44fdb6062a760e4732d765036bac18067`).
## Features
The settings panel opens from the gear at the top left of the screen (or F10 on a keyboard). Android's back button is the controller's Start, which pauses the game.
### Graphics
- **Render Resolution**: 20% to 200% of the screen's height, instead of the original 640x480.
- **V-Sync**, **Max Frame Rate** (unlimited, the display's refresh rate or a custom cap) and an **FPS Counter**.
- **Anisotropic Filtering**, applied to all textures.
### Touch Controls
A full Xbox controller on the screen:
- The left side of the screen is the **left stick**, wherever your thumb comes down. A drag on the right side of the screen is the **right stick**.
- **A**, **B**, **X**, **Y** in the controller's diamond and colours, **Black** and **White**, the **triggers**, **Start**, **Back** and a **D-pad**.
- **Controls Layout**: *Default* (triggers at the top corners) or *Low Triggers*, with the controls' opacity and overall size.
- **Edit Controls Position**: drag each control where you want it. To resize one, select it and tap **−** or **+**, or pinch it with a second finger.
### Other Input
- **Controller**: any controller SDL3 supports, with rumble. The touch controls hide while a controller is in u