Do I need the original game files to run Super Mario Odyssey Decompilation?

Yes. The project does not include the original game's assets, so you need your own copy.

Super Mario Odyssey Decompilation

DecompilationActive

Source code reconstructed from the original game's compiled binary, so the game can be understood, rebuilt and ported.

Based on Super Mario Odyssey

Image of the original game, Super Mario Odyssey. This project has no screenshots of its own yet.

Super Mario Odyssey (original game, not this project) — Image of the original game, Super Mario Odyssey. This project has no screenshots of its own yet.

Links, repository & details

About

OdysseyDecomp is a work-in-progress decompilation of Super Mario Odyssey 1.0.0. Its purpose is to recreate a source code base for the game from scratch. The README warns that building it will not produce a playable game, and that it will not let you play the game unless you already own it on a Switch.

Getting started

You need the original 1.0 main NSO executable, dumped from a Nintendo Switch following a wiki guide. Install Python, Ninja, CMake, ccache, llvm-objdump, a Rust toolchain and several Python modules, then clone with submodules. Run the setup tool with the NSO path, build with the build tool, and run the check tool to compare results. A VS Code Dev Container and a Nix setup are also supported, and WSL is advised on Windows.

Known issues & limitations

Building the project will not produce a playable game.

What you need to run it

Original game files required. The project ships code only; you provide your own copy of the game (Switch version).

You must already own the game on a Switch.

Status & roadmap

Listed to-dos are comparing different versions and finding the different optimization method used by version 1.3.0.

Credits & contributing

The decompilation uses the sead library project as a reference for the sead library used.

FAQ

What is Super Mario Odyssey Decompilation?: Super Mario Odyssey Decompilation is an open-source decompilation of Super Mario Odyssey. Source code reconstructed from the original game's compiled binary, so the game can be understood, rebuilt and ported. The original game ran on Switch.
Do I need the original game files to run Super Mario Odyssey Decompilation?: Yes. The project does not include the original game's assets, so you need your own copy.