v0.4.2-beta — multiplayer controller routing fix (current)

PokemonStadiumRecomp — SS Anne — v0.4.2-beta

A native PC build of Pokémon Stadium (US v1.0), produced by static
recompilation. You must supply your own legal ROM — none is included.

This is the current, definitive beta. It supersedes v0.4.1-beta.

What's new since v0.4.1-beta

• Fixed multiplayer controller routing. Previously one controller could
  end up driving several players (e.g. in Kid's Club, Player 1's pad
  controlled Players 1–3). Each player now reads only its own assigned
  device, and one physical controller maps to exactly one player.
• Controller and enable choices now persist. Assigning a controller or
  toggling a player's Enabled state is saved to launcher.cfg immediately,
  so it survives a relaunch (previously only ROM/save changes persisted).
• Self-healing config. If a config assigns the same device to multiple
  slots, it's de-duplicated on load (first slot keeps it, the rest fall back
  to an unused device or None).

Carried over from v0.4.x

• Default supersampling (2×2 SSAA) + 4× MSAA — the models look right out of
  the box, no settings needed.
• In-app SS Anne launcher (works with no config), with Game Boy cart/save
  pairing validation and game-colored cart dots.
• GB Tower, Transfer Pak, and a self-contained build that needs no Visual
  C++ redistributable.

Install / run

1. Unzip anywhere.
2. Run PokemonStadiumRecomp.exe.
3. On first launch, point it at your own Pokémon Stadium (US v1.0) ROM. The
   path is remembered.

What's NOT included (you provide these)

• The Pokémon Stadium N64 ROM, and any Game Boy game ROMs.

Source code & license (GPLv3)

PokemonStadiumRecomp is GPLv3. The Corresponding Source for this binary
is this repository at the v0.4.2-beta tag, built from:

• PokemonStadiumRecomp — 6455da892794477b99cbac08ec17c6bbc3c0cefb (tag v0.4.2-beta)
• N64ModernRuntime — aaff9349725edfcce4d27b018253f69e0ba9b743
• N64Recomp — 62a475436d9b66f4448ab52b415295255628789a
• rt64 — f8dfe294cd4cfe84999ac3df68034c6d604d63da

Every component's license text is included in the licenses/ folder.
Build instructions: build_ssanne.bat (see README.md).

v0.3.1-alpha — ROM file picker on first launch

v0.3.0-alpha + file picker. Same recompiled core; first-launch
UX changed only.

What's new

• Runner now pops a native Win32 file picker if no ROM is configured
  (no rom.cfg next to the exe, no baserom.z64 discoverable, no
  CLI arg).
• Successful picks are saved to rom.cfg so subsequent launches
  go straight into the game.
• ROM validation (MD5 match against Pokémon Stadium US v1.0) still
  enforced. On mismatch you get a clear MessageBox with the expected
  hash and the picker reopens.
• argv[1] still honored for scripted runs.

This replaces the v0.3.0-alpha requirement to manually rename and
drop baserom.z64 next to the exe before the first launch.

Setup

1. Download PokemonStadiumRecomp-v0.3.1-alpha-win64.zip and extract.
2. Double-click PokemonStadiumRecomp.exe.
3. Pick your own legal Pokémon Stadium (US v1.0) ROM when prompted.

Everything else (game scope, audio, bugs, requirements)

Same as v0.3.0-alpha — see that release's notes or
ISSUES.md.

Engine pins

• N64Recomp: ss-anne/N64Recomp@fad8a9c
• RT64: ss-anne/rt64@1bc1b79
• N64ModernRuntime: ss-anne/N64ModernRuntime@90e12f0

v0.3.0-alpha — first end-to-end playable build

First end-to-end-playable build of Pokémon Stadium (US v1.0) under
the SS Anne ecosystem. Quick Battle, Free Battle, all four Stadium
cups, and Gym Leader Castle have been validated through complete
rounds. Audio plays at 50% by default.

This release closes the Register Pokémon (Gym Leader Castle)
softlock by adding a host-rdram-offset mask in N64Recomp's
MEM_W/MEM_H/MEM_B macros (engine pin: fad8a9c). Bad pointers
from upstream UAFs now become continuable garbage reads instead of
host SEGVs — matching real N64 silent-wrap behavior.

Known visible glitches (see ISSUES.md)

• Subtle clicking between audio chunks during music playback
• Corrupted hand-pointer sprite on a few menu screens
• Line patterns through some HUD elements

Not yet supported

• Transfer Pak (Game Pak Check shows empty slots)

Setup

1. Download PokemonStadiumRecomp-v0.3.0-alpha-win64.zip and extract.
2. Drop your own legal Pokémon Stadium (US v1.0) ROM into the folder, renamed to baserom.z64.
   • Required MD5: ed1378bc12115f71209a77844965ba50
   • Rev A (v1.1) is NOT compatible.
3. Double-click PokemonStadiumRecomp.exe.

Requirements

• Windows 10 / 11 (64-bit)
• A GPU supporting D3D12 or Vulkan
• VC++ runtime DLLs are bundled — no separate redist install needed.

Engine pins

• N64Recomp: ss-anne/N64Recomp@fad8a9c
• RT64: ss-anne/rt64@1bc1b79
• N64ModernRuntime: ss-anne/N64ModernRuntime@90e12f0

v0.1.0-alpha — first public release (Windows x64)

First public alpha of PokemonStadiumRecomp — static recompilation of Pokémon Stadium (US v1.0) to native PC, built on N64Recomp.

Status

Boots through the boot logo, intro sequence, title screen, area select, and into in-game scenes. Audio synthesis runs. Several crash families remain under active investigation. Expect intermittent crashes; this is an alpha.

How to use

1. Download PokemonStadiumRecomp-windows-x64.zip and extract it.
2. Supply your own baserom.z64 — Pokémon Stadium US v1.0, MD5 ed1378bc12115f71209a77844965ba50. Place it next to PokemonStadiumRecomp.exe. Rev A (v1.1) is not compatible.
3. Run PokemonStadiumRecomp.exe. The runner verifies the ROM MD5 at startup and refuses to launch on mismatch.

No copyrighted ROM bytes are bundled in this release. The binary will not run without a legally-dumped ROM you supply yourself.

Contents

• PokemonStadiumRecomp.exe — the runner
• SDL2.dll, dxil.dll, dxcompiler.dll — required runtime DLLs

Known caveats

• Reproducibility: this binary is built from working branches of N64ModernRuntime, N64Recomp, and RT64 that are not yet pushed publicly. Source in this repo lags the binary; the build is not currently reproducible from the snapshot at this tag.
• GB Tower / Transfer Pak (Pokemon R/B/Y emulation) is out of scope for the first playable build.
• Audio: master volume defaults to muted. Set PSR_VOLUME=0.33 (or any 0.0–1.0 float) before launching to enable audio.

Credits

• pret/pokestadium — disassembly
• N64Recomp by Mr-Wiseguy and contributors — recompiler
• N64ModernRuntime / RT64 — runtime + renderer