# Mega Man X Recompiled ## Windows frame composition The pinned shared framework uses cached HLE frame composition by default on Windows x64. Guest CPU, mapper, audio and status behavior keep their existing interfaces; this is a host presentation optimization. For the maintained correctness-reference compositor, configure a separate Release build with `cmake -S . -B build-frame-lle -DCMAKE_BUILD_TYPE=Release -DSNESRECOMP_FRAME_IMPL=LLE`, then `cmake --build build-frame-lle`. Selection is fixed at build time. LLE can reduce performance; it remains available for correctness checks. Other platforms keep LLE defaults, and existing CMake cache selections are preserved. See [HLE defaults and opt-out](snesrecomp/docs/HLE_DEFAULTS.md). The reviewed native-view, uncapped Windows route measured 340.936 to 889.911 FPS (+161.02%, process CPU -67.17%); it includes boot/menu work and active gameplay. The owner accepted the normal-paced adaptive HLE build. These figures describe that measured build/route, not a new measurement of subsequent upstream title changes or other platforms. Foreign compiler activity limits precision. Normal play retains normal pacing/audio. See the shared framework's [frame model](snesrecomp/docs/FRAME_MODEL_HOSTS.md) for the host/guest boundary. Play *Mega Man X* on PC with playable Zero, couch co-op and online netplay, all sixteen X2/X3 boss weapons, and adaptive widescreen. Choose Zero's original X3 combat, the optional Modern style with direct saber attacks, a second jump, and an air dash, or [Saber Zero](#saber-zero) by RaphaelAzev. [Download](https://github.com/mstan/MegaManXSNESRecomp/releases/latest) | [Getting started](#quick-start-pre-built-release) | [Netplay setup](docs/netplay.md) ## Saber Zero **Saber Zero** is contributed by [RaphaelAzev](https://github.com/RaphaelAzev), from the [MegaManXSNESRecompSaberZero](https://github.com/RaphaelAzev/MegaManXSNESRecompSaberZero) fork. It gives Zero a Y-button Z-Saber: a 3-hit ground combo, air, wall and dash slashes, the X3 finisher with its Saber wave, hit-priority follow-ups, and Ride Armor pilot art. The X button keeps Zero's buster and special weapons. To play it, choose **Zero behavior → Saber Zero** in either **Characters → Add Zero** (single player, Select switches X/Zero) or **Characters → Co-op** (whichever player is Zero). Both use your Mega Man X3 USA ROM, like the other Zero modes. The optional **Characters → Saber Zero settings** entry tunes its damage, hit priorities, finisher window and swing volume, and can outline hitboxes. Without it, Saber Zero uses RaphaelAzev's defaults. The Saber sprites and sound effects come from the [Zashiko Mod](assets/saber-zero/CREDITS.md). They are included with permission for non-commercial use only. Controls, timings, the priority ladder and every option are in the [Saber Zero reference](docs/saber-zero.md). Watch the Mega Man X Recompiled gameplay showcase on YouTube *Click the thumbnail to watch the gameplay showcase on YouTube.*
X and Zero fighting Thunder Slimer together, with separate health bars
X / Zero co-op
Fight through X1 together, locally or over netplay. 		Modern Zero swinging his saber in midair beside X on the Highway
Modern Zero
Direct saber attacks with movement during airborne swings.
The X3 boss weapons selectable in X1's pause menu
X2 / X3 weapon pages
Sixteen imported boss weapons and their charged attacks. 		X using Triad Thunder against an enemy on the Highway in widescreen
Imported weapons in action
X3's Triad Thunder on X1's Highway.
Gameplay screenshots from the [project preview](https://1379.tech/megaman-x-recompiled-coop-zero-weapons-wip/), plus a Modern Zero capture from the current playtest. ## Features Checked boxes indicate available features. Configure optional mods in the launcher's **Mods** screen; these character and weapon mods target the USA Rev 1 build. | Available | Feature | What it adds | |:---------:|---------|--------------| | ☑ | **Password saves (SRAM)** | Remembers the last generated password and prefills it on the next launch. Enabled by default. | | ☑ | **Adaptive widescreen** | Expanded gameplay with adaptive, 16:9, 21:9, and 32:9 views. | | ☑ | **Playable Zero** | X3 Zero with his buster/saber combo and grounded character switching. Separate health for X and Zero. | | ☑ | **Modern Zero** | Direct saber attacks, double jump, air dash, and movement during airborne swings. | | ☑ | **Co-op mode** | X and Zero on screen together, with independent health, weapons, and weapon energy. | | ☑ | **X2 weapons** | All eight boss weapons and their charged attacks, adapted for X and Zero. | | ☑ | **X3 weapons** | All eight boss weapons and their charged attacks, adapted for X and Zero. | | ☑ | **Netplay** | Two-player online co-op with lobbies and rollback, plus optional fixed widescreen. | See the [co-op validation notes](docs/coop-port.md) for current limits. ## Quick start (pre-built release) 1. Download the latest [Windows ZIP or Linux AppImage](https://github.com/mstan/MegaManXSNESRecomp/releases/latest). Extract the ZIP on Windows, or make the AppImage executable on Linux. 2. Open the launcher and select your own **Mega Man X (USA) (Rev 1)** ROM (`.sfc` or `.smc`). Headered and unheadered ROMs are supported. 3. Configure your keyboard or controller in **Controls**. 4. Enable the features you want in **Mods**, then select **Play**. For Zero or co-op, select your own **Mega Man X3 USA ROM** in Mods. The X3 weapon mod shares that selection. X2 weapons need your **Mega Man X2 USA ROM**. Assets are extracted automatically on your machine. Select **Modern** under **Zero behavior** in either Zero mod for saber combat and extra aerial movement. **X3 Behavior** is the default. **Add Zero** and **X / Zero Co-op** are alternatives; enabling one disables the other. For widescreen, enable **Widescreen** in Mods and choose your view aspect. **Display Aspect** in Settings controls pixel proportions. Netplay uses the original view or fixed 16:9, 21:9, or 32:9. Setup guides: [Zero](docs/zero-0.0.1.md), [X2/X3 weapons](docs/x-weapons-port.md), [password saves](docs/password-saves.md), and [netplay](docs/netplay.md). No ROMs or extracted assets are included in the downloads. ## Controls and co-op Use the launcher's **Controls** screen to assign devices and remap buttons for each player. Xbox, PlayStation, and Switch Pro controllers are supported. For couch co-op, assign a controller or keyboard to each player. For netplay, configure your local **Player 1** controls; the lobby assigns your game seat. P2 joins automatically at a safe stage entrance in co-op. Hold P2 **Select** for 1.5 seconds to withdraw, and tap it to rejoin. A player who dies can tap **Select** to respawn beside the partner for one of the team's lives. Respawns are not available during boss or miniboss fights; the request waits until the fight is over, or until a 1-up is collected if no lives are left. Reopen the launcher during play with **Ctrl+L** or controller **Select+L3**. Configure system shortcuts in **Hotkeys**. **F7** opens the save-state browser and **F8** opens rewind; both pause gameplay while you choose. ## Reporting problems [Open an issue](https://github.com/mstan/MegaManXSNESRecomp/issues) with your build, enabled mods, and steps to reproduce the problem. For gameplay bugs, include a nearby save state and describe the inputs that trigger it. Windows diagnostics are saved beside the executable in `logs/mmx--