Repository navigation
Releases
Super Odyssey PC Recomp 0.2.8 (preview)
Why so many updates?
0.2.5, 0.2.6 and 0.2.7 came out within hours of each other. Sorry about that. 0.2.5 brought the Linux build a start-up problem: when the game couldn't start, it could hang with nothing on screen. 0.2.6 and 0.2.7 were the fixes for it. From now on every release is tested on a fresh install on Windows and Linux before it goes out, so updates should be fewer and bigger. This one is the first.
What's new
Invisible poison fixed (#3)
In the Spewart fight in Wooded Kingdom, Mario took damage from poison that wasn't there. The game checks for poison by reading a texture the graphics card draws, and it was reading stale data. That data is now kept in sync. This fix is for game version 1.0.0; if you see it on 1.4.1, please report it.
Reactive fog on game 1.0.0
The Cap Kingdom fog that ripples around Mario and Cappy (new in 0.2.5 for game 1.4.1) now works on 1.0.0 too.
FSR 3.1, FSR 4 and XeSS (Windows)
Menu > Graphics > Temporal upscaler now offers, next to DLSS:
- AMD FSR 3.1
- AMD FSR 4 (beta): needs a graphics card that supports it. On other cards it falls back to FSR 3.1, and the menu says so.
- Intel XeSS (beta): works on Intel and many other cards.
Each has Native AA, Quality, Balanced and Performance modes and its own sharpness, and you can switch during play. FSR 4 and XeSS are beta: they have only been tested on an NVIDIA card so far, so reports from AMD and Intel cards are welcome. With FSR 4 on its FSR 3.1 fallback, some title-screen text can go missing; choose FSR 3.1 directly if you see that.
New performance overlay
Menu > Performance > Performance overlay is rebuilt:
- GPU use, temperature, power, video memory and clock
- CPU use and the game's share of it
- Memory in use, and the game's own
- FPS, frame time, the slowest recent frame, and a frame time graph
- Graphics card and processor names
- Upscaler, anti-aliasing, and internal and on-screen resolution
- Mario's position (handy for bug reports)
You can switch each part on or off, and choose the corner, size and background. GPU temperature, power and clock need an NVIDIA card, or Linux with an AMD or Intel one (including the Steam Deck). CPU temperature shows on Linux only.
Crash reports
When the game stops with an error, it saves one report file with the log, your settings, and your CPU, GPU and driver. On Windows the error box has a Copy crash report button; on Linux the error window shows the file's path. Please attach this file when you report a crash. It contains no game files, keys or saves, but it can contain folder names from your PC.
Fixes
- Out of video memory (#20): the error box now says the graphics card ran out of memory and suggests a lower internal resolution. Before, it wrongly said you need a Vulkan 1.3 driver.
- Linux: the start-up fixes from 0.2.6 and 0.2.7 are included.
Coming next
- Frame generation for NVIDIA, AMD and Intel cards
- Sharper HUD and menu text
- Graphics options beyond the Switch: shadow resolution, draw distance, level of detail
- Ultrawide polish and variable refresh rate support
- Steam Deck: better performance, a ready-made controller layout, and "Add to Steam" in setup
- Separate camera sensitivity for stick, mouse and gyro, and easier two-player setup
- Open issues:
Updating
Windows: open the menu (F1) > Updates > Download and install, or extract the zip below over your current folder. Your game files, saves, settings and mods stay.
Linux / Steam Deck (experimental): the game updates itself from the menu, or download the AppImage below, make it executable and start it. Setup: docs/linux.md.
Notes
- You need the extracted
exefsandromfsfolders of your own copy of Super Mario Odyssey (1.0.0, or 1.4.1 with the update applied). Nothing of the game is included. - The Windows zip is larger because it now includes AMD's and Intel's upscaler files. They load only if you choose FSR or XeSS.
Super Odyssey PC Recomp 0.2.7 (preview)
A small Linux fix on top of 0.2.5; see there for everything new in this update.
Fixes
- Linux: errors at the first start always show a window. If the game can't start, for example because there's no Vulkan graphics driver, it now shows the error in a plain window of its own: what went wrong, what to install, and where the log file is. A click or Enter closes it. Before, the error box could hang without appearing (0.2.5), or be missed by some desktops and tools (0.2.6).
Windows is unchanged apart from the version number.
Updating
Windows: open the menu (F1) > Updates > Download and install, or extract the zip below over your current folder. Your game files, saves, settings and mods stay.
Linux / Steam Deck (experimental): the game updates itself from the menu, or download the AppImage below, make it executable and start it. Setup: docs/linux.md.
Notes
- You need the extracted
exefsandromfsfolders of your own copy of Super Mario Odyssey (1.0.0, or 1.4.1 with the update applied). Nothing of the game is included.
Super Odyssey PC Recomp 0.2.6 (preview)
A small Linux fix on top of 0.2.5; see there for everything new in this update.
Fixes
- Linux: no more silent hang when the game can't start. If the game hit an error before its window opened, for example with no Vulkan graphics driver, it tried to show an error box through zenity. On some systems zenity never shows up, so the game kept running with nothing on screen. It now shows its own error box every time. The box says what went wrong, and for driver problems that the game needs a Vulkan 1.3 driver.
- The README now has the app's name as its title.
Windows is unchanged apart from the version number.
Updating
Windows: open the menu (F1) > Updates > Download and install, or extract the zip below over your current folder. Your game files, saves, settings and mods stay.
Linux / Steam Deck (experimental): the game updates itself from the menu, or download the AppImage below, make it executable and start it. Setup: docs/linux.md.
Notes
- You need the extracted
exefsandromfsfolders of your own copy of Super Mario Odyssey (1.0.0, or 1.4.1 with the update applied). Nothing of the game is included.
Super Odyssey PC Recomp 0.2.5 (preview)
What's new
Reactive fog in Cap Kingdom
The fog sea in Cap Kingdom now reacts to Mario, Cappy and the camera with ripples and waves, as on the Switch. The game measures the fog's surface by reading a texture on the CPU that the graphics card draws. That value now comes back from the GPU, so ripples are no longer rejected as "too far from the surface".
Lower memory use
- Shaders are now prepared when they're first needed, not for everything an area loads. In Cascade Kingdom on Windows, memory use drops from 11.2 GB to 9.4 GB.
- New Menu > Performance > Shaders > Memory use: Auto (default), Normal or Low.
- Low prepares each shader the first time it's drawn: about 5 GB, with a short stutter the first time an effect appears.
- Auto picks Low on PCs with less than 12 GB of RAM.
- The game itself still needs about 3 GB plus what's on screen, so 4 GB of RAM isn't enough. The menu tells you so.
Choose your monitor (#8)
Menu > Display > Monitor lists every connected display by name and resolution, plus Current display. The game moves to the one you pick, and your choice is saved. It also notices when a display is plugged in or removed.
Better DLSS
- DLSS now actually runs on normal installs. It needs the game's camera every frame, and before this only debug builds supplied it, so DLSS was quietly skipped.
- Proper temporal sampling. Each frame is shifted by a tiny offset that DLSS uses to rebuild detail. Only the 3D scene is shifted, not shadows or the HUD.
- Sharper textures. Texture detail is chosen for your output resolution, not the lower internal one.
- Two sharpening controls: DLSS's own sharpening (RCAS), and the optional CAS on top. FSR 1 keeps its own slider.
- Switch DLSS modes during play, without restarting.
Smoother motion controls
- Opening or closing the menu no longer feeds the game a sudden jump in controller tilt, which could count as a shake and throw Cappy.
- After a menu, a save load or a kingdom change, the gyro settles for a moment first.
- The gyro also learns its own small drift while the controller rests, but never during real turns or shakes.
Fixes
- Opening cutscene crash at 120 FPS (#18): the new-game opening now gets the same setup for extra frames as stages and kingdom flights.
- Point sprites: effects drawn as points get the right maximum size.
- Linear textures: textures the game reads row by row now use the Switch's row alignment.
Being worked on
We're testing these locally before the next update:
- FSR 3.1 / FSR 4 and XeSS upscaling. FSR 3 is in progress now.
- Frame generation for NVIDIA, AMD and Intel cards.
- More DLSS quality work.
- Sharper HUD and menu text.
- A graphics sweep through every kingdom with a 100% save, looking for other effects broken the way the fog was. This includes the invisible poison in the Spewart fight (#3), which is probably the same kind of problem.
- Even lower memory use for 8 GB PCs.
- Open issues:
Updating
Windows: open the menu (F1) > Updates > Download and install, or extract the zip below over your current folder. Your game files, saves, settings and mods stay.
Linux / Steam Deck (experimental): download the AppImage below, make it executable and start it. Setup: docs/linux.md.
Notes
- You need the extracted
exefsandromfsfolders of your own copy of Super Mario Odyssey (1.0.0, or 1.4.1 with the update applied). Nothing of the game is included. - The reactive fog needs game version 1.4.1. If it causes trouble, start the game with the environment variable
ODYSSEY_FOG_CPU_READBACK=0to switch it off.
Super Odyssey PC Recomp 0.2.0 (preview)
What's new
Linux and Steam Deck (experimental)
A Linux version, as one AppImage that runs on SteamOS and on desktop distributions. It's experimental: much less tested than Windows, so please report what you find.
- Steam Deck: install once in Desktop Mode, choose a folder on the SD card for the game data, shaders and saves, then add the AppImage to Steam and play from Gaming Mode.
- On a Steam Deck the game starts with battery saver settings (75% resolution with FSR 1, 60 FPS). Cap Kingdom runs at 53–60 FPS on an LCD Deck.
- Building the game code on the Deck takes about 20–25 minutes, once.
- Setup and details: docs/linux.md.
90 FPS
Menu > Performance > Frame rate is now 60, 90 or 120 FPS, on Windows and Linux. Gameplay still runs at the game's own 60; 90 and 120 draw extra frames in between. Use them with a screen that refreshes that fast (90 Hz: Steam Deck OLED). If your PC can't keep up, gameplay now stays at full speed instead of slowing down.
Motion controls
Shake the controller to throw Cappy at a target, spin him, and do the game's other motion moves, with the controller's gyro and accelerometer (PlayStation, Switch Pro Controller, Joy-Con). Menu > Controls > Motion controls switches them off.
Xbox and PlayStation button icons
The game's button icons now match your controller: Xbox (A B X Y, LB RB LT RT) or PlayStation (✕ ○ □ △, L1 R1 L2 R2), following your button bindings. They switch on the fly as you change between keyboard and controllers, and with two controllers connected, the one you press a button on takes over. Menu > Controls > Button prompts can fix them to Keyboard, Switch, Xbox or PlayStation.
Much lower memory use
Preload area shaders made the graphics driver keep shaders for everything an area loaded, most of them never drawn, and the driver never frees them. On Windows this reached tens of GB of RAM (#7). It's now off by default, and when switched on it stops at a quarter of your RAM or 8 GB. Without it the game uses about 10 GB on Windows instead of 48.
Fixes
- Textures the game changes in a few spots (such as the poison's paint map) are now always updated on screen. This may fix damage from invisible poison in the Spewart fight (#3); if you still see it, please comment on that issue with your log.
Updating
Windows: open the menu (F1) > Updates > Download and install, or extract the zip below over your current folder. Your game files, saves, settings and mods stay.
Linux / Steam Deck: download the AppImage below, make it executable and start it.
Notes
- You need the extracted
exefsandromfsfolders of your own copy of Super Mario Odyssey (1.0.0, or 1.4.1 with the update applied). Nothing of the game is included. - If you switched Preload area shaders on yourself, your settings keep it on; the new limit applies either way.
Super Odyssey PC Recomp 0.1.1 (preview)
What's new
Mouse camera
The mouse now turns the camera. While you play, the pointer stays in the window; it's free again when you open the menu (Esc) or switch to another window.
- The camera follows the mouse directly, so a quick movement turns it as far as your hand went instead of being limited to a controller stick's top speed.
- Menu > Controls > Mouse: switch it on or off, set the sensitivity (25–400%), or invert up / down.
Keyboard and mouse button prompts
The game's button icons now match what you play with:
- After you press a key or move the mouse, they show the keys you bound (K, J, Q, Enter...), WASD for moving and a mouse for the camera. Rebinding a key updates its icon.
- After you press a controller button, they show the controller's buttons again.
- Menu > Controls > Button prompts: Auto (follows the device you used last), Controller, or Keyboard and mouse.
- Controller-only players see no change: nothing about the icons is touched until the keyboard or mouse is used.
Updating
Open the menu (F1) > Updates > Download and install, or extract the zip below over your current folder.
After updating, the game code is rebuilt once (a few minutes, on its own) because this version hooks the game's camera input. Your game files, saves, settings and mods stay.
Notes
- You still need the extracted
exefsandromfsfolders of your own copy of Super Mario Odyssey; nothing of the game is included. - The prompts and mouse camera work with the Vulkan renderer (Windows; Linux builds when they come).
Super Odyssey PC Recomp 0.1.0 (preview)
The first public preview of Super Odyssey PC Recomp: Super Mario Odyssey as a native Windows program, built on
your PC from your own copy of the game.
Important
Bring your own game. This download contains no game files, game code, assets or keys. You need the extracted
exefs and romfs folders of your own copy of Super Mario Odyssey (1.0.0, or 1.4.1 with the update applied).
No keys are needed.
How to install
- Download
Super.Odyssey.PC.Recomp-0.1.0-windows.zipbelow and extract it anywhere you own (not Program Files). - Start
SuperOdysseyRecomp.exe(it isn't code-signed: on "Windows protected your PC" choose More info >
Run anyway). - Choose the folder with your game's
exefsandromfs, and where to install, then press Install.
Shaders are compiled once during the install (several minutes). - Press Play.
In this version
- Installer that takes your game's extracted
exefsandromfsfolders - Every shader compiled at install time
- Versions 1.0.0 and 1.4.1
- Up to 4x resolution, NVIDIA DLSS / DLAA, AMD FSR 1, SMAA, ultrawide, 120 FPS (experimental)
- Settings menu (F1) with Display, Graphics, Performance, Audio, Controls, Mods and Updates
- Built-in updates: later versions can be installed from the menu (F1 > Updates)
Known issues
This is a preview - see Known issues in the
README. In short: 1.4.1 and native 120 FPS are less tested, a rare effect can still stutter once, online features and
code mods don't work, and Windows Defender may wrongly flag the unsigned program.
Please report problems as an issue with your
SuperOdysseyRecomp.log.
A fan project, not affiliated with or endorsed by Nintendo.