Magical Quest Starring Mickey Mouse, The Recomp

A native recompilation of Magical Quest Starring Mickey Mouse, The (USA), built on snesrecomp.

Mickey Mouse embarks on a magical adventure through colorful worlds to rescue Minnie from the evil Emperor Pete.

You must legally own a copy of the game. No ROM data is distributed with this project, in the repository or in any release. The recompiled C is generated locally from your own copy and is never committed.

Status

Updated on 2026-10-17 — the game has been built and launched locally. The desktop display has been restored to the original 4:3 aspect ratio. Further testing and cleanup are still in progress. See the build and run instructions below.

ROM identity

File	Magical Quest Starring Mickey Mouse, The (USA) (Rev 1).sfc
Publisher	Capcom
Developer	Capcom
Year	1992
Mapping	lorom
Region	USA (North America)
Coprocessor	none
CRC32	bb24ece5
SHA-256	b6778fd2ba0dbe967c1a2c015e1ba89ec8c3b151757cdc7019baf17792b5aff9

tools/regen.sh refuses to run against anything else, so a mismatched revision fails immediately instead of producing subtly wrong output.

Build

git submodule update --init --recursive
bash tools/regen.sh --rom /path/to/Magical Quest Starring Mickey Mouse, The (USA) (Rev 1).sfc
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j

The ROM does not have to live in the repository — keeping it on your own drive is the better habit, and SNESRECOMP_ROM sets the path once for a shell. Without either, tools/regen.sh finds Magical Quest Starring Mickey Mouse, The (USA) (Rev 1).sfc at the repo root, then the path the setup wizard recorded in rom.cfg; .gitignore blocks both from ever being committed.

tools/regen.sh verifies the ROM, generates src/gen/*.c, and re-syncs recomp/funcs.h. Re-run it whenever you change anything under recomp/.

Run

./build/MagicalQuestStarringMickeyMouseTheSNESRecomp                     # launcher picks the ROM
./build/MagicalQuestStarringMickeyMouseTheSNESRecomp /path/to/Magical Quest Starring Mickey Mouse, The (USA) (Rev 1).sfc # or name it and skip the launcher

With no ROM on the command line the build opens the recomp-ui launcher: a ROM picker with a verification badge, plus display / audio / input settings. Your choice is cached in rom.cfg beside the executable, so the next launch opens on it and "Skip launcher on boot" makes it immediate. If the launcher is not built in (--no-recomp-ui), the host falls back to a native file picker.

Either way the ROM is checked against the digests above before anything boots — a dump that could not have produced this build is refused at the door rather than mis-executing ten frames in.

Layout

Path	What lives there
recomp/	Analysis input: bank*.cfg, symbols.toml, generated funcs.h
rom_identity.txt	ROM digests — read by the build, tools/regen.sh and CI
src/	Host code you own: main.c, game_rtl.c
src/gen/	Generated C. Never committed — regenerate locally
snesrecomp/	Framework submodule (owns lib/recomp-net, lib/retcomm-rbengine)
tools/	regen.sh — the ROM → C pipeline
scripts/	package_release.sh — player-facing zip
framework_pins.txt	Exact framework commits this project was scaffolded against

Current progress

• The game has been built and launched locally.
• The desktop display is configured for the original 4:3 aspect ratio.
• Startup vectors I_RESET and I_NMI are enabled in the recompilation configuration.
• Further gameplay testing and cleanup are still in progress.

Review local changes before running tools/regen.sh.

Multiplayer

Two players, one controller per port.

License

This project's own source is under the license in LICENSE. The framework carries its own terms — see snesrecomp/LICENSE and snesrecomp/THIRD_PARTY_ATTRIBUTION.md. Neither covers the game data, which is not distributed here.