KraftMacAndChee / Mercenaries-Recompiled

# Mercenaries Recompiled
DISCLAIMER: This project utilized a hybrid-workflow and iterative development.
 It was built with the assistance of Codex 5.6 Sol and Astra!
A native Windows port of **Mercenaries: Playground of Destruction**, built with
xboxrecomp. The project translates the
original Xbox executable into C and supplies compatibility layers for graphics,
audio, input, memory, and kernel services.
**You must supply your own supported retail Xbox copy of the game.** This source
repository does not include a disc image, extracted game-data tree, or generated
game executable. A PS2 disc is not a substitute for the Xbox build input.
Build guide ·
Documentation ·
Architecture ·
Contributing ·
Dependencies and licenses
## What is in this repository?
This is the maintained source, translation tooling, tests, documentation, and
pinned dependencies for the Windows x64 port. Features include keyboard/mouse
and controller support, configurable controls, resolution and aspect-ratio
options, an FPS cap, and selectable original-game bug compatibility. See the
default controls and
OG Bugs behavior for details.
The source archive is a developer package. It must be built before it can be
played. A player release is a separate package containing the launcher, native
runtime, dependencies, and first-launch instructions.
Windows x64 is the supported native build. Wine/Proton runs the Windows payload
as a separate compatibility path. The reusable toolkit's POSIX/OpenGL code does
not imply a supported native Linux or macOS Mercenaries build.
## Build from source
Install these prerequisites:
- Python **3.12**, available through the Windows `py` launcher.
- Visual Studio **2022**, with the C++ desktop build tools, MSVC
 **14.44.35207**, and Windows SDK **10.0.26100.0**.
- PowerShell 7 or Windows PowerShell 5.1.
- Your legally obtained **USA retail Xbox Mercenaries ISO**.
From the repository root in PowerShell:
 [code] 
The example ISO path is a placeholder. Setup creates `.venv` and installs the
pinned Python dependencies; this step needs access to the Python package index
or an appropriate local cache. The extractor and required runtime libraries are
bundled with their notices. Visual Studio and the Windows SDK must already be
installed.
The script extracts and verifies the retail input, generates and patches the
translated C, builds the runtime and launcher, and writes build provenance.
The supported `default.xbe` SHA-256 is:
 [code] 
Default output:
 [code] 
Keep the DLLs and supporting directories beside those executables. Start
`Mercenaries Recompiled.exe` and select the supported ISO when prompted.
See the port guide for the installation contract
and release maintenance for player packaging.
A root-only CMake build produces toolkit libraries, not the game executable.
Do not edit `ports/mercenaries/src/recomp/gen` to make permanent fixes. Its
contents are regenerated; durable patches belong in the maintained generator,
patch script, or port integration code.