mrkeyoor.comAsk

STS78721/MKW-THWOMPtested 20 Nov 2026commit 57a5766

MKW-THWOMP review

Our repository build completed, but the test command exited 1 with 25 collection/setup errors, so our run supports a cautious developer trial rather than a gameplay recommendation.

  • Install failed
  • Build 1 s
83/108passed, run exited non-zero
  • 34 packages
Dev Toolsevaluationupdated 21 Nov 2026
trackingstars / 7d

MKW-THWOMP translates Mario Kart World into a native Windows program using game data you supply from your own copy. Built on mkw-recomp, it adds a settings menu and performance overlay for players who want to try the game on PC.

Verdict

Our repository build completed, but the test command exited 1 with 25 collection/setup errors, so our run supports a cautious developer trial rather than a gameplay recommendation. Use MKW-THWOMP if you own the game, use Windows and want its settings menu and overlay. Skip it if online play or Grand Prix intermission routes are essential: one is explicitly unsupported and the other has an unresolved 0.2.2c report.

MKW-THWOMP infographic: translates Mario Kart World into a native Windows program, plus our test result and who it suits
Tested 21 November 2026: uv pip install mkw-recomp failed after 0.9 s. Before that: 20 Nov: source install 14 s, build 1 s.

We ran it

Lab card: what happened when we ran MKW-THWOMP
Lab card from our sandbox run
Screenshot of MKW-THWOMP (github.com/STS78721/MKW-THWOMP/releases/latest)
github.com/STS78721/MKW-THWOMP/releases/latest
Install✓ · 14s34 packages · 38 MB
Build✓ · 1s
Tests✗ · 7s83 passed · 0 failed · 31 skipped · 25 errors of 108 (pytest)
Repo744 files~205,883 lines of source · 13.9 MB · 2 CI workflows · tests dir

Answers from our run

Does MKW-THWOMP build from source?

Dependencies installed in 14 seconds (34 packages), and the build succeeded in 1 seconds. We cloned commit 57a5766 into a clean Debian container with 3 CPUs and no project-specific setup.

Do MKW-THWOMP's tests pass?

No. The project's own test command finished in 7 seconds and reported 83 passed, 0 failed, 31 skipped, 25 collection errors (pytest).

Who should not use MKW-THWOMP?

Players who need online play: the README explicitly lists it as unsupported.

What are the alternatives to MKW-THWOMP?

mkw-recomp, kart-recomp. Our repository build completed, but the test command exited 1 with 25 collection/setup errors, so our run supports a cautious developer trial rather than a gameplay recommendation.

Setup2/5In our 2026-11-21 run “uv pip install mkw-recomp” failed with “╰─▶ Because mkw-recomp was not found in the package registry and you…”, though our source checkout installed in 14 s and built in 1 s.Editor’s note: Installation was not reproduced through the supported Windows player setup; repository commands and a failed registry lookup assess different routes.
Docs4/5The README has an install section (“Mario Kart World, running natively on W…”) and a usage section (“🚀 Quick start”); we did not run its quickstart ourselves.Editor’s note: The English README covers requirements, dump preparation and settings, but this review does not rate unexecuted instructions on a numerical scale.
Community3/5Last push on 2026-11-19, 148 stars and maintainers answered or closed 2 of the 5 most-discussed issues we sampled.Editor’s note: Issue #2 contains a maintainer acknowledgement and a user-confirmed launch; this sample cannot establish support response times or community breadth.
Maturity1/5Latest release 0.2.2c on 2026-11-19 (pre-1.0), repository created 2026-11-09 and its test suite did not pass in our sandbox (83 of 108 passed).Editor’s note: The release and issue history show recent changes and unresolved mode-specific reports; a supported gameplay session was not recorded in our lab.

How we score

Who it’s for

Windows players who own the game, can supply their own dump and want THWOMP's menu and overlay.
Developers investigating the runtime and tooling who can distinguish repository checks from actual gameplay.
Duo and Moonlight users willing to apply the controller workaround reported in issue #3.

Who it’s NOT for

Players who need online play: the README explicitly lists it as unsupported.
Grand Prix players who require intermission routes: issue #5 reports them missing in 0.2.2c with no recorded resolution.
Anyone without their own game dump: the repository and release packages exclude game data.

Setup reality

Our November 20 run at 57a5766 installed in 14 seconds, recorded 34 dependencies using 38 MB and built in 1 second. Tests exited 1 after 7 seconds: 83 passed, 0 failed, 31 skipped and 25 collection/setup errors. The tail shows /usr/bin/cc subprocess errors, without the compiler diagnostic needed to explain them.

The documented player route needs Windows, a Vulkan 1.3 GPU and your own exefs and romfs dump for game version 1.0.0 or 1.8.0. It builds the runtime or uses a release package, then prepares the game from that dump. Online play is unsupported.

A separate November 21 attempt tried uv pip install mkw-recomp and stopped because the package was absent from the registry. That differs from the documented Windows route. Our repository sandbox had 3 CPUs, 8 GB RAM and image label ghcr.io/astral-sh/uv:python3.12-bookworm; actual runtime versions need raw toolchain logs.

Our November 20 sandbox run installed the repository in 14 seconds and completed its build step in 1 second, but the test command exited 1 with 25 collection/setup errors. Use MKW-THWOMP if you own Mario Kart World and want to experiment with its Windows recompilation. Skip it if online play or Grand Prix with its intermission routes is essential: the README excludes online play, and a Grand Prix player reports missing routes in 0.2.2c.

Players have taken this project beyond the intro. In issue #2, sahayog-shrestha reports working free roam at around 55 fps at 4K on an RTX 3080 and Ryzen 5 5600X. That is a useful reason to try it, provided you understand what the report describes: one person's free-roam session. The decision is whether you want to work through a changing fan project to get there.

What people use MKW-THWOMP for

GitHub users report free roam, streamed play through Duo and Moonlight, and Grand Prix, with different outcomes in each case.

MKW-THWOMP is a static recompilation: it translates the game's processor instructions into code your PC can run ahead of play. You supply the game data. The English README credits adriadam10/mkw-recomp for the underlying game runtime and describes THWOMP's additions as its settings menu, performance overlay, icon and native Windows build. If those additions appeal to you, this is the fork to investigate.

What someone actually did Who did it What happened
Built the game and explored free roam at 4K GitHub user sahayog-shrestha Reported a successful launch and around 55 fps using a 3080 and 5600X, with more testing to come.
Streamed a separate Windows session to Moonlight through Duo The reporter of issue #3 The streamed controller failed initially; forcing XInput restored input and rumble.
Played Grand Prix in 0.2.2c The reporter of issue #5 Reported missing intermission routes and apparently forced Classic Grand Prix behavior.

The streamed session is especially instructive if you share a gaming PC. The reporter could use the stream's mouse and keyboard, while the game logged a connected pad that did not respond. A controller appearing in the log therefore wasn't enough to show that the right session's controller had been selected. The workaround changes how the game discovers pads, rather than changing Moonlight's button bindings.

What happened when we ran it

Our November 20 run installed in 14 seconds, built in 1 second and exited the test command with code 1 after 7 seconds: pytest reported 83 passed, 31 skipped and 25 collection/setup errors.

Those are our repository harness results at commit 57a5766, using a recorded configuration of 3 CPUs, 8 GB RAM and image label ghcr.io/astral-sh/uv:python3.12-bookworm. The label describes the selected image; exact runtime and operating-system versions require the raw toolchain logs. The scan classified the tooling ecosystem as Python and recorded 34 dependencies occupying 38 MB.

Repository check, November 20 Recorded result What you can take from it
Install Succeeded in 14 seconds The harness completed its dependency step.
Build Succeeded in 1 second The recorded build command completed.
Tests Exit 1 in 7 seconds The suite did not complete cleanly.
Pytest summary 83 passed, 0 failed, 31 skipped, 25 errors Passing assertions coexist with collection/setup errors.

The install and build steps completed, then pytest hit errors around tests that compile native code. The tail names tests/test_game_dir.py cases for log destinations, long installation paths and truncated paths. Those cases raise subprocess.CalledProcessError for /usr/bin/cc commands. The final pytest line reads 83 passed, 31 skipped, 25 errors in 5.73s; that is pytest's own duration, while 7 seconds is the recorded test-step duration. Zero failed assertions does not make a command with 25 errors a pass. The truncated compiler commands don't expose the underlying compiler diagnostic.

There is also a separate November 21 attempt at commit 57a57668c861 using the quickstart-lib recipe. It cloned the project, then tried uv pip install mkw-recomp into a fresh virtual environment. The resolver returned “No solution found when resolving dependencies” and said the package was not found in the registry. The attempt stopped at installation with unsatisfiable requirements, and teardown completed.

That second attempt took a package-registry route, whereas the project's current quick start builds a Windows runtime from the repository and prepares your game dump. The run summary's wording says it installed from PyPI, but its own step log records failure. We follow the step log. Neither a fast repository build nor a failed registry lookup is a recording of a playable race.

Where people get stuck: old linking, streamed pads and Grand Prix

Issue #2 has a maintainer-confirmed replacement build flow; issue #3 has a reporter-confirmed workaround; issues #4 and #5 describe open problems without a recorded resolution.

Symptom What the reporter or maintainer says Action supported by the thread
Missing mkw_heap_owner_discard and mkw_heap_owner_record In issue #2, STS78721 acknowledges missing symbols in the pre-0.1.1 codebase. Move from the replaced BUILD-MKW.bat flow to the current instructions. A user subsequently reported a working build.
Controller connects but ignores the stream The issue #3 reporter says SDL can select another Windows session's virtual pad. Launch with only XInput enabled, using the reporter's workaround below.
Loading background disappears after a race The issue #4 reporter describes the transition to the next race on Windows 11 Pro with NVIDIA graphics. The report contains no fix or workaround.
Grand Prix skips intermission routes The issue #5 reporter says Classic Grand Prix appears permanently enabled in 0.2.2c. The report contains no resolution or confirmed switch to restore the routes.

The old linker failure deserves a precise answer because several people reproduced it. STS78721 explicitly told them they had done nothing wrong, acknowledged the two missing symbols, and said the project had been rebuilt on mkw-recomp for 0.1.1. Repeating the old batch command or hunting for an undocumented linker flag is the wrong starting point after that replacement. Follow the version's current setup flow.

For Duo streaming, the reporter explains that XInput routes controllers per Windows session, while other SDL input backends can see virtual controllers belonging to several sessions. SDL is the library handling input; XInput is the Windows controller interface that worked in this report. The reporter's launcher settings are:

set SDL_JOYSTICK_RAWINPUT=0
set SDL_JOYSTICK_HIDAPI=0
set SDL_JOYSTICK_WGI=0
set SDL_JOYSTICK_DIRECTINPUT=0
set SDL_XINPUT_ENABLED=1
mkw.exe

Run that from the game folder. In the reported 0.2.1b Duo session, input and rumble worked after this change. Automatic session detection and a selectable backend are proposals in the issue, rather than fixes the reporter says have shipped.

Windows and your own game dump are the starting requirements

The README asks for Windows 10 or 11, an AVX2-capable x86-64 processor and a Vulkan 1.3 GPU, plus your own Mario Kart World dump.

Its requirements table lists 16 GB system RAM and 8 GB graphics memory as minimums, with roughly 30 GB free during setup. Those are project requirements, separate from the much smaller dependency footprint in our repository check. You need the exefs and romfs data from game version 1.0.0 or 1.8.0. The repository contains the tools and runtime, without the game files.

The source quick start first builds and packages the runtime using the scripts under tools/build/. It then uses the bundled preparation script with your dump. This explains why treating the Python project name as an ordinary downloadable library misses the actual player setup. Python runs the tooling; the finished application is a native Windows game runtime.

The 0.2.2c release notes also describe a full setup wizard and a portable package, followed by selecting Game files, choosing your dump, running setup and pressing Play. Start with the route documented for the release you downloaded. Mixing an old batch-file guide with a newer portable package gives you instructions for different layouts.

The settings menu is THWOMP's main reason to choose this fork

The README identifies its Switch-2-style settings menu and performance overlay among THWOMP's additions to mkw-recomp.

You can open the settings menu with F1 or Esc. Settings live in mkw.ini beside mkw.exe, and the README describes environment-variable overrides with an MKW_ prefix. That is useful when you want to keep a particular configuration with a particular game folder. The overlay exposes frame-rate and frame-time information, so you have a place to watch behavior while changing graphics settings.

The November 19 release describes its shipped graphics defaults as FSR, Frame Generation Off and Presentation Mailbox. It also reports fixes involving DLSS/DLAA startup, water collision and rendering. Those are the maintainer's release claims. They should not be read as a resolution of every later visual report: the disappearing loading background in issue #4 is a different symptom, and the issue contains no reply identifying a fix.

Recent updates show activity, while the issues show unfinished work

GitHub records the last push on November 19, 2026, and the latest release as 0.2.2c, published that same day.

The repository showed 148 stars when checked on November 21. Stars count attention. The more useful support evidence is the sequence in issue #2: several users reproduced a failure, the maintainer acknowledged it and replaced the flow, and sahayog-shrestha returned to report a successful launch. That is a concrete example of a problem reaching a useful outcome.

The community discussion also moves faster than introductory coverage. On November 18, PixelCNinja posted that “MKW-THWOMP is back with v0.2.2”, pointing to a release. That post is a release pointer, rather than a performance test. For your own troubleshooting, the version, symptom and matching issue thread are more useful than a general announcement that the project now runs.

Your dump and saves stay outside release packages

The 0.2.2c release notes say personal settings, dumps, shader caches, saves and logs are excluded from release packages.

That packaging statement matters when choosing where to get the project: the official release describes tools that prepare your own copy, without supplying the game itself. Use the repository's release links to identify the setup wizard or portable package described in its notes. The README labels the project unofficial and unaffiliated with Nintendo, and gives its code an MIT license while retaining licenses for code taken from other projects. The code license and the requirement to bring your own game data are separate parts of the setup.

MKW-THWOMP vs mkw-recomp and kart-recomp

Choose mkw-recomp to evaluate the upstream project directly; consider kart-recomp for another documented Windows and Linux route; choose THWOMP for its particular menu and overlay.

Choice Documented difference When to look at it
MKW-THWOMP Its README credits mkw-recomp and describes its own menu, overlay and Windows packaging. You want those interface additions and are prepared to follow THWOMP-specific issue reports.
adriadam10/mkw-recomp The Grand Prix reporter compares upstream's Classic Grand Prix toggle with THWOMP's apparently forced behavior. Restoring that choice is important enough to evaluate upstream directly.
MIXIDtheSilly/kart-recomp Its README documents a native Windows and Linux port with a launcher. You want to evaluate a different launcher and its documented Linux route.

The upstream mkw-recomp README documents native Linux and Windows execution. THWOMP's own README names Windows as its player target. For a Linux machine, that platform distinction is a better starting point than assuming the forks have interchangeable packages.

The Classic Grand Prix comparison is narrower. The issue author says upstream has a setting under Hacks, while THWOMP seems always to enable it. That supports investigating a specific option. It doesn't rank the projects' frame rates, controller support or overall correctness. If intermission routes determine which version you want to play, inspect that option before spending time tuning graphics.

What the other reviews get wrong

Gamerbrowser's intro-only verdict is stale: its own November 20 update says MKW-THWOMP now races, and a GitHub user reports working free roam.

The Gamerbrowser overview still says the project is not playable, while adding an update that it now runs on adriadam10's mkw-recomp and races. Those statements leave a first-time reader with two different answers. The corrected answer is that playability has progressed beyond the intro, with the mode-specific reports discussed above. A Grand Prix complaint about missing intermission routes belongs in that answer too.

Search results also confuse the software's identity. Realm of Darkness's MKW Thwomp page is a Mario Kart Wii soundboard. It is unrelated to STS78721's Mario Kart World recompilation. Use the full repository name and owner when looking for instructions, particularly when an old page describes another Mario Kart game.

Questions people ask

Yes: players report working free roam, and Gamerbrowser's November 20 update says MKW-THWOMP now races.

Can I actually play Mario Kart World on PC with MKW-THWOMP now?

The free-roam report from sahayog-shrestha and Gamerbrowser's racing update support a qualified yes. You still need your own game dump and the Windows setup described by the project. The Grand Prix report concerns a particular missing part of that mode, rather than an inability to launch the game.

Why does building MKW-THWOMP fail with missing mkw_heap_owner_discard and mkw_heap_owner_record symbols?

The maintainer says the pre-0.1.1 codebase was missing those symbols at link time. The replacement 0.1.1 flow moved onto mkw-recomp, and a user subsequently confirmed a working build. Move away from instructions based on the replaced batch file.

How can I make my controller work when streaming MKW-THWOMP through Duo and Moonlight?

The issue #3 reporter restored input and rumble by enabling only SDL's XInput backend. Disable Raw Input, HIDAPI, WGI and DirectInput in the launcher environment and enable XInput. The report concerns Duo's multiple Windows sessions and virtual controllers.

Why does the loading-screen background disappear between races?

The issue #4 reporter describes the symptom after finishing a race and entering the next one, entering the version as 2.2c. The thread contains no diagnosis or fix. It does not justify blaming an NVIDIA driver simply because the reporter used an NVIDIA GPU.

Can I disable Classic Grand Prix and restore intermission routes in MKW-THWOMP?

The 0.2.2c reporter says Classic Grand Prix appears always enabled without a way to deactivate it. The thread contains no resolution. Its comparison points you toward upstream's Hacks setting if that choice determines whether you want to use the fork.

Is there a Mario Kart World decompilation?

The Recomp directory lists two static recompilations and no tracked decompilation. That is the directory's coverage, not proof that no other project exists. MKW-THWOMP translates game code for PC execution; calling it a recovered, human-written source tree would misdescribe what it does.

How can I contact the maintainer to discuss ideas and contribute a pull request?

In issue #1, a contributor asked for Discord contact and offered a pull request. The closed thread has no recorded reply, so it provides no confirmed private contact route. The README links contribution guidance; use that guidance rather than treating the requester's posted Discord username as the maintainer's.

What we have not tested yet

Our checks cover repository commands and a failed package-registry attempt, without a recorded Windows game session or a completed race.

We have not tested either release package, dump preparation, graphics output, controller behavior, intermission routes or the Duo workaround ourselves. The November 21 run description calls its PyPI attempt an installation, but the failure log prevents that interpretation. Our harness's Python classification describes the tooling check, while GitHub identifies C as the primary repository language. Neither label changes what the game-session reports actually show.

The RTX 3080 report is one person's approximate free-roam result. Race frame times, different graphics cards, long sessions, local multiplayer, LAN play, mods and memory use during play remain unmeasured here. The video transcripts we checked contain no attributable, detailed setup or performance result that can fill those gaps. We have no security audit or observed update-download trace. The release notes say personal settings, dumps, caches, saves and logs are excluded from packages; that statement is not an independent inspection.

The next useful test is the documented Windows setup with an owned dump, followed by a complete Grand Prix transition and a repeatable controller check. Keep its logs separate from the repository harness so a passing dependency step never becomes a claim about a finished race.

Alternatives

ProjectWhat it isPick it when
mkw-recomp gh↗The upstream Mario Kart World recompilation, with documented Linux and Windows execution.Evaluate upstream directly for its platform support or the Classic Grand Prix toggle described by the issue #5 reporter.
kart-recompAnother native Windows and Linux project with a launcher for preparing your own game dump.Evaluate it when you want a different launcher and a documented Linux setup route.

What people are saying

  1. [velocity-scout] STS78721/MKW-THWOMP

Sources

  1. MKW-THWOMP README and project
  2. MKW-THWOMP 0.2.2c release
  3. Linker failure and successful free roam
  4. Duo controller workaround
  5. Loading-screen report
  6. Grand Prix report and upstream comparison
  7. mkw-recomp upstream README
  8. kart-recomp README

More dev tools reviews