github MIXIDtheSilly/kart-recomp v0.2

one hour ago

The launcher now updates itself, there's a Linux version, pads vibrate, and several GPU crashes and black screens are fixed. AMD users: this is the first release with the AMD crash changes, so please try it and report back.

Important

This release contains no game code or data. You build the game yourself from your own dump. Don't use this with pirated copies: own the game and a Switch 2, and dump it from your own console.

Getting started

Windows: download kart-recomp-0.2-windows.zip, unzip it somewhere without spaces in the path, and run launcher\out\launcher.exe.

Linux: download kart-recomp-0.2-linux.tar.gz, unpack it, and run launcher/out/launcher (or ./kart.sh). You need a Vulkan 1.3 driver, SDL 3 (Fedora SDL3, Debian/Ubuntu libsdl3-0), g++ and Python 3.10+ with venv. See the README for the commands without a window.

Then follow the launcher's four steps: pick your dump (folder or .nup), click Set up, build (about half an hour the first time), play. Set up installs everything else into the folder, without admin rights or Visual Studio.

Updating

From 0.1.x (once): unzip 0.2 into a new folder, run its launcher, click Bring over an older version… on the first step, pick your old kart-recomp-… folder, then click Build. The shader translator changed, so the shader step runs again; the game's code is not recompiled.

From 0.2 on: the launcher checks GitHub when it starts and offers each new release once (Update to … at the top right if you said no). It downloads it, checks it, replaces only the files that changed, and starts again. Your build, saves and settings stay as they are. UPDATE_CHECK=0 in local.cfg turns the check off.

What's new in 0.2

  • The launcher updates itself from GitHub releases (see above). Scripted: launcher.exe --update.
  • Linux port: SDL 3 window, input and audio, the same launcher, and ./kart.sh setup | game | build | play | bake.
  • Controller vibration for Xbox, PlayStation and Pro Controller pads (thanks to Rafacasari, #27).
  • Fixed: sky and ambient lighting could freeze after a while in a race (thanks to Rafacasari, #28, closes #24).
  • Fixed: a GPU crash ("device lost") on NVIDIA from an effect shader on Koopa Troopa Beach and probably other courses (thanks to Rafacasari, #33).
  • Fixed: black screens. Videos in the menus and before the start stopped after one loop, and the screen could stay black before a race (thanks to Rafacasari, #33). A looping movie can no longer deadlock the decoder.
  • AMD GPUs: the game's shaders are written for 32-wide subgroups, and AMD GPUs can run 64 wide. Pipelines now ask for 32 where the GPU supports both. This is the suspected cause of the crash a few seconds in (#11, #23, #29, #34), but it's untested on AMD so far.
  • Crashes are logged: a crash inside the graphics driver or another module now writes a [RED] crash: line with a stack to host.log. The freeze report can no longer hang.
  • The shader step works without the lz4 package (Python 3.15, #30).
  • A program that can't be started is now named instead of a bare "[WinError 2]" (#22).
  • Bake textures shows progress in the launcher, and its worker processes stop when it ends.

Known issues

  • AMD: please try 0.2 and attach your host.log to your issue, even if it still crashes. Look for the nvk: subgroups and [RED] crash: lines.
  • A GPU crash ("device lost") can still happen now and then. A host.log from such a run helps.
  • A silent crash on some NVIDIA PCs (#26) is still being looked into.
  • The first races can stutter while pipelines and textures are prepared (Bake textures in the launcher helps).

Don't miss a new kart-recomp release

NewReleases is sending notifications on new releases.