OAleex/ShaolinMonksRecomp

A static-recompilation port that turns the Xbox build of Mortal Kombat: Shaolin Monks into a native PC executable — assuming you already own a USA/Europe disc image. This is a preservation and enhancement project, not an emulator, and the README is candid about what works and what doesn't.

The problem

People who want to revisit Shaolin Monks on a modern PC currently have three awkward choices: keep an aging Xbox connected, run it through an emulator, or hunt for a re-release that doesn't exist. Each path adds configuration, and the emulator route in particular means accepting whatever performance and input mapping the emulator layer offers. This project changes that workflow: the game's original machine code is translated to compiled native code ahead of time, so the player launches a normal desktop executable, points it at their own disc image, and plays. The launcher also handles saves, controller binding, language packs and mod installation in one place, replacing a stack of separate tools.

What's different

The mechanism is static recompilation. Rather than emulating Xbox hardware instruction by instruction, the project uses the XboxXBERecomp recompiler to translate the game's code into C++ that is compiled with LLVM/Clang, while the runtime supplies the console services the game expects. The practical payoff is a native binary with your own rendering resolution, render scale, display modes, and keyboard/mouse plus remappable controller support. The README credits Ghidra for function analysis and cites xemu, Cxbx-Reloaded and nxdk as behavior and ABI references.

The trade-off is scope: this is one specific game, not a general Xbox player. The maintainer reports a completed campaign playthrough, but says some graphical issues remain, and explicitly notes that Mortal Kombat II and The Suffering Demo do not run. Mods are supported through a catalog and local .tar.xz packages, with Lua scripting for mod routines, but the README does not describe a blanket compatibility promise for arbitrary content. Development uses AI assistance for analysis, code changes, debugging and docs, with maintainer review and automated plus gameplay validation — worth weighing as a process claim, not independent evidence of quality.

Who should try it

This suits someone who owns the original USA/Europe Xbox release, wants native Windows or Linux playback with modern input and resolution, and is comfortable accepting a port with known graphical defects. It also fits players interested in the mod and localization ecosystem, since the launcher checks a mod catalog on open and supports community language packs.

It is a poor fit for anyone without a legally obtained copy of that specific game, or anyone hoping for a general-purpose Xbox runtime: the README lists other titles as non-working, and nothing suggests it extends beyond this one game. Players unwilling to use an existing disc image are also out of scope, as setup expects an ISO, XISO, ZIP, or extracted folder.

Requirements and limitations

Hardware and OS requirements are specific: an x64 CPU with SSE4.2 and POPCNT, Windows 10 1903+ or Linux with glibc 2.38+, and a GPU supporting Direct3D 12 or Vulkan 1.3 (Vulkan 1.2 only with dynamic rendering). Older GPUs or distros will fail here, so check before downloading. The launcher needs the selected image or complete game folder kept available, and moving user data folders requires closing the game and launcher first — an upkeep detail listed in the troubleshooting notes.

Ongoing care means keeping the game image in place, managing mod packages carefully (a failed installation preserves the previous mod, per the README), and reporting problems with the session log attached. Controller mappings and vibration details live in the controller settings, and building from source is covered in BUILDING.md.

HotRepo's take

The repository was 7 days old when HotRepo first tracked it on 2026-10-24, and it appeared on the NEW-REPOSITORY board for C++ at #22 with 211 total stars on 2026-10-25 — a snapshot, not a daily growth figure. With no comparable daily-board history, persistence cannot be judged. Before adopting, verify your GPU hits the D3D12 or Vulkan bar and that your copy is the USA/Europe release the port expects.