Exefs & romfs setup guide

How to prepare your Super Mario Odyssey 1.0.0 or 1.4.1 exefs and romfs folders, compile the native game library, and load RomFS mods.

Download v0.2.0 Setup guide

Versions: 1.0.0 & 1.4.1
Keys required: None
Config: powermoon.ini
Menu key: F1 / Esc / Guide

Windows x64 desktop workstation for Vulkan 1.3, DLSS, FSR 1 and ultrawide output

Required game dump layout (1.0.0 or 1.4.1 exefs + romfs)

Simon3Sarkis/super-odyssey-pc-recomp requires the extracted exefs and romfs folders from your own copy of Super Mario Odyssey—either base version 1.0.0 or update 1.4.1. Because the installer reads already-extracted directories, no console keys are needed. Place both folders inside one parent directory with this exact structure:

YourGameFolder/
├── exefs/
│   ├── main
│   ├── main.npdm
│   └── sdk
└── romfs/
    ├── ActionGuideData/
    ├── EffectData/
    ├── EventData/
    ├── LayoutData/
    ├── LocalizedData/
    ├── MovieData/
    ├── ObjectData/
    ├── ShaderData/
    ├── SoundData/
    ├── StageData/
    └── SystemData/

Important for version 1.4.1: If you use update 1.4.1, romfs must be the full merged RomFS (base 1.0.0 RomFS with the 1.4.1 update applied over it), not a patch-only RomFS folder.

Windows 10/11 installation steps (SuperOdysseyRecomp.exe)

Download Super.Odyssey.PC.Recomp-0.2.0-windows.zip (117.2 MB) from Download & SHA-256 and verify its SHA-256 hash.
Extract the ZIP archive to a normal user-writable folder such as C:\Games\SuperOdysseyRecomp (avoid C:\Program Files so the installer can write extracted\, cache\ and save\).
Run SuperOdysseyRecomp.exe.
Click Browse and select the parent folder that contains your exefs and romfs directories (or select either subfolder directly).
Click Install Game. The one-time installer runs four automated stages using its bundled Zig/LLVM compiler:
- Decompresses the Switch NSO binaries (exefs/main and exefs/sdk).
- Lifts the ARM64 functions to C via tools/gen.py, lifter.py and odyssey_patches.py.
- Compiles the native game library (extracted\odyssey_game.dll) on your CPU cores.
- Precompiles all game shaders into cache\ so first-run gameplay does not stutter on shader compilation.
When compilation finishes, click Start Game (or launch directly on future runs). Press F1, Esc, or the controller Guide button at any time to open the settings bar.

Runtime files & RomFS mod folders

On Windows, all runtime files are created directly beside SuperOdysseyRecomp.exe (on Linux, inside your chosen data folder or ~/.local/share/super-odyssey-pc-recomp):

Path	Purpose
`extracted/`	Compiled native game binary (`odyssey_game.dll` on Windows, `libodyssey_game.so` on Linux), generated C sources and extracted assets.
`cache/`	Precompiled Vulkan SPIR-V and pipeline shader cache generated during installation.
`save/`	Local save files for all Super Mario Odyssey profiles. Back up this folder before moving machines.
`mods/`	RomFS mod directory. Each mod lives in `mods/<Mod Name>/romfs/...` and is toggled in `F1` > Mods.
`powermoon.ini`	Runtime configuration file storing your game dump path, resolution scale, upscaler, FPS mode and input bindings.
`SuperOdysseyRecomp.log`	Runtime and diagnostic log file. Press `F9` in-game to dump current frame details to this log.

Alternative: Building coz-0/smo-recomp from source (Windows 1.4.1)

For developers who want to build coz-0/smo-recomp (which targets version 1.4.1 only and outputs a standalone smo_native.exe with the 102-amiibo virtual NFC overlay), install Python 3.10+, CMake 3.24+, Ninja, and Visual Studio 2022 with the C++ Clang Compiler for Windows component, then run:

git clone https://github.com/coz-0/smo-recomp.git
cd smo-recomp
python scripts/setup.py --dump "C:\path\to\your\1.4.1_dump"

That 5-stage pipeline extracts the 1.4.1 dump, lifts all 54,214 AArch64 functions into 258 C shards, translates all 27,888 Maxwell shaders into SPIR-V, compiles the runtime, and links build/runtime/Release/smo_native.exe (typically 15–30 minutes on an 8-core CPU).

Recommended PC controllers

Super Odyssey PC Recomp supports XInput and SDL2 controllers with automatic button prompt switching, plus native gyro motion controls for Cappy spin throws and downward cap throws on DualSense and Switch Pro controllers:

Controller	Best For in Odyssey Recomp	Hardware Advantage	Link
Sony DualSense	Gyro motion throws & SDL2 HID	Built-in 6-axis gyroscope for Cappy motion throws + crisp D-pad	View on Amazon
GameSir Cyclone 2	Precision 3D platforming & gyro	TMR sticks, 6-axis gyro in Switch mode, 1000 Hz wireless dongle	View on Amazon
8BitDo Ultimate 2 Wireless	Windows & SteamOS dock play	Zero-drift TMR sticks, charging dock, Switch/XInput mode toggle	View on Amazon
Xbox Wireless Controller	Plug-and-play Windows 10/11	Native XInput layout with instant button prompt switching	View on Amazon

As an Amazon Associate, this site earns from qualifying purchases.

Sixteenth-century world navigation chart showing twin hemispheres, compass roses and maritime expedition routes — World expedition chart and compass routes echoing the Odyssey globe voyage

Historic brass Mariner’s astrolabe with engraved degree markings and rotating alidade — Precision brass navigation instrument and expedition dial

Macro view of a handheld mainboard PCB and multi-core GPU silicon package — AVX2 CPU and Vulkan 1.3 shader translation pipeline

Common questions

How long does the one-time Install Game step take?

Typically 5 to 15 minutes on a desktop 6-to-16 core CPU, and roughly 15 to 25 minutes on a Steam Deck or 4-core laptop. Once extracted/odyssey_game.dll and cache/ are built, subsequent launches start immediately.

Does the installer modify my original exefs and romfs folders?

No. Your source dump directory is opened read-only; all generated code, DLLs and shader caches are written into extracted/ and cache/.

How do I install RomFS mods?

Create a folder named after your mod inside mods/ with a romfs/ subfolder mirroring the game’s layout (for example mods/CustomCap/romfs/ObjectData/...). Open F1 > Mods before clicking Start Game to enable or disable individual mods.