Skip to content

Odyssey Recomp 0.2.4

Choose a tag to compare

@rwwo8 rwwo8 released this 14 Nov 00:59
· 3 commits to main since this release

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 start OdysseyRecomp.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, add OdysseyRecomp.sh to Steam as a non-Steam game.
  • This is the first Linux build: please tell us how it runs (GitHub issues, with OdysseyRecomp.log from
    ~/.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.log in 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)

  1. Extract the zip into a folder you can write to (Documents or Desktop, not Program Files).
  2. Start OdysseyRecomp.exe. SmartScreen may say "Windows protected your PC" (the program isn't code-signed):
    More info, then Run anyway.
  3. Choose your game folder; setup copies what it needs (about 6 GB) and builds the game code (a few minutes, once).
  4. 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.