Shaolin Monks Recomp
Important
Shaolin Monks Recomp does not include the original game or its assets. You must provide your own legally obtained USA/Europe Xbox copy of Mortal Kombat: Shaolin Monks.
A PC port of Mortal Kombat: Shaolin Monks, made through static recompilation.
The original Xbox code runs natively on the PC. The port adds resolution and render scale settings, display modes, keyboard and mouse input, and remappable controller buttons.
The maintainer reports a completed campaign playthrough. Some graphical issues remain.
Mortal Kombat II and The Suffering Demo do not run.
System requirements
| Component | Requirement |
|---|---|
| CPU | x64 processor with SSE4.2 and POPCNT |
| System | Windows 10 version 1903 or later, or Linux with glibc 2.38 or later |
| GPU | Direct3D 12, or Vulkan 1.3. Vulkan 1.2 requires dynamic rendering. |
| Input | Keyboard and mouse, or a compatible controller |
| Game files | Original USA/Europe Xbox release |
Getting started
- Download the latest release package for your system.
- Extract the package.
- Start the executable in the extracted folder.
- Select your ISO, XISO, ZIP, extracted game folder, or
default.xbe. - Select Save and Play in the launcher.
The runtime reads ISO and XISO images directly. Setup imports ZIP contents once. Keep the selected image or complete game folder available. You can change it in the launcher's Files and support tab.
Controls
Xbox, PlayStation, and other SDL-compatible controllers support connection and disconnection during play. DualShock 4 works through USB or Bluetooth. The game displays Xbox button prompts.
| Xbox input | Keyboard | Mouse | PlayStation |
|---|---|---|---|
| Left stick | W / A / S / D | - | Left stick |
| Direction pad | Arrow keys | - | Direction pad |
| A | Space | - | Cross |
| B | Esc or Ctrl | Right button | Circle |
| X | J | Left button | Square |
| Y | K | Middle button | Triangle |
| White | Q | Side button 2 | L1 |
| Black | C | Side button 1 | R1 |
| Left trigger | Shift | - | L2 |
| Right trigger | E | - | R2 |
| Start | Enter | - | Options |
| Back | Backspace | - | Share |
| Right stick | - | Movement | Right stick |
| FPS and frame time | F9 | - | - |
| Release / capture pointer | F10 | Click to capture | - |
See controller settings for mappings, vibration, and connection details.
Languages
| Language | Interface | Voice acting |
|---|---|---|
| English | Available | Available |
| French | Available | Available |
| German | Available | Available |
| Spanish | Available | Available |
| Italian | Available | Available |
| Brazilian Portuguese | Available | Available |
Some languages require a language pack.
Mods
The launcher reads the official mod catalog from the Krypt.
It checks for mod updates when it opens.
Manage installed mods in Mods, or use Install from file... for a local .tar.xz package.
A failed installation preserves the previous mod.
New mods and languages appear from the catalog. See mod authoring for supported content and routine changes.
User files
Open Files and support to view your data and saves folders.
| Folder | Contents |
|---|---|
| Data | Settings, logs, cache, crash reports, mods and imported ZIP games |
| Saves | The hdd folder, including save backups |
To move a folder, close other copies of the game and launcher first. Choose an empty destination in Files and support. Save your settings. Restart the launcher to move the files. See troubleshooting for default paths and command-line options.
Error dialogs identify the session log. Include that log when you report a problem.
Credits
- TGP482 / XboxXBERecomp: static recompiler and Xbox runtime.
- LLVM / Clang: native code compilation.
- Ghidra: executable analysis and function inspection.
- SDL: controller input, device detection and platform services.
- Vulkan-Headers and glslang: graphics headers and shader compilation.
- Dear ImGui: host interface and performance display.
- toml++: configuration files.
- miniz: ZIP imports and language resource decompression.
- XZ Embedded: mod package decompression.
- Lua: mod routine scripts.
- xemu, Cxbx-Reloaded, and nxdk: behavior and ABI references.
- OAleex Traduções: translation and dubbing. See the contributors.
See BUILDING.md to build from source, or TROUBLESHOOTING.md to report a problem.
AI usage
The development process uses AI assistance for executable analysis, code changes, debugging, tests, build scripts, and documentation. The maintainer reviews these contributions. Validation includes automated tests and gameplay checks.
License
The project code uses GPL-2.0-or-later. See LICENSE, tools and dependencies, and dependency notices. The project license does not grant rights to the original game or its artwork. This project is not affiliated with or endorsed by the owners of Mortal Kombat or Xbox.