Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

cheemu21/plumber-racer-2

Games

Build a sideloadable IPA or Mac app from your own Switch game dump.

183
30
Python
MIT
8 days old

Overview

Plumber Racer 2 is a front-end distribution of nxnative, a project that runs Nintendo Switch game code natively on Apple silicon rather than emulating the console. It is aimed at users who own a Switch game dump and want to play it on iPhone, iPad or Mac. The repository ships no game files; users must supply their own dump of a supported game version.

For Mario Kart World the README pins version 1.0.0 (base game, no update or DLC, main build ID 9e244438c3d8ef1c703a6a85ef99c4f0) and points to a dedicated game page. A large gallery lists tested titles, some marked with target frame rates or known issues such as missing Mii heads or offline-only modes.

Quick start

Building requires a Mac running macOS 26.6+, Xcode 27.2, Homebrew and Python 3.12+ (arm64). For an iPhone build, also install Xcode's iOS platform component.

  1. Select the right Xcode and fetch the Metal toolchain:
sudo xcode-select -s /Applications/Xcode.app
xcodebuild -downloadComponent MetalToolchain
git clone https://github.com/seedds/nxnative.git && cd nxnative
brew install xcodegen zstd glslang
brew install --cask dotnet-sdk
python3 -m pip install lz4 "capstone>=5,<6" fonttools nsz zbic "backports.zstd; python_version < '3.14'"
  1. Put your game files and any update/DLC into one folder, e.g. ~/Games/MarioWonder/ with .nsp, .xci, .nsz or .xcz files.

  2. Build with your game folder and prod.keys:

python3 scripts/build_ipa_from_nsp.py ~/Games/MarioWonder -k ~/keys/prod.keys

The IPA appears in the game's folder. First builds take 30–60 minutes and need free disk roughly twice the game size plus 10 GB. Add --platform mac-app to produce a Mac app instead. Full options are documented in the packing script guide.

  1. Sideload the IPA with AltStore, Sideloadly or LiveContainer; enable Increased Memory Limit when offered. If the game is too large, rebuild with --romfs separate and run the printed copy command (quick reinstall notes). Controls and saves are covered in Playing.

Switch 2 games are built from a folder of extracted files rather than NSPs, are Mac-only for now, and need no prod.keys; see the Switch 2 section.

Constraints

iPhone and iPad play needs iOS/iPadOS 26+ on an iPhone 15 Pro or newer (A17 Pro) or an M1 iPad or newer, because the games' textures are BC-compressed. Games outside the tested list are packed on a best-effort basis and may not start. No game data is bundled; you must legally supply your own dump. The code is MIT licensed, while bundled third-party components keep their own licenses (third-party notes).

HotRepo's take

The repository appears in HotRepo's new-project list for Python on 2026-11-10, with a growth window starting 2026-11-09 and 52 stars added over roughly 24 hours. The collected star curve shows the count climbing from 101 on 2026-11-07 to 166 by 2026-11-10, with the steepest few hours late on 2026-11-09. No all-language daily rank was recorded, so the figure reflects the new-project feed rather than a broad trending position. The project builds directly on nxnative and reuses d2r-mobile and Ryujinx components (third-party licenses), so its value to most readers depends on how close their dump and hardware match the tested configurations.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. seedds/nxnativePacks your own Switch and Switch 2 game files into native Apple silicon Mac apps or sideloadable iOS IPAs.Python14,530
  2. adriadam10/mkw-recompStatically recompiles Mario Kart World into a native Linux/Windows PC program using your own game dump.C104
  3. c22dev/mush8Run Mario Kart 8 Deluxe on Apple Silicon Macs and iPhones using your own game dump, with LAN, online and local wireless play.Rust724
  4. LNPANDY/NX2AppleA macOS/Windows launcher that builds your own Switch game dumps into native apps for Apple silicon Mac, iPhone and iPad.Swift4,445
  5. jhaizhou-ops/S2ArmRecompiles your own Switch games to native ARM64 for iPhone, iPad and Apple silicon Mac, with graphics routed to Metal.C#2,626