ShaolinMonksRecomp

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

1. Download the latest release package for your system.
2. Extract the package.
3. Start the executable in the extracted folder.
4. Select your ISO, XISO, ZIP, extracted game folder, or default.xbe.
5. 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.