adriadam10/mkw-recomp v0.1.9

on GitHub

Mario Kart World 1.8.0 as well as 1.0.0, HDR on HDR screens, the menus in 19 languages and the game itself in Catalan,
Galician and Basque, 5.1 sound, and fixes for crashes and freezes reported since 0.1.8.

Changes

• Game version 1.8.0 (#19, #172 by @flavio-silva): the setup takes a 1.8.0 dump as well as 1.0.0, recognises it by
  its exefs/main and builds that version. Tested by its author on Windows up to the title and a race in Toad Harbor;
  on 1.8.0 the ultrawide menus, the shadow map size and the fixed seed have no effect yet.
• A dump as one file (discussion #8, #167 by @Robert-Hoffman04): Game files > Choose .nup or .nx file takes a
  .nup package or a .nx (NXFormat) archive where the setup took the exefs/ and romfs/ folders; with "Use it
  where it is" the game reads its files straight from the package, without the 23 GB copy.
• HDR (#168): Settings > Screen > HDR: Automatic (default) or Off. On a display in HDR the game shows its own HDR
  picture, as the console does, with the system's peak and paper white; it follows the system's HDR setting live.
• Languages: the menu (F1), the start screen and the setup page in English, Japanese, French, German, Italian,
  Spanish (Spain and Latin America), Dutch, Portuguese (Portugal and Brazil), Russian, Simplified and Traditional
  Chinese, Korean, Catalan, Galician, Basque, Polish, Turkish and Ukrainian; Automatic follows the system's language.
  These first translations are ours: corrections from native speakers are very welcome (i18n/*.po, by pull request).
  The setup's errors (a folder without the game, an encrypted or other version, an incomplete copy) are shown in the
  menu language.
• The game in Catalan, Galician and Basque: Settings > Game > Language. The game's own texts are rebuilt from your
  copy at setup (i18n/game/); the rest of the game stays in Spanish. A system set to one of them picks it. On 1.8.0,
  81 texts that changed since 1.0.0 stay in Spanish (#178 by @flavio-silva: the setup of a 1.8.0 dump stopped there).
• Brazilian Portuguese: a Brazilian system picks the game's Brazilian Portuguese (discussion #42, #134 by
  @GabrielAndrade419).
• 5.1 surround sound when the system's output has 6 channels (discussion #90).
• LAN play (discussion #148, #144 by @EdouardSence): Settings > Game > LAN play turns the title menu's Wireless
  Play into the game's hidden LAN Play, which joins games on the same local network over UDP (ports 49152 and 35000).
  It only reaches local network addresses, never the internet. Off by default: so far it has been played between two
  instances on one Linux PC, not yet between two PCs or on Windows. If you have two PCs on one network, please try it
  and tell us in discussion #148.
• A new start screen: dark, with the port's logo and no game art (#70, by @ViniciusStanula); the F1 menu keeps its look.
• A notice on screen when the players chosen lack controllers (#106, #160).
• The game stopped when swapping two controllers' players (#123).
• 16 GB machines keep their pipeline workers (#132).
• The game stopped on some error screens (#147): they are logged instead of opening the console's error applet.
• Long freezes on the title or at start (#111 and others): shaders the translator now structures instead of running
  them as a slow switch (after updating, the setup's shader step runs again); a start that died building pipelines, or a failed present, no longer breaks every next start.
• Starting on Windows takes 20 s less (#128): the game files are indexed per folder.
• Game files set up by another version are set up again, also after updating by hand (#50).
• Saves survive an antivirus or OneDrive holding the file, and only one copy of the game runs per profile.
• Windows with the window minimized or hidden keeps its timing (no slowdown in the background).
• Fixes in threads and fibers inherited from the Switch 1 port (core masks, waits on 64-bit values, fibers resumed on
  another thread).
• From contributors: the window's picture takes the lines it is shown at (#130), the start no longer waits forever for
  a pipeline the driver never returns (#131), and a faster shader lookup (#129), by @guillo1990; replay chunks ended on
  their own thread (#141, by @riyadhHDA); development runs capped and stoppable (#145, by @EdouardSence); Adreno
  GPUs (Turnip) reach the menus and races without blue lines, and Linux on AArch64 (#170, #171, #173, #176, by
  @titooo7): this release has its own AppImage, mkw-recomp-0.1.9-aarch64.AppImage (ARMv8.2, Snapdragon 8 Gen 1 and
  newer).
• Diagnostics: a log line when the game waits too long for its frame, saying what the submission was doing (#138), and
  GPU breadcrumbs on more commands (#43); MKW_RTSTATS and MKW_DUMP_DRAWS for rendering bugs that log no error (#80,
  by @guillo1990).

Tested before publishing

From these packages, before publishing:

• The whole setup on Linux (Radeon 660M, RADV) and on Windows 11 (GTX 1050 Ti), with its one-minute warm-up: about 16
  minutes on Linux and 31 on Windows, where the shader step took 10 minutes (14 with 0.1.8).
• The game from the Linux package reading its files straight from a .nup and from a .nx dump.
• The AArch64 AppImage is built by the same release workflow but has not been run yet: we have no ARM machine. If you
  play on one, please tell us how far it gets (#176).

Install

• Linux x86-64, glibc 2.31 or newer (Debian 11, Ubuntu 20.04, SteamOS and later): chmod +x the 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 exefs/ and romfs/ (Mario
  Kart World 1.0.0, your own dump) and press Prepare. Nothing of the game ships here: the setup builds it on your
  machine and downloads NVIDIA's nvdisasm and ptxas (pinned by sha256; 84 MB on Linux, 126 MB on Windows) to
  describe the shader encoding.

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 Prepare 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.