Repository navigation
Odyssey Recomp 0.2.5
A native PC port of Super Mario Odyssey (version 1.0.0) by static recompilation, for Windows (x64) and
Linux (x64, Steam Deck).
Updating from 0.2.4? Open the launcher: it downloads 0.2.5 by itself and shows "Update 0.2.5 ready - restart
now". One click and you're on the new version, with your saves, settings and mods kept. From this version on,
updates download in the background as soon as the launcher sees them; you only press Restart. Linux too.
You need your own copy of the game. This download contains no game files, no game code and no Nintendo assets:
on the first start you choose the folder with your own extracted game (exefs and romfs, version 1.0.0), and the
game code is recompiled on your PC.
What's new in 0.2.5 (from your reports)
Thank you for every report on GitHub, RecompLauncher and Reddit.
Shaders: all of them, before you play
- The shader precompile now covers every shader in the game. "The shader precompile doesn't load them all": that
was right. 0.2.4 prepared the material shaders only (12,820). 0.2.5 reads every shader archive of the game: effects
(particles, sparkles, smoke), sky, clouds, shadows, fog, HDR and post effects, the HUD and menus, and the engine's
own screen passes. That's 20,069 shaders before the first start. It runs once (about 2 minutes) and is cached. - Pipelines from every stage. We ran through all 197 stages of the game (kingdoms, sub-areas, bosses, 2D
sections, Moon, Mushroom) and the list of what they draw ships with the game: 9,177 pipelines (4,092 in 0.2.4)
built ahead of their first draw, from your very first play. - In our test (4 kingdoms from an empty cache), draws skipped for a frame (flickering or missing objects) went from
63 to 6, and pipelines put together during play from 277 to 179.
Fixes
- Warping between checkpoint flags on the map works with the mouse (GitHub #16). The mouse moves the camera,
which on the map zooms it, so the cursor never stayed on a flag. With the map open, the mouse now moves the map's
cursor and left click warps. (Controller and keyboard: as before, move the cursor onto a flag and press A / K.) - AMD handhelds (ROG Ally, GitHub #14): the graphics driver itself crashed while building shaders. If the game
crashes inside the graphics driver, it now switches that driver to the standard way of building shaders from the
next start (until the driver is updated). - "Zig AccessDenied" while building the game code (GitHub #17): usually an antivirus holding a file. The build
now retries with fewer jobs instead of failing. - Easy Setup (GitHub #18): choosing the game folder the app already copied no longer says the files weren't found.
Linux
- Updates inside the launcher on Linux too, downloaded by themselves.
- Crackly sound (GitHub #15): PulseAudio is now tried first, then PipeWire, then ALSA, unless you set
SDL_AUDIO_DRIVERyourself. - RecompLauncher on Linux: the launcher can install and start the Linux version. A fresh install keeps its files
(game data, saves, settings) in the game's own folder, like on Windows. If you already have 0.2.4's files in
~/.local/share/odyssey-recomp, they stay there and keep being used. Odyssey Recomp-0.2.5-linux-x86_64.tar.gz: extract it anywhere and runOdysseyRecomp.sh. Needs glibc 2.35 or newer
(Ubuntu 22.04, Debian 12, Fedora, Arch, SteamOS ...), a Vulkan driver, X11 or XWayland.
Not done yet
- Support for the game's 1.4.0 update (only 1.0.0 for now).
- The first frames after entering a new kingdom can still take 100-250 ms (GPU work at the scene's start).
Please keep reporting (GitHub issues, with OdysseyRecomp.log from the game's folder). It helps a lot.