A fix for the Linux AppImage: 0.1.14's setup stopped at check for every player, new setups and updates alike.
Changes
- The setup from the Linux AppImage stopped at
check(#632). 0.1.14 compares the files of the setup's keys
with the package's list, and the AppImage reaches its tools throughsetup/, a link to its mount, while the list's
folder was the mount's real path:ValueError: ... is not in the subpath of ...on every setup. Both are compared
resolved now, with a test that runs through the link. Our release check ran the setup through the mount's path and
missed it; it now runs it through the link, as the start screen does. Windows was not affected. logs/setup.logno longer fills with thread stacks in a healthy setup: the watchdog for a stopped setup
(#251, #506) now writes them only after two minutes without an event, not every two minutes from the start (a
12-minute setup carried ~1 000 lines of them, which read like an error).
Tested before publishing
From the packages Actions built for this tag, before publishing:
- The whole setup from the Linux AppImage through its
setup/link, as the start screen runs it (12 threads, game
1.0.0), in about 10 minutes; its warm-up built all 13 630 shader libraries and compute pipelines with none failed. - The whole setup from the Windows zip (the 6-thread Windows PC, game 1.0.0); its warm-up built the same 13 630 with
none failed.
Install
- Linux x86-64, glibc 2.31 or newer (Debian 11, Ubuntu 20.04, SteamOS and later):
chmod +xthe AppImage and run it.
The game it builds lives in~/.local/share/mkw-recomp. On 64-bit ARM (ARMv8.2: Snapdragon 8 Gen 1 and newer), the
-aarch64.AppImage. - Windows 10/11 x64: unpack the zip into a folder and run
mkw.exe. - Either: a Vulkan 1.3 GPU and about 30 GB free. Open Game files, point it at your own dump of Mario Kart World
1.0.0 or 1.8.0 (itsexefs/andromfs/, or one.nupor.nxfile) and press Set up. Nothing of the game ships here: the setup builds it on your
machine and downloads NVIDIA'snvdisasmandptxas(pinned by sha256; 84 MB on Linux, 126 MB on Windows) to
describe the shader encoding. - Every package and the
mkw.exein the zip carry a build attestation:gh attestation verify mkw.exe --repo adriadam10/mkw-recompshows it was built by this repository's GitHub Actions. An antivirus that flags it by its
behaviour (it compiles and loads the game's code) is a false positive: report it to that antivirus.
Updating
From 0.1.5 on, the start screen offers a newer release (Update to vX) and installs it: it downloads it, checks it,
replaces the program and sets up again only what changed. From an older version, once by hand: Linux, run the new
AppImage; Windows, unpack the new zip over the same folder; then press Set up again (the steps already done are
skipped).
Known issues
Reporting a problem
Open an issue with the bug form and attach the logs: logs/mkw.log (the game and the start screen) and
logs/setup.log (the setup's tools), in ~/.local/share/mkw-recomp on Linux and next to mkw.exe on Windows.