Skip to content

Releases

Mario Kart World: Pit Stop 0.2.0 (PS5)

Choose a tag to compare

@exploitizm exploitizm released this 22 Nov 08:35

Mario Kart World: Pit Stop (PPSA99193) 0.2.0, now built on mkw-recomp 0.1.17. Races run at 60 fps by default with no frame generation; split screen is held at 30 fps. Black frames in races are gone, texture streaming is faster (the 1% low in the Grand Prix benchmark went from 37.7 to 42.1 fps) and plugins can be linked into the PS5 title. As before, you build the title on your PC, on Windows or Linux, from your own Mario Kart World 1.8.0 or 1.0.0 dump. Nothing of the game is in the release.

Changes

  • Races run at 60 fps by default on the PS5, with no frame generation: 17.1 ms a frame (58.5 fps) on a base PS5 in the Grand Prix benchmark. 30 fps and frame generation are still in Pit Stop.
  • Split screen is held at 30 fps (split_fps = 30; same follows the frame rate setting). At 60 fps, 2 players ran at about three quarters of real speed; at 30 fps, 2 players run at full speed.
  • No more black frames in races. Images the GPU wrote recently are kept when the game releases them (up to 16 MiB each), and the replay makes its alias copies where the frame reaches the target.
  • Faster texture streaming: changed textures are re-uploaded only where they changed (by row band), write-watch faults are handled in batches, block-linear textures are deswizzled on the GPU, and ASTC decodes are batched. The texture lock spins briefly before it sleeps, and the precheck yields it. Together: half as many frames over 33.3 ms in the benchmark (21 instead of 42), 1% low 42.1 fps, 0.1% low 25.8 fps.
  • Less CPU lost to the game's idle threads: 15 of every 16 YieldThread calls with nobody waiting become a short pause (MKW_YIELD_PAUSE).
  • Pit Stop leaves out the settings that do nothing on the console.
  • Plugins: upstream's native plugin API (version 4), and plugins linked into the title at build time (tools/ps5/build_game.py --plugin DIR), the only kind the PS5 can run. A linked plugin's mod folder and mod-settings/ can be written over FTP, and a plugin that declines to start is logged. An extension hook (--ext) lets outside projects add their own code.
  • Everything from mkw-recomp 0.1.14 to 0.1.17 (merged from upstream): see those versions' sections below.
  • Diagnostics for odd frames (MKW_ODD_CHECK, MKW_RTSIG, MKW_BLACK_CHECK), and tools/ps5/bench.py kills a title the hang watch reports stuck.

Tested before publishing

Before publishing:

  • On a base PS5, from main at 30b6f62 (the code in this release, apart from the README): a 210-second Grand Prix benchmark at 60 fps with frame generation off. 17.10 ms average, 1% low 42.1 fps, 0.1% low 25.8 fps, race speed 0.97x, no crash.
  • Split screen at 30 fps, 2 players, on a base PS5 (an earlier build of the same branch): 33.35 ms, race speed 1.00x.
  • After the 0.1.17 merge, on Linux: --selftest, --probe-cfg, the plugin probe (loaded and linked in), tests/test_cfg.py and tests/test_mod_settings.py.
  • The placeholder and both builder packages pass the release's no-game-content check and match SHA256SUMS.
  • Both builder packages, unpacked into clean folders, pass prepare_ps5.py --check-only on a 1.8.0 console dump (the Windows one through its own Python, on Windows). This check caught two missing files in the first pack, and the release is packed with them.

Not run from these packages: a whole title build through the Windows or Linux builder, the send to the placeholder, and an update over an installed 0.1.0 title.

Requirements

  • Your own game copy: Mario Kart World version 1.8.0 or 1.0.0 (exefs/ and romfs/, decrypted, or a .nup file), dumped from your own Nintendo Switch 2; a console dump with the 1.8.0 update in updates/ is used as it is. Nothing of the game is in this release or repository.
  • A jailbroken PS5: running a payload loader (etaHEN or elfldr), kstuff, and ShadowMountPlus 1.7 Beta 5 or newer to register homebrew titles in /data/homebrew/.
  • A PC with about 30 GB free to build the title from your dump, on the same network as the PS5:
    • Windows 10 or 11 (64-bit): nothing to install; the Windows builder carries its own Python, zig and glslc. No WSL needed.
    • Linux x86-64 or WSL2: Python 3, with clang and lld (18 or newer).

Install on Windows (no WSL)

  1. On the PS5: unzip mkw-pit-stop-<version>-ps5-placeholder-PPSA99193.zip and upload the PPSA99193 folder to /data/homebrew/ with an FTP client (FileZilla, WinSCP), so that /data/homebrew/PPSA99193/eboot.bin exists. Once ShadowMountPlus registers it, launch Mario Kart World: Pit Stop: it shows Game files missing with Console IP: <address> (port 19913). Leave that screen open; the PS5 only receives files while it is shown.
  2. On the PC: download mkw-pit-stop-<version>-ps5-builder-windows-x86_64.zip. Right-click it, Properties, tick Unblock, OK; then extract it to a short folder on a drive with 30 GB free, such as C:\PitStop (not Program Files or OneDrive).
  3. Run mkw.exe from that folder. On Game files, choose your dump with Choose folder (or Choose .nup or .nx file). Under Build for PS5, type the IP from the PS5 screen into PS5 IP and press Build for PS5. The steps tick off one by one; the first build takes a long time. You do not need the desktop Set up button for the PS5.
    Without the launcher, from a Command Prompt in that folder:
    prepare_ps5.bat --source "D:\Dumps\MKW" --send 192.168.1.50
  4. While the PC builds, the PS5 screen shows its step and progress; then Receiving from PC builder... and Transfer complete!. Press Cross, then launch Mario Kart World: Pit Stop again. Press Options + touchpad click at any time in game to open the Pit Stop settings overlay.

Copy already on the PS5: tick My game files are already on the PS5 and type its folder there (with exefs and romfs in it or in its updates\<version>): only the game code and shaders are sent.

Without the network: choose To a USB drive and Choose drive in step 3: the title goes to homebrew\PPSA99193 on the drive (exFAT, about 25 GB free), where ShadowMountPlus finds it on the PS5. The placeholder is not needed then; remove /data/homebrew/PPSA99193 if it is installed, so only one copy is registered.

If the PS5 stays on Waiting for connection, check the IP and that the PC and the PS5 are on the same network. A failed build is explained in logs/setup.log beside mkw.exe.

Install on Linux or WSL2

  1. Download mkw-pit-stop-<version>-ps5-builder-linux-x86_64.tar.zst from this release, verify it against SHA256SUMS, and unpack it (tar --zstd -xf mkw-pit-stop-*.tar.zst).
  2. Run prepare_ps5.py pointing at your Mario Kart World dump (a folder or a .nup file):
    python3 prepare_ps5.py --source /path/to/your/mkw-dump --out ./PPSA99193
    The first run finds the dump's version by exefs/main's build ID (1.8.0 d00e4f399e411d06, preferred, or 1.0.0 9e244438c3d8ef1c), generates and compiles the game's C code for the PS5 (ps5-high144), links and signs eboot.bin against the bundled runtime and RADV driver, downloads NVIDIA's nvdisasm and ptxas (pinned by SHA-256) to build the SM86 shader specification on your machine, translates the game's 11,561 shaders to spirv/, and copies exefs/ and romfs/ into PPSA99193/.
  3. Copy PPSA99193 to /data/homebrew/PPSA99193 on your PS5 over FTP or USB, or pass --deploy <PS5_IP> to upload, verify by SHA-256, and refresh ShadowMountPlus's registered sce_sys.
  4. Launch Mario Kart World: Pit Stop (PPSA99193) from the PS5 home screen. Press Options + touchpad click at any time in game to open the Pit Stop settings overlay.

Updating

Unpack the new builder over your folder (or pass the same --work directory) and build again (Build for PS5 on Windows, prepare_ps5.py on Linux): steps whose inputs have not changed (such as romfs/ and unchanged shaders) are skipped, and only updated parts are rebuilt and uploaded. Saves and mkw.ini settings on the console are kept.

Known issues

  • Peak video memory before the first race is about 1 GiB higher than in 0.1.0's code (6.2 instead of 5.2 GiB in the benchmark). Nothing failed from it in the benchmark; long sessions may run short of memory sooner.
  • Races at 60 fps run slightly slower than real time (0.97x in the benchmark), because a few frames take longer than 16.7 ms where the course streams in new textures.
  • Split screen with 3 or 4 players has not been measured at 30 fps. At about 42 ms a frame, it would run at about 0.8x speed.
  • Still open from 0.1.0: free memory falls race after race in long sessions; a few sparse texture tiles stay unloaded from boot; the first multiplayer race on a course can drop a player whose shaders are still compiling. There is no Nintendo online play.

Licenses and source

The PS5 files in this release are under GPL-3.0-or-later as a whole: the PS5 title links GPL-3.0-or-later code (the PS5 payload SDK fork's platform layer and PS5_Vulkan's start-up code). mkw-recomp's own code is MIT. Each package holds LEGAL.txt and licenses/ with every part, its license, copyright and source revision. The complete source of every part is attached to this release as source/*.tar.gz (listed in source/SOURCES.txt, digests in SHA256SUMS).

Reporting a problem

Open an issue at https://github.com/exploitizm/mkw-pit-stop/issues and attach the console kernel log (klog) and logs/setup.log from the PC builder folder.

Mario Kart World is © Nintendo. Mario Kart World: Pit Stop is an unofficial fan project and is not affiliated with or endorsed by Nintendo, Sony Interactive Entertainment, or any game publisher.

Mario Kart World: Pit Stop 0.1.0 (PS5)

Choose a tag to compare

@exploitizm exploitizm released this 19 Nov 23:39

First release of Mario Kart World: Pit Stop (PPSA99193), a native PlayStation 5 port of mkw-recomp, built on mkw-recomp 0.1.13 and the upstream work after it. You build the title on your PC, on Windows or Linux, from your own Mario Kart World 1.8.0 or 1.0.0 dump; nothing of the game is in the release.

Changes

  • Native PS5 platform layer: the ps5-high144 guest layout, direct-memory backing, hardware write tracking with hot-page batching, and the early-read watch.
  • Direct Vulkan display over RADV for the PS5, DualSense input with rumble and PlayStation button prompts for up to four signed-in players, and stereo sound through sceAudioOut.
  • Pit Stop, the in-game settings overlay (Options + touchpad click): quick rows (Master volume, Vibration strength, Performance HUD), every settings category (Display, Graphics, Controls, Audio, General, Advanced, Hacks, Multiplayer) and live controller remapping.
  • PS5 device profile: races in the game's 30 fps mode, shown at 60 with frame generation (Pit Stop turns it off). 60 fps stays an option; races then run slower than real time. The parallel replay finishes its walk before handing work out, which removes single black frames in races for about 2 fps.
  • Faster races on the PS5: no shadow copies of GPU-written memory (race frame work 22 → about 18 ms), a memory governor over all free memory that evicts the oldest textures first, and reads next to watched memory served without stopping the game.
  • Multiplayer: the game's split screen with one DualSense per signed-in player, and the game's local wireless mode over the LAN, between PS5s or with the PC build of the same version.
  • Fixes for magenta and corrupted textures (terrain copies into BC images, textures under memory pressure), hitches from blocking log writes, and the title-screen pause.
  • Game-free PC builder for Windows (no WSL: a zip with its own Python, zig and glslc, and the start screen's Build for PS5) and Linux, from a dump folder or .nup of 1.8.0 or 1.0.0; a placeholder title that shows the console's address and the PC build's progress, and receives the built game from the PC; and a verified FTP deployer.
  • Installing is faster and has more ways: the RomFS and the shaders go as romfs.nup and spirv.nup (read in place by the title, not unpacked) instead of some 250,000 files; a broken send goes on where it stopped and leaves the placeholder able to start; the send shows its speed and time left; the title can be written to an exFAT USB drive that ShadowMountPlus finds on the PS5; and a copy already on the console can be used as it is, so only the game code and shaders are sent.
  • Licences: the PS5 files are GPL-3.0-or-later as a whole (they link the PS5 payload SDK's platform layer and PS5_Vulkan's start-up code); each package carries LEGAL.txt and licenses/, and the source of every part is attached as source/*.tar.gz.

Tested before publishing

From this build (8aadeae):

  • The placeholder and both builder packages pass the release's no-game-content check, and match SHA256SUMS.
  • The Linux builder package unpacks and starts; both builders carry this build's send and shader fixes.

From earlier builds of the same branch:

  • On a base PS5: boot, intro movies, menus, single-player Grand Prix races and 5 minutes of 2-player split-screen races without a crash; a PS5 hosting and a Windows PC joining over the LAN finished whole races.
  • Linux: --selftest, --probe-cfg, --probe-nvn, --probe-vkmem, --probe-astc.
  • The Linux builder package, unpacked into a clean folder, built the whole title from a 1.8.0 console dump (17.5 minutes at 8 jobs).
  • The Windows builder built the whole title's shaders through its own Python and NVIDIA tools.

Not yet run from these packages: the Windows builder end to end on a clean folder (build, send, boot), the placeholder's progress screen on the console, and an update over an installed title.

Requirements

  • Your own game copy: Mario Kart World version 1.8.0 or 1.0.0 (exefs/ and romfs/, decrypted, or a .nup file), dumped from your own Nintendo Switch 2; a console dump with the 1.8.0 update in updates/ is used as it is. Nothing of the game is in this release or repository.
  • A jailbroken PS5: running a payload loader (etaHEN or elfldr), kstuff, and ShadowMountPlus 1.7 Beta 5 or newer to register homebrew titles in /data/homebrew/.
  • A PC with about 30 GB free to build the title from your dump, on the same network as the PS5:
    • Windows 10 or 11 (64-bit): nothing to install; the Windows builder carries its own Python, zig and glslc. No WSL needed.
    • Linux x86-64 or WSL2: Python 3, with clang and lld (18 or newer).

Install on Windows (no WSL)

  1. On the PS5: unzip mkw-pit-stop-<version>-ps5-placeholder-PPSA99193.zip and upload the PPSA99193 folder to /data/homebrew/ with an FTP client (FileZilla, WinSCP), so that /data/homebrew/PPSA99193/eboot.bin exists. Once ShadowMountPlus registers it, launch Mario Kart World: Pit Stop: it shows Game files missing with Console IP: <address> (port 19913). Leave that screen open; the PS5 only receives files while it is shown.
  2. On the PC: download mkw-pit-stop-<version>-ps5-builder-windows-x86_64.zip. Right-click it, Properties, tick Unblock, OK; then extract it to a short folder on a drive with 30 GB free, such as C:\PitStop (not Program Files or OneDrive).
  3. Run mkw.exe from that folder. On Game files, choose your dump with Choose folder (or Choose .nup or .nx file). Under Build for PS5, type the IP from the PS5 screen into PS5 IP and press Build for PS5. The steps tick off one by one; the first build takes a long time. You do not need the desktop Set up button for the PS5.
    Without the launcher, from a Command Prompt in that folder:
    prepare_ps5.bat --source "D:\Dumps\MKW" --send 192.168.1.50
  4. While the PC builds, the PS5 screen shows its step and progress; then Receiving from PC builder... and Transfer complete!. Press Cross, then launch Mario Kart World: Pit Stop again. Press Options + touchpad click at any time in game to open the Pit Stop settings overlay.

Copy already on the PS5: tick My game files are already on the PS5 and type its folder there (with exefs and romfs in it or in its updates\<version>): only the game code and shaders are sent.

Without the network: choose To a USB drive and Choose drive in step 3: the title goes to homebrew\PPSA99193 on the drive (exFAT, about 25 GB free), where ShadowMountPlus finds it on the PS5. The placeholder is not needed then; remove /data/homebrew/PPSA99193 if it is installed, so only one copy is registered.

If the PS5 stays on Waiting for connection, check the IP and that the PC and the PS5 are on the same network. A failed build is explained in logs/setup.log beside mkw.exe.

Install on Linux or WSL2

  1. Download mkw-pit-stop-<version>-ps5-builder-linux-x86_64.tar.zst from this release, verify it against SHA256SUMS, and unpack it (tar --zstd -xf mkw-pit-stop-*.tar.zst).
  2. Run prepare_ps5.py pointing at your Mario Kart World dump (a folder or a .nup file):
    python3 prepare_ps5.py --source /path/to/your/mkw-dump --out ./PPSA99193
    The first run finds the dump's version by exefs/main's build ID (1.8.0 d00e4f399e411d06, preferred, or 1.0.0 9e244438c3d8ef1c), generates and compiles the game's C code for the PS5 (ps5-high144), links and signs eboot.bin against the bundled runtime and RADV driver, downloads NVIDIA's nvdisasm and ptxas (pinned by SHA-256) to build the SM86 shader specification on your machine, translates the game's 11,561 shaders to spirv/, and copies exefs/ and romfs/ into PPSA99193/.
  3. Copy PPSA99193 to /data/homebrew/PPSA99193 on your PS5 over FTP or USB, or pass --deploy <PS5_IP> to upload, verify by SHA-256, and refresh ShadowMountPlus's registered sce_sys.
  4. Launch Mario Kart World: Pit Stop (PPSA99193) from the PS5 home screen. Press Options + touchpad click at any time in game to open the Pit Stop settings overlay.

Updating

Unpack the new builder over your folder (or pass the same --work directory) and build again (Build for PS5 on Windows, prepare_ps5.py on Linux): steps whose inputs have not changed (such as romfs/ and unchanged shaders) are skipped, and only updated parts are rebuilt and uploaded. Saves and mkw.ini settings on the console are kept.

Known issues

  • Long sessions: free memory falls race after race as the game keeps earlier courses' data; when it runs low, textures can come out corrupted or missing. Restart the title after a few races if that happens.
  • From boot, a few sparse texture tiles stay unloaded: minor texture corruption near the start line and a black-and-white race intro.
  • Multiplayer: the first race on a course can drop a player whose shaders are still compiling (a stall at race load); later races on that course work. Split screen runs slower than single player, below 30 fps in busy scenes.
  • Mode, character and vehicle select screens still differ slightly from the console. There is no Nintendo online play.

Licenses and source

The PS5 files in this release are under GPL-3.0-or-later as a whole: the PS5 title links GPL-3.0-or-later code (the PS5 payload SDK fork's platform layer and PS5_Vulkan's start-up code). mkw-recomp's own code is MIT. Each package holds LEGAL.txt and licenses/ with every part, its license, copyright and source revision. The complete source of every part is attached to this release as source/*.tar.gz (listed in source/SOURCES.txt, digests in SHA256SUMS).

Reporting a problem

Open an issue at https://github.com/exploitizm/mkw-pit-stop/issues and attach the console kernel log (klog) and `...

Read more