Repository navigation
Releases
Odyssey Recomp 0.2.6
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.5? Open the launcher: it downloads 0.2.6 by itself. Press Restart and you're on the new
version, with your saves, settings and mods kept.
You need your own copy of the game. This download contains no game files, no game code and no Nintendo assets.
What's new in 0.2.6 (from your reports)
Thank you for every report on RecompLauncher and GitHub. We read all of them, and every log.
A new shader system
- Much faster. Your logs showed shader preparation taking 1 to 19 minutes. It prepared all 20,069 shaders in the
game, but the game only ever draws about 3,800 of them (we checked by playing through all 197 stages). Now it
prepares exactly the ones the game draws, plus any you've drawn yourself. In our test: 91 s → 21 s. - Much smaller. Everything now lives in one compressed file instead of 36,000 small ones. 3.1 GB → 453 MB.
The old cache is deleted for you on the first start. - The same smoothness in play. In our test through four kingdoms, play was exactly as smooth as 0.2.5.
- A new loading screen. When you press Play, you see what's happening, how many shaders, a progress bar and the
time left. It only appears after installing, an update or a new graphics driver. Otherwise the game starts in
seconds.
Higher frame rates
- Frame rate: 60 / 120 / 180 / 240 / Match display. The extra frames aren't blended pictures: each one is drawn
again by your GPU from the game's state at that exact moment. The game's own logic stays at 60, as on the Switch. - You get at most as many frames as your display shows (144/165 Hz: 120). If your GPU can't keep up, it steps down
(240 → 180 → 120) instead of stuttering.
Motion controls
- Motion sensitivity slider in Controls, lower by default (60%). Rumble no longer throws Cappy by itself (#19).
- Shaking during the death screen no longer fires a burst of throws after you respawn (#19).
- Joy-Con pair: a flick of one Joy-Con is a normal throw, not a spin throw (#19).
- Steam Controller and other gyro sources (#21): the game reads motion from a DSU server (cemuhook protocol), such
as sc2dsu, BetterJoy or DS4Windows, when your controller has no gyro of its own. It's on by default
(127.0.0.1:26760). - PlayStation, Switch Pro, Switch 2 Pro, Joy-Con and Steam Controller gyro work directly through SDL.
Steam Deck and settings
- Steam Deck: it now starts at 720p internal resolution (its screen is 800p). Before, the game rendered at
1080p and ran at 13-55 fps. 720p is back in the menu as "720p (handhelds)". - More settings on the RecompLauncher page: frame rate, motion controls, mouse sensitivity, 720p.
Not done yet
- Support for the game's 1.4.0 update.
- We couldn't test on a 180/240 Hz display, a Steam Deck or a real Steam Controller. Please tell us how they run
(GitHub issues, withOdysseyRecomp.log).
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.
Odyssey Recomp 0.2.4
A native PC port of Super Mario Odyssey (version 1.0.0) by static recompilation, for Windows (x64) and, new in
this release, Linux (x64, Steam Deck).
Updates now come to you. From 0.2.4 on, the launcher checks for a new version itself and installs it with one
click (your saves, settings and mods stay) - no more downloading every release from GitHub by hand. This is the last
one you need to download yourself.
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.4 (from your reports)
Thank you for every report on RecompLauncher and GitHub, and for the logs: they showed us where the stutter comes from.
Less stutter: shaders and pipelines built ahead
- Pipelines built before they are needed. Before, the game compiled its shaders before the first start, but the
pipelines (a shader together with how it is drawn) were still put together the first time something appeared, and
anything that wasn't ready yet was skipped for a frame: the hitches entering a new place, and objects that
flickered or went missing. Now every pipeline the game draws with is remembered, and is built before its first draw
next time. A list from our own run through every kingdom ships with the game, so this works from your very first
play. In our test - a run through all 14 kingdoms from an empty cache - pipelines put together during play went
from 13,139 to 2,696, and draws skipped for a frame (flickering or missing objects) from 3,160 to 1,841; in the
Sand Kingdom from 151 to 2. - Older AMD GPUs (RX 580 / 570 / 550, Vega integrated graphics): the shader preparation did nothing on these
drivers before. It now builds every known pipeline into the driver's cache before the game starts. - AMD handhelds (Z1 Extreme / ROG Ally): the driver rejected every saved shader, so they were all compiled again on
every start. That is now detected and switched off for the driver, and the shaders are cached another way. - Effects (particles, sparkles, smoke) that the game sets up at start are built ahead too.
Controls
- Motion controls (gyro). PlayStation, Switch Pro and Steam controllers drive the game's motion moves: the motion
cap throws (homing, up, down, spin) and the roll boost. No gyro (Xbox controller, keyboard)? The new Shake
binding in Controls (keyboard R by default; bind it to any controller or mouse button) does the shake (GitHub #7). - Two-player mode. The game's own: connect a second controller and it plays Cappy.
- Mouse camera: sensitivity now goes up to 1000%, and a fast flick turns the camera faster than a stick can
(before, it stopped at the stick's top speed; GitHub #10).
Picture
- No more grid of dots around lights at high internal resolutions (GitHub #4, #11): the glow around lamps, coins
and embers is round and smooth again, and the speckles in the night sky are gone. The small glow images were scaled
up with the rest, and the game's blur skipped pixels in them; they now stay at the game's own size.
Crashes and setup
- Integrated GPUs (Intel Iris Xe / UHD, AMD Radeon iGPUs): the game now starts at 1080p internal resolution unless
you chose one. If the graphics memory runs out, the game lowers the internal resolution for the next start and tells
you so, instead of the bare "vmaCreateImage failed: -2" (GitHub #9). - A rare crash at start-up (reading the touch screen's memory) is fixed: the game could be handed memory that
wasn't its own. - Updates from inside the app: the launcher tells you when a new version is out ("Update ... is out - install
it" at the top) and installs it in place, then starts the new version (Windows; your saves, settings and mods stay).
Through RecompLauncher, an update no longer copies your game files again.
Linux (new)
Odyssey Recomp-0.2.4-linux-x86_64.tar.gz: extract it anywhere and startOdysseyRecomp.sh. The first start asks
for your game folder and builds the game code, as on Windows. Your files (game data, saves, settings) live in
~/.local/share/odyssey-recomp.- Needs glibc 2.35 or newer (Ubuntu 22.04, Debian 12, Fedora, Arch, SteamOS ...), a Vulkan driver (Mesa or NVIDIA),
and X11 or XWayland. Steam Deck: in desktop mode, addOdysseyRecomp.shto Steam as a non-Steam game. - This is the first Linux build: please tell us how it runs (GitHub issues, with
OdysseyRecomp.logfrom
~/.local/share/odyssey-recomp).
Known issues (not fixed yet)
- The first frames of a new scene (entering a kingdom, after a fall) can still take a moment.
- Videos (the move tutorials) play choppy for some players.
- Glitches some AMD / Intel GPUs show
(colored squares, the bottom and right edges, fog), flicker with 120 fps on: we can't reproduce these on our PC yet. - Only game version 1.0.0 runs (no updates).
Help us fix the rest
Please open an issue on GitHub (https://github.com/rwwo8/OdysseyRecomp/issues) with:
- the log:
OdysseyRecomp.login the game's folder (from RecompLauncher:%APPDATA%\com.recomplauncher.app\game-output\odysseyrecomp.log) - your GPU and driver version, resolution, Internal resolution, frame limiter (60 / 120 fps), window mode
- where it happens (kingdom / place), and a screenshot if it's visual
Install (Windows)
- Extract the zip into a folder you can write to (Documents or Desktop, not Program Files).
- Start
OdysseyRecomp.exe. SmartScreen may say "Windows protected your PC" (the program isn't code-signed):
More info, then Run anyway. - Choose your game folder; setup copies what it needs (about 6 GB) and builds the game code (a few minutes, once).
- Press Play. The first start prepares the shaders (about a minute, Starting... on the Play button).
Updating from 0.2.3: extract over your old folder, or into a new one and choose your game folder again. Your saves are
in the save folder.
Requirements
Windows 10 / 11 (x64), a CPU with AVX2, a GPU with Vulkan 1.3 and a current driver, 8 GB RAM (16 GB recommended),
about 7 GB free disk space.
This is a fan project, not affiliated with or endorsed by Nintendo. Super Mario Odyssey is a trademark of Nintendo.
Odyssey Recomp 0.2.3
A native PC port of Super Mario Odyssey (version 1.0.0) by static recompilation, for Windows (x64).
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.3 (from your reports)
Thank you for every report on RecompLauncher and GitHub. This update fixes what we could reproduce and measure.
- Wooded Kingdom: no more invisible purple goo. At the Sky Garden, Mario was hurt again and again by poison that
wasn't on screen. The game draws the goo on the graphics card and then reads that picture to decide where Mario gets
hurt, and that picture never reached the game. Now it does: in our tests the game's poison map matches what is drawn,
and the "phantom" poison is gone. This should also fix damage from the white flower platforms and the hits during
the Broodal fight there. Please retest the Sky Garden and tell us if anything still hurts where it shouldn't. - Exit to Desktop works with a controller. After pressing it, the controller's cursor was lost and you had to use
the mouse for the last button. It now lands on "Yes". - Easy Setup in RecompLauncher. The release now carries
recomplauncher.json: RecompLauncher checks that your
copy is version 1.0.0, sets the game up from your game folder by itself, and shows its main settings (internal
resolution, 60 / 120 fps, display mode, FSR, SMAA) on the game's page. - Better crash reports. When the game stops because of an error, the report now ends with the list of mods that
were on, so we can tell when a mod made for another game version is the cause.
Known issues (not fixed yet)
- Videos (the short move tutorials) play choppy for some players. We measured that decoding is not the cause
(about 1 ms a frame); we are still looking. - Shader hitches: the first time an area or effect appears, the graphics driver builds it - a short stutter,
then it's cached. - Glitches on AMD, Intel and RX 580 GPUs (colored squares or blocks, flickering), grid-like dots around lights
at high resolutions, flicker with 120 fps on, drops in some open areas, puddle colours in the Wooded Kingdom: we
can't reproduce these on our PC yet. - Only game version 1.0.0 runs (no updates).
Help us fix the rest
Please open an issue on GitHub (https://github.com/rwwo8/OdysseyRecomp/issues) with:
- the log:
OdysseyRecomp.login the game's folder (from RecompLauncher:%APPDATA%\com.recomplauncher.app\game-output\odysseyrecomp.log) - your GPU and driver version, resolution, Internal resolution, frame limiter (60 / 120 fps), window mode
- where it happens (kingdom / place), and a screenshot if it's visual
- whether you have mods in the
modsfolder, and that your game dump is version 1.0.0
Install
- Extract the zip into a folder you can write to (Documents or Desktop, not Program Files).
- Start
OdysseyRecomp.exe. SmartScreen may say "Windows protected your PC" (the program isn't code-signed):
More info, then Run anyway. - Choose your game folder; setup copies what it needs (about 6 GB) and builds the game code (a few minutes, once).
- Press Play. The first start prepares the shaders (about a minute, Starting... on the Play button).
Updating from 0.2.2: extract over your old folder, or into a new one and choose your game folder again. Your saves are
in the save folder.
Requirements
Windows 10 / 11 (x64), a CPU with AVX2, a GPU with Vulkan 1.3 and a current driver, 8 GB RAM (16 GB recommended),
about 7 GB free disk space.
This is a fan project, not affiliated with or endorsed by Nintendo. Super Mario Odyssey is a trademark of Nintendo.
Odyssey Recomp 0.2.2
A native PC port of Super Mario Odyssey (version 1.0.0) by static recompilation, for Windows (x64).
New in 0.2.2: the pause menu (Esc) now shows the project's own icon and name in its top bar.
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.
Install
- Extract the zip into a folder you can write to (Documents or Desktop, not Program Files).
- Start
OdysseyRecomp.exe. SmartScreen may say "Windows protected your PC" (the program isn't code-signed):
More info, then Run anyway. - Choose your game folder; setup copies what it needs (about 6 GB) and builds the game code (a few minutes, once).
- Press Play. The first start prepares the shaders (about a minute, Starting... on the Play button).
Highlights
- Steady 60 fps; optional 120 fps with in-between frames (120 Hz+ display), which never costs a game frame.
- Internal resolution 1080p to 8K, SMAA, AMD FSR 1, sharpening, 16x anisotropic filtering, smooth gradients.
- Ultrawide support, Window / Borderless / Fullscreen.
- Xbox, PlayStation and Switch controllers with matching button prompts; mouse camera and full rebinding.
- RomFS mods from a
modsfolder, toggled in the menu. - A launcher with a Game page to change your game folder or rebuild the game code.
Requirements
Windows 10 / 11 (x64), a CPU with AVX2, a GPU with Vulkan 1.3 and a current driver, 8 GB RAM (16 GB recommended),
about 7 GB free disk space.
Known issues
- The first time an area appears, the driver compiles its shaders: a short hitch, cached afterwards.
- Only game version 1.0.0 runs (no updates).
This is a fan project, not affiliated with or endorsed by Nintendo. Super Mario Odyssey is a trademark of Nintendo.