Repository navigation
Mario Kart World: Pit Stop 0.2.0 (PS5)
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;samefollows 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
YieldThreadcalls 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 andmod-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), andtools/ps5/bench.pykills a title the hang watch reports stuck.
Tested before publishing
Before publishing:
- On a base PS5, from
mainat30b6f62(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.pyandtests/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-onlyon 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/andromfs/, decrypted, or a.nupfile), dumped from your own Nintendo Switch 2; a console dump with the 1.8.0 update inupdates/is used as it is. Nothing of the game is in this release or repository. - A jailbroken PS5: running a payload loader (
etaHENorelfldr),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
clangandlld(18 or newer).
Install on Windows (no WSL)
- On the PS5: unzip
mkw-pit-stop-<version>-ps5-placeholder-PPSA99193.zipand upload thePPSA99193folder to/data/homebrew/with an FTP client (FileZilla, WinSCP), so that/data/homebrew/PPSA99193/eboot.binexists. Once ShadowMountPlus registers it, launch Mario Kart World: Pit Stop: it shows Game files missing withConsole IP: <address> (port 19913). Leave that screen open; the PS5 only receives files while it is shown. - 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 asC:\PitStop(notProgram Filesor OneDrive). - Run
mkw.exefrom 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 - 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
- Download
mkw-pit-stop-<version>-ps5-builder-linux-x86_64.tar.zstfrom this release, verify it againstSHA256SUMS, and unpack it (tar --zstd -xf mkw-pit-stop-*.tar.zst). - Run
prepare_ps5.pypointing at your Mario Kart World dump (a folder or a.nupfile):The first run finds the dump's version bypython3 prepare_ps5.py --source /path/to/your/mkw-dump --out ./PPSA99193
exefs/main's build ID (1.8.0d00e4f399e411d06, preferred, or 1.0.09e244438c3d8ef1c), generates and compiles the game's C code for the PS5 (ps5-high144), links and signseboot.binagainst the bundled runtime and RADV driver, downloads NVIDIA'snvdisasmandptxas(pinned by SHA-256) to build the SM86 shader specification on your machine, translates the game's 11,561 shaders tospirv/, and copiesexefs/andromfs/intoPPSA99193/. - Copy
PPSA99193to/data/homebrew/PPSA99193on your PS5 over FTP or USB, or pass--deploy <PS5_IP>to upload, verify by SHA-256, and refresh ShadowMountPlus's registeredsce_sys. - 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.