kart-recomp

kart-recomp is a native Windows port of the Switch 2 kart game with graphics running on Vulkan.

README

kart-recomp

A native Windows port of the Switch 2 kart game. Its ARM64 code is recompiled ahead of time into C++, and a small host stands in for the console, with the game's graphics running on Vulkan. No emulated CPU or GPU. Versions 1.0.0 and 1.8.0 work.

Race FPS over time: from about 42 with an emulated GPU to about 140 with the native renderer

Important

No game code or data is included. Don't use this with pirated copies: own the game and a Switch 2, and dump the game from your own console.

Run it

You need Windows 10/11 and a Vulkan 1.3 GPU. Nothing else to install: the launcher's Set up puts what is missing into the repository (Python and the .NET 10 SDK when the PC has none, the C++ compiler LLVM MinGW, the Python packages), with no admin rights and no Visual Studio.

launcher\build.bat
launcher\out\launcher.exe

The launcher takes you from your dump (or .nup) to playing. The first build takes about half an hour on an 8-core CPU, with a progress bar. Controls, settings and how it all works: docs/how-it-works.md.

Updating: unzip the new release into a new folder and click Bring over an older version… on the launcher's first step. It moves your build, tools, saves and settings over from the old folder, and Build then only redoes what changed. Scripted: launcher.exe --bring-over <old folder> --build --quit.

License

GPL-3.0-or-later. Third-party code and its licenses are listed in third_party\README.md.