OAleex/OpenShao

Games

A native PC port of Mortal Kombat: Shaolin Monks built by static recompilation, for players who still own the original Xbox disc.

221
9
C++
GPL-2.0
8 days old

Worth trying if you already own a USA or Europe Xbox copy of Shaolin Monks and want to play it on PC with widescreen, mouse camera and local co-op without emulator fiddling. This is a single-title recompilation, not a general emulator.

The problem

Playing an original-Xbox title on a modern PC usually means configuring an emulator: BIOS or system files, per-game settings, controller mapping, and often a compromise on resolution or couch co-op. OpenShao instead turns a copy of the game you already own into a native x64 executable, so the launcher reads your ISO, XISO, ZIP, extracted folder or default.xbe in place and starts it. The game image stays where it is, and saves, settings and logs live in documented folders rather than inside an emulator profile. What you get is a desktop program with its own in-game settings menu and pause menu, not a frontend wrapped around an emulated console.

What's different

The distinguishing mechanism is static recompilation through XboxXBERecomp: the Xbox executable is translated ahead of time into C++ rather than interpreted at runtime, and the repository documents how to rebuild that output yourself project instructions. In practice that gives the port native rendering controls: render scale from 25% to 400%, anisotropic filtering, V-Sync, and widescreen ratios from 16:9 up to 32:9 while keeping the original 4:3 as default. It also adds input choices an emulator setup may not offer out of the box, such as mouse camera and separate text and voice languages, plus launcher-managed mods from a catalog and a Brazilian Portuguese language pack mod guide.

The trade-off is specificity. This is one game, and only the original USA/Europe release passes the validity check; renamed or converted images from other releases are rejected. The port targets Direct3D 12 or Vulkan 1.2 with dynamic rendering and timeline semaphores, and on Linux needs glibc 2.38 or later plus system libcurl for mod and update downloads. Recompilation is also not the same as a compatibility harness: the author lists known gaps, including Mortal Kombat II and The Suffering demo not running, occasional graphical issues, and brief pauses when a scene's shaders compile the first time known issues.

Who should try it

A good fit is someone with a legitimate Xbox copy, a reasonably modern Windows or Linux machine and an interest in couch co-op: local Ko-op supports keyboard and mouse plus one controller, or two controllers, and the controller remapping covers SDL-compatible devices. A poor fit is anyone without that specific disc region, or someone hoping to run a modified or converted image; the validity check will stop them, and there is no alternate image path documented. It is also a poor match for someone who wants a general Xbox emulator to play several titles, since OpenShao is built around this one executable. For users who mainly want to build from source rather than use a release, a documented build path exists but is a substantially heavier commitment build instructions.

Requirements and limitations

Four constraints matter most. First, the game itself is not included, so you must supply your own USA/Europe Xbox copy; without it the launcher will not accept your image. Second, the graphics requirements are explicit: a Direct3D 12 GPU or Vulkan 1.2 with dynamic rendering and timeline semaphores, plus an x64 CPU with SSE4.2 and POPCNT. Third, platform support is Windows 10 1903+ or Linux with glibc 2.38+, and Linux users need system libcurl for launcher downloads. Fourth, ongoing upkeep includes launcher auto-updates that preserve saves, settings and mods, and a recovery path if display settings make the game fail to start: the launcher's Files > Video > Restore option requirements.

Expect shader-compilation pauses on first view of a scene and some remaining graphical problems worth reporting with a screenshot and the latest log; the game is capped at 60 FPS, and lowering render scale is the documented performance lever. Mods and language packs are installed through the launcher rather than by hand README.

HotRepo's take

HotRepo recorded 221 total stars and rank #22 on its NEW-REPOSITORY board for cpp on 2026-10-26, but that is a single dated snapshot, not a daily growth series. With no comparable daily-board history, persistence of interest cannot yet be judged. Before downloading, check that your disc is the supported USA/Europe release and that your GPU meets the listed rendering requirements; those two checks decide whether the port is usable for you.

Written by AI from the project's README, updated October 26, 2026. The project's own docs are the source of truth.