Play Mario Kart DS natively on Windows and Linux, and mod it.
MKDSrust turns your own dumped Mario Kart DS (USA, revision 0) ROM into a native Windows or Linux game. It is not an emulator: the launcher translates the game's code into Rust on your PC and compiles it, with native graphics, audio and input. Races play exactly like the DS (frame for frame in accuracy mode), and mods are compiled straight into your game.
- Download, pick your ROM, play. The launcher sets everything up itself: no Visual Studio, no Rust install.
- Mods built in. Tick a mod in the launcher and rebuild. First official mod: Widescreen: 16:10, 16:9 or 21:9, a see-through track map overlay, and the Combined layout that rearranges the whole game (menus, race, results) into one widescreen picture, no second screen needed.
- Readable source. Every build includes the generated Rust for your copy of the game, with real function and field names.
| Part | Status |
|---|---|
| Recompilation: the whole game runs natively | ✅ Complete. All 12,736 functions translated; exact mode matches the DS frame for frame. |
| Decompilation: functions named and typed | ✅ Complete in scope (99.5% of 9,496 functions; ARM7 and online code excluded). |
| Launcher and mods | ✅ Released (latest). Widescreen 1.3 adds the Combined layout: the whole game in one widescreen picture. |
| Readable Rust: plain Rust without the simulated DS | 🟡 In progress. 39% of functions have real parameters and 20% no longer use the simulated CPU. Now testing a route that runs converted code directly on the game's memory. |
| MKDSrust Toolbox (asset editor) | ⏸ Paused. |
Where this is going: the roadmap, MKDSrust as the complete modding tool for Mario Kart DS.
Windows and Linux both have a release launcher; a Linux build plays the same race frame for frame as the Windows build. macOS is untested.
- Download
MKDSrust-windows-x64.zip(Windows) orMKDSrust-linux-x64.tar.gz(Linux) from the latest release and extract it anywhere. On Linux, first install the build packages, e.g.sudo apt install build-essential pkg-config libasound2-dev libudev-dev(the launcher tells you the command for your distro if one is missing). - Run
MKDSrust.exe(Linux:./MKDSrust) and follow Setup: choose your ROM, let it install its private toolchain, and build. The first build takes a while; later builds are cached. - Press Play. Open Mods to add Widescreen, then rebuild.
| Requirement | Details |
|---|---|
| Game | Your clean, self-dumped USA cartridge ROM, code AMCE, revision 0 |
| Windows launcher | Windows 10/11 64-bit; the release launcher prepares a private portable GNU Rust toolchain |
| Windows development | Rust 1.96.0; MSVC builds of the launcher require Visual Studio C++ Build Tools |
| Linux launcher | x86_64, glibc 2.31 or newer (Ubuntu 20.04+, Debian 11+, Fedora 32+); C compiler, pkg-config, ALSA and udev development packages. The launcher installs its own Rust. |
| Linux development | Stable Rust, C/C++ toolchain, pkg-config, ALSA, udev, X11/Wayland and xkbcommon development libraries |
| macOS | Stable native Rust toolchain and Apple command line tools; untested |
| Resources | About 2 GB free disk space; 8 GB RAM recommended; internet for initial dependencies |
For development builds, install Rust from rustup.rs, then reopen your terminal. Build on the OS where you intend to play; generated executables are platform specific.
Most players should use the release download. To build the launcher yourself:
-
Open a terminal in this checkout and build the launcher:
cargo build --release --locked --manifest-path launcher/Cargo.toml .\launcher\target\release\MKDSrust.exe
-
Follow Setup: welcome, ROM verification, portable toolchain installation, local build, then Home.
-
Keep the launcher open during building and playing. Choose Play when ready.
-
Use Settings and Controls, then Save; changes apply on the next launch.
The launcher checks ROM compatibility and verifies the bundle before play. Rebuilding into a nonempty destination stages a sibling folder and switches only after success.
Release downloads need no source checkout, Rust installation, or Visual Studio. The launcher embeds
an allowlisted compressed archive of 1_build_tool, 2_native_game, the address dictionary and Mods/;
it extracts a versioned copy in its data folder. No ROM, extracted assets, generated workspace,
or compiled game is embedded. Rust 1.96.0 GNU components are downloaded from the official Rust
distribution server and checked against its SHA-256 files. Toolchain downloads support retry
and resume. Initial crate downloads still require internet access. A future release may provide
a separately downloadable archive of vendored lockfile dependencies for offline builds.
Home is the whole flow: choose your ROM, Build, Play, and View source (the readable Rust generated
from your ROM, a self-contained folder you can rebuild anywhere with cargo build --release). Each built game folder
is portable: saves and settings live in its data/ folder. Mods lists the official and community mods from
Mods/ (refreshed from GitHub); tick them and rebuild to compile them into your game
(mkds_builder --mod widescreen). Advanced offers system Rust, accuracy mode, rebuilding, logs, folders and the
older content packages (.zip mods: load order, Create mod, Test in game, Pack; also
mkds_builder mod create|pack|install). Settings and controls remain shared with the builder and game.
MKDSrust.exe --smoke-test saves all pages and setup stages to release_shots/ and exits.
Keep the checkout for future builds. Logs appear in the launcher and are saved beside
%APPDATA%\MKDS Native Builder\launcher.json as launcher-build.log.
From the repository root on Windows:
build.bat "C:\path\to\game.nds"
play.batDouble-clicking build.bat prompts for the ROM. mkds.bat provides a menu for play,
building, controls and display settings.
On Linux or macOS:
sh build.sh "/path/to/game.nds"
sh play.shThe default output is builds/mkds/: the verified play launcher, game executable,
extracted assets, generated source and manifest. Windows executables use .exe.
Pass a second argument to the build script for a custom empty output folder.
Initial compilation takes time; subsequent builds use cached results.
Normal builds use native, budget-free timing and native FS, ARM7, time and sound services.
For exact instruction timing, rebuild with --timing exact; set MKDS_HW_FS,
MKDS_HW_ARM7, MKDS_HW_TIME and MKDS_HW_SND to exact at runtime.
Launcher Accuracy mode sets those runtime switches; exact instruction timing also needs an exact build.
| Keyboard | Action |
|---|---|
| Z / X | Accelerate or confirm / brake or back |
| S / A | Hop or drift / use item |
| Arrow keys | Steering and menus |
| C / V | DS X / Y |
| Enter / Right Shift | Start / Select |
| Left mouse on lower screen | Touch input |
| F11 | Toggle fullscreen |
| Esc | Pause menu: Resume, Settings, Quit (the game waits) |
| F10 | Settings menu (the game keeps running) |
Controllers support the D-pad or left stick, bottom/right face buttons for A/B,
left/right bumpers for item/drift, and Start/Select. Connect before launch.
Rebind through the launcher or mkds.bat, or edit controls.txt.
| Platform | Folder for controls.txt and settings.txt |
|---|---|
| Windows | %APPDATA%\MKDS Native Builder\ |
| Linux | ~/.config/mkds-native-builder/ |
| macOS | ~/Library/Application Support/MKDS Native Builder/ |
| Setting | Essential options |
|---|---|
| Renderer | GPU (default) or Software |
| Scale | Auto (default, up to 4x) or 1–8; 1 keeps the original resolution |
| Filter | Sharp or Smooth |
| Layout | Stacked or SideBySide |
| Fullscreen | No or Yes |
For one launch, pass options such as play.bat --scale 1, --mute or --stats.
GPU texture replacement: set DumpTextures to a folder in settings.txt, play to
collect PNGs, then set TexturePack to your replacement folder and clear DumpTextures.
Keep filenames; replacement dimensions must be an integer multiple from 1–8 of the original.
Progress saves automatically in the data folder, as saves/<original ROM sha1>.sav.
The launcher's Saves card (on Home) shows what a save holds (Grand Prix trophies and grades, unlocked cups,
characters, karts and Mirror, missions, time trials) and can:
- Import save…: a melonDS or flashcart
.sav, a DeSmuME.dsv(its footer is removed) or a save from an earlier MKDSrust install. It is checked first, and your current save is copied tosaves/backup/before it is replaced. (New portable installs no longer copy data from the per-user folder; import your save instead.) - Export save…: a raw
.savthat emulators and flashcarts read. - Unlock all (for testing): makes a separate test save,
saves/<sha1>.unlocked.sav, from yours with every cup in every class, Mirror, all karts and the four secret characters unlocked. Records are not changed, and your own save is never touched: switch between My save and Test save at any time.
A flat 256 KiB save.sav beside the executable is imported if no user save exists.
MKDS_SAVE=off disables saving; MKDS_SAVE=<path> chooses another file.
Record/replay sessions use blank in-memory saves.
You must own the game and dump your cartridge yourself. No Nintendo code, assets or ROMs are included or downloaded; translation and extraction happen locally. Generated source, extracted assets and built games are for personal use only and must not be shared, including dumped game textures.
MKDSrust is not affiliated with or endorsed by Nintendo. Nintendo, Mario Kart DS and all other trademarks belong to their respective owners.
- Wiicompiled: static recompilation and platform design inspiration.
- Wheel Wizard: launcher workflow inspiration.
- GBATEK, melonDS and DeSmuME: public hardware and architecture references.
- N64Recomp, ultramodern / N64ModernRuntime, RT64 and aurora: translation, native service and presentation references.
- tylzars/mkds: the matching C decompilation (MIT); function names, struct layouts and signatures were cross-checked against it. No code was copied.
- ds-decomp and public MKDS mapping research: research references; reference status does not grant permission to copy code.
- Rust and dependency authors, including wgpu, eframe/egui and corosensei, and dictionary and verification contributors.
Project code is GPL-3.0-or-later; this license does not cover Nintendo material or ROM-derived output.
See the documentation for technical details, research, verification procedures and the roadmap.
Mods: mkdsrust.com/mods and Mods/ (official, and community ones reviewed through pull requests).
Portable Windows installs keep data next to MKDSrust.exe; see README.txt for storage, migration and fallback details.
