MiniBandit / MKW-3DS

# Mario Kart Wii 3DS
A native Nintendo 3DS port of Mario Kart Wii, continued by **MiniBandit** from
the original port by **dudewhat**.
This repository contains **no Nintendo files**. It builds an installable CIA
on your own computer from your own Mario Kart Wii disc.
It isn't an emulator. The game runs natively on the 3DS: kart physics come from
Kinoko, a recreation of Mario Kart Wii's
physics, and rendering, audio and menus are written for the 3DS hardware. The
builder converts the disc's courses, characters, vehicles, menus, movies and
sound into 3DS formats.
## What's new in this continuation
On top of dudewhat's original release (Solo VS, 24 drivers, the 6 starting
vehicles each):
- **Grand Prix** in 50cc (karts), 100cc (bikes) and 150cc: the cup's four courses in order, with points and standings
- **Time Trials**: solo, a Triple Mushroom, best time per course saved to the SD card
- **All 12 vehicles** for every driver, including the unlockables
- **Speedometer** on the race HUD (SELECT toggles it)
- **Tricks on R** off ramps (Mario Kart 7 style), plus X/Y for tricks and wheelies
- **Smoke and dust**: start-boost smoke, burnout, drift smoke, off-road dust, landing puffs
- **Balloon Battle** on all ten arenas, with CPU opponents, balloon scoring and a three-minute match
- **Two-screen menus** (v0.6.0): the Wii menu buttons and art on the lower screen with touch, the highlighted choice shown large on top, and a course tour on the lower screen during the pre-race fly-over
- **Save data** with four licenses, unlocks and best times (v0.6.0, Epic0522)
- **Race overhaul** (v0.6.0, Epic0522): course materials, driver and vehicle animation, effects, course objects, CPU drivers, items, sound and Rosalina's Luma
- Model and HUD fixes
- HOME Menu name and icon, and the standard Nintendo 3DS start-up logo
Still in progress: Coin Runners and Team VS. Not yet: Mirror, online play.
## What you need
- **Mario Kart Wii (USA)**, game ID `RMCE01`, dumped as `.iso` or `.wbfs`.
 Convert RVZ or NKit dumps to ISO in Dolphin first.
- About **15 GB** of free space and an internet connection
- devkitPro with the 3DS tools (`3ds-dev`)
- Python 3.11–3.14 and Node.js LTS (Python 3.15 is not supported yet)
- Git
- macOS: Xcode command line tools (`xcode-select --install`)
## Building
**macOS:** double-click `Build MKW CIA.command`, drag your disc image into the
window and press Return.
**Windows:** double-click `Build MKW CIA.bat`, drag your disc image into the
window and press Enter. *(New: please report how it goes.)*
**v0.6.0 needs a new build.** Its converted game files changed, so a game built
with v0.5.x can't be updated to v0.6.0 with an update CIA: run the v0.6.0
builder **in a new, empty folder** (not your old builder folder), install the
new CIA and copy the new `build/release/sd-card/3ds` folder to your SD card.
The first build takes about 30–60 minutes. Your CIA is saved to
`build/release/mkw-3ds.cia`. If a build stops partway, run it again: finished
steps are