Pokémon Box Wii (PBW)

A Wii homebrew Pokémon Box-style save manager for Generation 1–3 games, built on top of the Epilogue GB Operator USB cartridge reader and a vendored mGBA core.

Read a real Game Boy / Game Boy Color / Game Boy Advance cartridge over USB, store Pokémon in PBW's own box storage, move them freely between a connected cartridge and box storage, convert Pokémon between Gen 1/2 and Gen 3 with a PCCS-based Time Capsule Transfer, browse a full Pokédex with encounter-location data, and launch a cartridge directly into an in-app "Adventure" (mGBA) session — plus background music/SFX, an in-app tutorial character (Lanette), and a growing set of Pokédex-completion-gated rewards.

This is a fan-made, non-commercial project. See CREDITS.md for everyone whose games, code, art, and data this project is built on.

Requirements

• A Wii with the Homebrew Channel
• An Epilogue GB Operator USB cart reader, connected via a USB keyboard adapter or USB port (for cart reading — not required just to browse existing box storage)
• An SD card

Building

Toolchain: DevKitPro (devkitPPC), with the DEVKITPRO environment variable set. Also requires two devkitPro portlibs not bundled with base libogc:

(dkp-)pacman -S ppc-libogg ppc-libvorbisidec

Then:

cmake -S . -B build -G "Unix Makefiles"
cmake --build build -j4

This produces build/pokemon_box_wii.dol.

Installing on an SD card

1. Copy the zip from the release and extract to the pokemon-box-wii folder in your apps folder.

Controls

Every screen supports 4 control schemes, selectable from the Extras menu (also stored as controller_scheme in settings.ini):

controller_scheme	Scheme	Physical controller
0	GameCube	GameCube controller
1	Classic	Wii Classic Controller
2	Wiimote (H)	Wii Remote held horizontally (NES-style)
3	Wiimote (V)	Wii Remote held vertically, IR pointer-aimed

Wiimote (V) is the one scheme with a genuine free-aim pointer — the Wii Remote's IR pointer directly selects box slots/menu items, alongside normal D-pad navigation.

Documentation

• docs/procedures/standard-procedures.md — engineering conventions, safety-critical do-not list, documentation rules.
• docs/systems/ — cross-cutting subsystem references (graphics, controls, audio, memory management, save-data I/O).
• docs/features/ — current status of each major feature.
• docs/history/ — dated bugfix/test logs.
• docs/sources.md — every external source consulted, and exactly what it was used for.

Credits

See CREDITS.md.

License

This project's own code, art, and data are released into the public domain under the Unlicense — use, modify, and redistribute it for any purpose, no attribution required. vendor/mgba/ is a vendored third-party project under its own separate license (Mozilla Public License 2.0 — see vendor/mgba/LICENSE), and third-party sprite/data assets listed in CREDITS.md remain the property of their original creators.