Repository navigation
Releases
mp2Recomp v0.3.3
mp2Recomp v0.3.3
This release restores the v0.3.1 gameplay and controller behavior and fixes
online play between Windows and Linux. The two downloads now share a netplay
build ID. Every player in the room should update to v0.3.3.
Download and extract the archive for your platform. Copy your existing
userdata/ folder into the new folder to keep your saves, settings, and cached
ROM. Open ./play on Linux or mp2recomp.exe on Windows.
The Windows build is unsigned. Smart App Control may block it on some Windows
11 PCs.
mp2Recomp v0.3.2
mp2Recomp v0.3.2
Up to four players can now use their own SDL-compatible controllers on one
computer. Start the game normally and check the controller assignments under
F1 → Input. The keyboard also works for Player 1. Controllers can be
connected during play, and unplugging one leaves the other players on their
assigned ports.
Download and extract the archive for your platform. To upgrade, copy
userdata/ from your previous installation to bring over saves, settings,
and the cached ROM. For online play, everyone in the room should update to
v0.3.2.
The Windows build is unsigned. Smart App Control may block it on some Windows
11 PCs.
mp2Recomp v0.3.1
mp2Recomp v0.3.1
The portable game now detects your unmodified Mario Party 2 USA ROM in a
games/ folder beside the executable. Create the folder, put your .z64,
.v64, or .n64 file directly inside it, and open ./play on Linux or
mp2recomp.exe on Windows. The game accepts any filename and opens the ROM
picker if it still needs a ROM.
Pressing Escape during play now opens a quit confirmation. Select Quit
to exit or Cancel to keep playing.
Download and extract the archive for your platform. To upgrade, copy your
existing userdata/ folder into the new folder to bring over saves, settings,
and the cached ROM. The game requires a Vulkan-capable graphics driver.
The Windows build is unsigned. Smart App Control may block it on some Windows
11 PCs.
mp2Recomp v0.3.0
mp2Recomp v0.3.0
Download the prebuilt game for Linux or Windows x86-64. Extract it into a
writable folder, open ./play on Linux or mp2recomp.exe on Windows, and
select your own unmodified Mario Party 2 USA ROM. You can play as soon as
the game validates your ROM.
- The portable download contains the game executable and its runtime libraries.
The compiler and SDK are used on the release build machine. - The ROM picker accepts
.z64,.v64, and.n64files and stores a local copy
for later launches. To upgrade, copyuserdata/from your previous install
into the extracted folder to bring over saves, settings, and the cached ROM. - The executable includes the recompiled game and audio code. Players supply
their own ROM. The release includes the host integration source and checksums.
The game requires a Vulkan-capable graphics driver. This is an experimental port.
The Windows build is unsigned. Smart App Control may block it on some Windows 11
PCs.
The v0.2.3 release
provides the source installer for players who prefer to compile locally.
mp2Recomp v0.2.3
mp2Recomp v0.2.3
Installer update fixing Windows dependency-cache failures caused by long file
paths. Matching installers and freshly rebuilt dependency packs are included
for Linux and Windows x86-64.
Changes
- Fix SDK extraction, checksum verification, cache publication and dependency
source copying when Windows' system long-path policy is disabled. This
addressesNo such file or directoryerrors for deeply nested filenames
undermp2recomp-cache/dependencies. - Remove unused SPIRV-Cross shader regression inputs and reference outputs from
the SDK, including the longoverlapping-bindingsfilename reported by users.
Compiler sources, build files and license notices remain included. - Apply the same source-copy filtering when preparing a local build. Downloaded
and manually selected offline SDK archives use the same fixed extraction path. - Add regression tests for long cache paths, cache reuse, source copying, UNC
path conversion and preservation of required sources and licenses. Release
packaging also tests the actual Windows SDK withLongPathsEnabled=0.
Upgrade
Download the new installer archive for your platform and extract it completely.
Keep its included SDK archive compressed beside the installer. Run the new
installer and select your existing installation directory to preserve saves
and settings. Use the matching v0.2.3 SDK; older SDK packs do not match this
release's runtime recipe. No Windows registry change is required for the fixed
SDK extraction and source-copy operations.
Each player supplies their own supported, unmodified Mario Party 2 USA ROM.
This update retains v0.2.2's game behavior and protocol-2 Steam helper. Windows
game boot, cross-platform Steam play, complete boards/minigames and long
sessions remain unverified. This is an experimental alpha.
No ROM, generated game code or game assets are distributed. The standalone
Steam helper remains MIT-licensed; the game and installer remain
GPL-3.0-or-later. Valve's runtime retains Valve's terms. Source archives,
matching dependency packs, license notices and checksums accompany installers.
See the installation guide.
mp2Recomp v0.2.2
mp2Recomp v0.2.2
Alpha update: invite Steam friends from Netplay and accept invitations during
play. Matching installers and dependency packs are included for Linux and
Windows x86-64.
Changes
- Add Invite friends to unstarted Steam rooms. The host sees only Steam
friends currently playing Spacewar (App ID 480), with paging and refresh.
Friendship and game activity are checked again when sending an invitation. - Show incoming invitations during offline and online games, with Accept
and Dismiss controls. Accepting leaves the current game or room and joins
the invited lobby; it does not carry current game progress into that room. - Initialize the Steam helper asynchronously when the graphical game launches.
Recipients do not need to open Netplay or host a room to be invitable.
Steam must be running and signed in, and game activity must be visible. - Use private Steam matchmaking lobbies for invitation delivery, and retain the
existing authenticated Steam P2P protocol for game traffic. Invite lobbies
close when the host starts or leaves. Late joining remains unsupported. - Share one standalone helper between invitations and Steam networking, add
protocol-2 compatibility checks, and allow retrying initial Steam failures.
Offline and Direct TCP games still work without Steam.
Upgrade
Download the installer archive for your platform, extract the complete archive,
and keep its included SDK archive compressed beside the installer. Run it and
select your existing installation directory to preserve saves and settings.
Each player supplies their own supported, unmodified Mario Party 2 USA ROM.
Upgrade the game and its Steam helper together. The v0.2.1 protocol-1 helper
and dependency packs are incompatible with v0.2.2; use the matching new pack.
No Steamworks SDK or development headers are needed by players.
Validation and limits
Local Linux validation covered the full native build, settings controls and
rendered invitation panels, the shared helper protocol and retry behavior,
real Steam friend filtering and private lobby creation, real UDP connection
callbacks and reliable messaging, and four Direct TCP game processes with
1,200 matching input/RNG/checkpoint frames.
Delivery and acceptance between separate Steam accounts/home networks still
need validation. A full graphical smoke test under Xvfb was blocked by Vulkan
presentation support. Windows game boot, cross-platform Steam play, complete
boards/minigames, and long sessions remain unverified. This is an experimental
alpha; disconnects and detected desynchronization stop the session.
No ROM, generated game code, or game assets are distributed. The standalone
Steam helper remains MIT-licensed; the game and installer remain
GPL-3.0-or-later. Valve's runtime retains Valve's terms. Source archives,
matching dependency packs, license notices, and checksums accompany installers.
See the installation guide,
multiplayer guide,
and helper documentation.
mp2Recomp v0.2.1
mp2Recomp v0.2.1
Alpha installer update: Steam multiplayer support is included on Windows and
Linux x86-64. Players no longer need a Steamworks SDK or a separate source build.
Changes
- Bundle a precompiled standalone Steam networking helper and Valve's platform
runtime library in each installer dependency pack. - Start the helper automatically when entering a Steam room. Offline and Direct
TCP play continue to work without Steam installed or running. - Keep SDK headers private to the build process. Installation still generates
and compiles game code locally from the user's ROM. - License the independent helper and its shared transport/protocol headers
under MIT. The game, installer, and upstream GPL dependencies retain their
existing licenses. Valve's runtime retains Valve's terms. - Validate the helper's file allowlist, hashes, and source recipe during
packaging and installation, and update setup and multiplayer documentation.
Install and play
Download mp2recomp-installer-windows-x86_64.zip or
mp2recomp-installer-linux-x86_64.tar.gz, extract the whole archive, and keep the
included SDK archive compressed beside the installer. Put your unmodified
Mario Party 2 USA ROM beside the installer for automatic detection, or select
it manually. Choose your installation directory and press Go. Upgrading in
the same directory preserves saves and settings.
For Steam multiplayer, install Steam separately, run it and sign in, then open
F1 → Netplay → Steam. Each player needs their own Steam account and computer.
This alpha uses the Spacewar test App ID 480. Steam may show the game as Spacewar.
Share the connection code privately; Steam rooms need no TCP port forwarding.
Keep the installed helper and runtime files together when moving the game.
Alpha validation and limits
Checks focus on compilation, packaging, helper protocol startup, and installing
the bundled helper without SDK headers. Local Linux checks initialized the real
Steam client and created a listener through the separate helper. This release
does not claim cross-account/home-network Steam sessions, Windows game boot,
Linux/Windows cross-play, complete boards/minigames, or long-session validation.
No ROM, game assets, or generated game code are distributed. Source, SDK packs,
license notices, and SHA-256 checksums accompany the installers. See the
installation guide,
multiplayer guide,
and helper documentation.
mp2Recomp v0.2
mp2Recomp v0.2
Windows and Linux x86-64 installers with ROM autodetection, expanded settings,
and experimental multiplayer and debugging improvements.
Changes
- Reuse verified precompiled open-source runtime libraries from the bundled SDK
to reduce local build work. Game code is still generated and compiled locally
from your own ROM. - Detect supported ROMs beside the installer executable or in the current
directory, including.z64,.v64, and.n64byte orders. Manual ROM
selection remains available. - Organize F1 settings into Input, Audio, Graphics, and Netplay tabs, with
graphics controls and public IPv4 lookup for Direct TCP hosting. - Improve Linux Wayland and X11 support, including libdecor plugins and
keyboard locale and Compose data. - Add persistent diagnostic logs, F8 recording, replay checkpoints, and a fix
for Pirate Land borders. - Add experimental Steamworks rooms using Spacewar App ID 480 for source builds
supplied with the Steamworks SDK. Packaged installers use Direct TCP netplay. - Expand installation, multiplayer, debugging, and source-build guides.
Installation and upgrade
Download mp2recomp-installer-linux-x86_64.tar.gz or
mp2recomp-installer-windows-x86_64.zip. Extract the whole archive, keeping the
included SDK archive compressed beside the installer executable. Put your
unmodified Mario Party 2 USA ROM beside the executable for automatic detection,
or select it manually. Choose an installation directory and press Go.
To upgrade, select your existing installation directory; saves and settings are
preserved. The installer includes the build tools and dependencies needed for
offline installation. A Vulkan-capable graphics driver is required.
No ROM, game assets, or generated game code are distributed. Matching integration
source, SDK dependency packs, and SHA-256 checksums accompany the installers.
Validation and limits
Release builds run installer validation and packaged CLI/GUI startup checks on
Windows and Linux. SDK builds also verify the open-source runtime libraries;
Linux checks exercise runtime data and Wayland window creation without a ROM.
Fresh consumer builds on both platforms check that the packaged runtime archives
link and pass self-tests without recompiling their dependencies.
This remains an early experimental port. Linux boot through the title screen has
been tested; full boards, minigames, long sessions, Windows game boot, and
Linux/Windows cross-play still need validation. Some title prompt glyphs appear
as blocks. Steam rooms require a separate source build and further cross-account
and cross-network testing.
See the README,
installation guide,
and multiplayer guide
for setup and limitations. Runtime dependencies retain their own licenses.
mp2Recomp v0.1.1
mp2Recomp v0.1.1
Installer and Linux runtime fixes for v0.1.
Fixes
- Fix unreadable white-on-white text in the Windows installer. Text and
backgrounds now use a complete palette, with contrast checks for light and
dark system palettes. - Include the font configuration and XKB keyboard data needed by the Linux
runtime. The executable locates these files in its installation directory,
including after moving that directory, without depending on build-machine
paths or manual environment variables. - Remove the installer slogan.
- Add a runtime-data self-test for GTK, Fontconfig and XKB, and regression tests
for missing data, relocation and installer text contrast.
Installation and upgrade
Download mp2recomp-installer-linux-x86_64.tar.gz or
mp2recomp-installer-windows-x86_64.zip. Extract the archive and keep the
included SDK archive beside the installer executable, still compressed.
Run the installer, select your Mario Party 2 USA ROM and installation directory,
and press Go. To upgrade, select the existing game installation directory;
saves and settings are preserved. The earlier Linux environment-variable
workaround is no longer required after reinstalling with this version.
No ROM, game assets or generated game code are included. The matching
integration source, SDK dependency packs and SHA-256 checksums are attached.
Validation and limits
The corrected Linux installation was tested through the title screen with
working audio and settings. Windows and Linux installer tests, palette contrast
checks and frozen GUI/CLI startup checks passed in GitHub Actions. Runtime-data
checks exercise missing and relocated configuration data without a ROM.
This remains a boot/title proof of concept with experimental netplay. Full-game
play, long sessions and actual Windows game boot still need further validation.
See the README
and netplay documentation
for setup and known limitations. Runtime dependencies retain their own licenses.
mp2Recomp v0.1
mp2Recomp v0.1
Initial public proof-of-concept release, including experimental room netplay.
Downloads and installation
- Linux x86-64: download
mp2recomp-installer-linux-x86_64.tar.gz. - Windows x86-64: download
mp2recomp-installer-windows-x86_64.zip.
Extract the archive and keep the entire directory intact. Launch
mp2recomp-installer (Linux) or mp2recomp-installer.exe (Windows), drop your
own Mario Party 2 USA ROM into the window, choose an installation directory,
and press Go. The matching SDK is included for offline installation.
No Python, compiler or development packages need to be installed separately.
A Vulkan-capable graphics driver is required.
The supported 32 MiB US ROM has SHA-1
166eda1c05670d337e2c3f15a5db528ae1e5d6e3; .z64, .v64 and .n64 byte
orders are accepted. No ROM, assets or generated game code are distributed.
SHA-256 sidecars are provided for installer archives.
Included
- Native static CPU recompilation with N64ModernRuntime and RT64 graphics.
- Boot through the opening sequence to the title screen.
- Keyboard/controller bindings, hotplug support and persistent audio settings (F1).
- Experimental encrypted room netplay for two to four players. Start with
--netplay; the host forwards TCP port 7777 and shares the generated connection
code. Each participant needs their own ROM and the same release. - Separate netplay session saves; offline saves are preserved.
- Self-contained Linux and Windows installers and SDKs built by GitHub Actions.
- Authored source licensed under GPL-3.0-or-later.
See netplay setup and the README for controls,
source builds and detailed validation.
Known limitations
This is an early proof of concept. Complete boards/minigames, long sessions,
separate home networks and Linux/Windows cross-play need further validation.
Netplay uses direct host connections with no relay or matchmaking; the host
must be reachable. Rollback, late joins and reconnection are not implemented.
Connection codes grant access to a room and must be shared privately.
Some title prompt glyphs appear as blocks. Actual Windows game boot remains
unverified; Windows compilation, installer and transport checks run in CI.
GitHub's source downloads and the integration source archive do not contain a
ROM or generated game code. Runtime dependencies retain their own licenses;
see third-party notices.