Hazoto's Ultimate Alliance 3
Hazoto's Ultimate Alliance 3 is a PC port of Marvel Ultimate Alliance 3: The Black Order with 60 fps, local wireless co-op over the internet and a settings menu.
- Type: PC port
- Game: Marvel Ultimate Alliance 3: The Black Order
- Runs on Windows
- By RolandHazoto
- Latest release v420.69.1, 2026-11-15
README
HUA3: Hazoto's Ultimate Alliance 3

A PC port of Marvel Ultimate Alliance 3: The Black Order (Nintendo Switch) by static recompilation: the game's ARM64 code is turned into C and compiled into a native x86-64 Windows executable; this is not an emulator. HUA3 continues SilvioDiaz's MUA3 recomp with 60 fps, Local Wireless co-op over the internet, a settings menu and many fixes.
Warning
This project was made by AI. Nearly all of the code, the porting work and this documentation were written by an AI coding agent (Claude Code, by Anthropic) at the repository owner's request; the owner tested the builds on their own PC.
It continues SilvioDiaz's MUA3 recomp (release 0.2.0), which first brought the base game to PC and is what made this project possible. That port is in turn based on totk-pc-recomp by Valiantsin Dzerakh (the Tears of the Kingdom recomp): the lifter, the runtime and almost everything else come from there. The original credits and licenses still apply (see Credits).
The game is playable. See the status below for what has been tested.
Important
No game files are included. You need your own copy of the game, dumped from your own console. Instructions for obtaining those files will not be provided.
The game is built from your files on your machine, so the result contains the game. It is for your own use. Do not share the build folder.
Status
| Area | State |
|---|---|
| Recompilation (104,614 functions, 0 unsupported instructions) | ✅ |
| Boot, saves, movies, menus | ✅ |
| Story stages and the Gauntlet | ✅ played up to the final stage on the owner's PC, 60 fps (45 or more in the heaviest fights) |
| Local co-op on one PC (several controllers) | supported, lightly tested |
| Local Wireless co-op over the internet (host and join) | ✅ tested with two copies on one PC; a test between two PCs is pending |
| The game's Online mode | ❌ needs Nintendo's servers; Local Wireless replaces it (below) |
| DLC (Expansion Pass) | needs your own DLC files |
| Linux, Steam Deck | ❌ not built yet |
Features
Press F1 in the game for the settings menu (a controller opens it too). Everything below lives there.
- Frame rate: 60 fps instead of the original 30 (Game tab).
- Picture: output resolution, DLAA on NVIDIA RTX cards, SMAA (four presets) and FXAA for the others, HDR10 output with a brightness slider, a colour profile for SDR screens (Screen tab).
- Enhanced Heroic camera: Standard, Close and High presets for the Heroic camera mode, built in (Game tab; takes a restart).
- Button letters: Button layout Xbox shows the letters of an Xbox controller on every button icon of the game (A and B, X and Y swapped, the hold icons and the ABXY diamond too), redrawn from the game's own icons. The buttons stay where a Switch has them, so menus and combat play the same (Controls tab; takes a restart).
- Controls: remapping for controllers and the keyboard, up to four players with a device each, vibration.
- Mods and cheats w/ Online support: drop mods into
mods/next tomua3.exe(the folders emulators use:romfs,exefs,cheats), then switch them and set their order in the Mods tab (docs/mods.md). - Custom Menus: Vibe-crafted menus, complete with themes, for the Controllers, Settings, and Network
- Local Multiplayer up to 4 players: Custom bindings for every player each with their own device, or map multiple players to 1 device for shenanigans.
- Local Wireless over the internet: the Network tab (below).
Playing together: Local Wireless over the internet
The game's Local Wireless co-op normally links consoles in the same room. Here it runs over a network: one player hosts, up to three join. The Player guide on the Network tab explains each step; in short:
- Host: F1 > Network > Network mode Host. Allow
mua3.exethrough the Windows firewall when asked. Give the others your address: on the same home network the PC's local address (ipconfig), over the internet your public address ("Find my public address") with UDP port 39410 forwarded on your router, or the address of a virtual network app such as Tailscale or ZeroTier (no router setup needed). - Join: Network mode Join, then enter the host's address, port and password (if any). Save as favorite keeps it for next time.
- In the game, everyone goes to Co-op > Local. The host chooses Create, the others Search and join.
Every player needs the same enabled mods, cheats and 60 FPS setting; the host refuses a player whose setup differs,
and that player's game writes the differences to net-mods.txt next to mua3.exe. The camera preset, the button
letters and the picture and sound settings are each player's own. The settings and saved connections live in
net.ini next to mua3.exe. Choosing the game's Online mode opens the Network tab with this explanation.
What was adapted from TotK Recomp
- An
mua3game profile (title ids, versions, expected hashes) in tools/game_profile.py and tools/data/mua3;build_game.py --game mua3producesmua3.exe,mua3.iniandlogs\mua3.log. - Boot with MUA3's older SDK (
nn::init::Startwith 2 callbacks); TotK-specific patches turned off. - Offline answers for network services (BCAT, friends, shop), account, save data, the older hid API,
audout; local wireless (nn::ldn) and UDP sockets over a relay between PCs (runtime/ov_net.c). - NVN to Vulkan: per-stage programs, indirect draws, alpha test, compute shared memory size, textures bound through image handles, and many newly implemented NVN calls.
- Geometry shaders in the replay (translated by the shader service and linked between the vertex and fragment stages),
with NVIDIA's native passthrough geometry shaders and viewport mask where the GPU has them (
TOTK_NATIVE_GS), and the stand-in for MUA3's culling geometry shader (TOTK_GS_LIST_ALL). - H.264 + AAC movie decoding (
runtime/movie_codec_win.c), with SPS/PPS read from the MP4'savcC. - Shader translator (from Ryujinx) with NaN/Inf fixes and Maxwell's FMZ and NaN-aware min/max/clamp behaviour.
- A function profiler (
TOTK_FNPROF) and a write tracer to investigate the dark scene. - Symbol binding as on the console: a symbol with default visibility binds to the first module in load order that
defines it, so the game's
operator new/deletereplace the SDK's everywhere. - A heap checker (
TOTK_HEAP_CHECK) that walks MUA3's heap at every frame and logs the first broken block.
Fixes were also brought over from other open recomps: Cadence of Hyrule, Astral Chain, Xenoblade Chronicles X, Fire Emblem: Three Houses and Pokopia; fefw-recomp, DKB Recomp and hwaoi-recomp were read for how they replay geometry shaders (GPL code was only read for behaviour and rewritten, never copied).
Installing
Windows only, game version 4.0.1 only (base game 1.0.0 + the 4.0.1 update). The release carries no game code: its
setup builds mua3.exe from your own files on your PC (about 40 GB free during setup).
- With RecompLauncher: install the recomp and pick the folder that holds your base
game, the 4.0.1 update (NSP, XCI, NSZ or XCZ) and your console's
prod.keys. The launcher builds the game and starts it, and shows its settings on the game's page (recomplauncher.json). - By hand: start
MUA3-Setup-<version>.exe(one file: it unpacks itself the first time, then opens the setup), or unpackMUA3-Setup-<version>-windows-x64.zipand startMUA3-Setup.exe. Pick the same three files and an install folder (docs/installer.md).
Building from source
Windows only, game version 4.0.1 only.
Requirements: MSYS2 UCRT64 (clang/lld, ninja, SDL3, opus, libvpx, zstd, Vulkan headers), Python 3.12 and 3.14, the .NET SDK and Visual Studio Build Tools (for the shader translator), a GPU with Vulkan 1.3 and about 60 GB free.
You need the base game and the update (NSP or NSZ) and your console's prod.keys. From the repository folder:
.venv-py314\Scripts\python -I tools\mua3_extract.py --base base.nsp --update update.nsp --keys prod.keys
.venv\Scripts\python recomp\gen.py --exefs build\extracted\upd\exefs --out generated\upd --modules main,subsdk0,subsdk1,sdk
.venv\Scripts\python tools\build_game.py --game mua3 --version upd --gen generated\upd --out build\upd --exefs build\extracted\upd\exefs --romfs build\extracted\upd\romfs --expected build\extracted\expected-upd.json
build\upd\mua3.exe
The general process is the original project's (docs/building.md). Everything the build writes
stays under build\ and generated\, which git ignores. Run tools/check_content.py --staged before every commit so
that no game content enters the repository.
Credits
- SilvioDiaz's mua3-pc-recomp: the MUA3 recomp this project continues from (its release 0.2.0), the first port of the base game to PC
- totk-pc-recomp by Valiantsin Dzerakh: the base both build on
- The projects totk-pc-recomp builds on, listed with their licenses in THIRD_PARTY_NOTICES.md: LAS Recomp, MacNativeGames, Ryujinx, deko3d, hactool, SDL 3, Dear ImGui, AMD FSR 1, Vulkan Memory Allocator, libopus, libvpx, Zstandard, bcdec, Switchbrew and the Switch homebrew community
- Fixes ported from other recomps: cadence-pc-recomp, astral-chain-pc-recomp, xcx-recomp, fe3h-recomp and switch2-recomp (Pokopia)
- SMAA by Jorge Jimenez, Jose I. Echevarria, Belen Masia, Fernando Navarro and Diego Gutierrez (MIT)
- The Enhanced Heroic camera presets use the values of the MUA3 community's third-person camera mods; the camera file was found by chars_ in the MUA3 modding Discord
- Read for reference (GPL, behaviour only): fefw-recomp, dkb-pc-recomp and hwaoi-recomp
License
The project's code is under the original project's MIT License; third-party code keeps its own license (THIRD_PARTY_NOTICES.md). The license grants nothing for the game.
An independent, non-commercial fan project, not affiliated with or endorsed by Nintendo, Marvel, Disney or Koei Tecmo / Team Ninja. Marvel Ultimate Alliance 3 and its characters are trademarks of Marvel; Nintendo Switch is a trademark of Nintendo.