whatisgithub

What is odysseylocalcoop?

gudui/odysseylocalcoop — explained in plain English

Analysis updated 2026-05-18

3C++Audience · generalComplexity · 4/5Setup · moderate

In one sentence

A Ryujinx mod for Super Mario Odyssey 1.0.0 that adds a real second player so two people can play together on one screen.

Mindmap

mindmap
  root((Odyssey Local Co-op))
    What it does
      Adds a second Mario player
      Shared camera for both players
      Recovery bubble system
    Tech stack
      C++
      ExLaunch
      Ryujinx
    Use cases
      Play Mario Odyssey with a friend locally
      Track separate coin and moon scores
      Run on real Switch hardware
    Audience
      Gamers
      Emulation hobbyists
      Modders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Play Super Mario Odyssey 1.0.0 as a real two-player local co-op experience on Ryujinx.

USE CASE 2

Configure a second player's costume, camera behavior, and recovery settings through settings.ini.

USE CASE 3

Track separate coin and moon collection scores between two players using the optional scoreboard.

USE CASE 4

Try the mod experimentally on real Switch hardware using Atmosphere.

What is it built with?

C++ExLaunchRyujinx

How does it compare?

gudui/odysseylocalcoop4brm01/picture-pokerbong-water-water-bong/npu-gpu-cpu
Stars333
LanguageC++C++C++
Setup difficultymoderateeasyhard
Complexity4/51/55/5
Audiencegeneralgeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a legally owned copy of Super Mario Odyssey 1.0.0, Ryujinx, and two configured controllers.

License terms are not described in the shown README, check the repository's license file for exact terms.

So what is it?

Odyssey Local Co-op is a mod for the Nintendo Switch game Super Mario Odyssey that adds a real second playable character so two people can play the game together on one shared screen. It is strictly a local, same-screen mod, not an online multiplayer feature, and it only works with version 1.0.0 of the game. The mod gives the second player their own full Mario style character, shown in a distinct green costume that can be changed through a settings file, and both players get their own controller. The camera automatically adjusts to keep both players in frame, zooming out as they move apart and accepting camera control input from either controller. If a player falls or gets separated, a recovery bubble carries them back toward their partner. There is also an optional coin and moon collecting scoreboard that tracks each player's score separately, though it is turned off by default because some scoring situations are still being worked out. This is an early alpha release, so the project recommends backing up save files first and warns that some game behavior may differ from the normal single player experience. It is built and tested primarily for use with Ryujinx, a Switch emulator, though it has also been tried experimentally on real Switch hardware. To install it, players download a release package, verify it, and run an install script that copies the mod files into the correct folder, backing up anything it would overwrite. Technically, the mod works by hooking into the game's existing systems for the first player and creating a second, fully native player actor rather than faking a second character. It reuses the game's own logic for movement, camera behavior, and recovery wherever it can, and only changes the parts of the game that assume there is just one player. The project is written in C++ and includes a troubleshooting guide and a known issues list for people who run into problems.

Copy-paste prompts

Prompt 1
Walk me through installing OdysseyLocalCoop on Ryujinx using its install.ps1 script.
Prompt 2
Explain how the shared camera system in this mod keeps two players in frame.
Prompt 3
Help me troubleshoot why the second player is not appearing after installing this mod.
Prompt 4
Show me how the settings.ini file controls the recovery bubble and competition scoreboard.

Frequently asked questions

What is odysseylocalcoop?

A Ryujinx mod for Super Mario Odyssey 1.0.0 that adds a real second player so two people can play together on one screen.

What language is odysseylocalcoop written in?

Mainly C++. The stack also includes C++, ExLaunch, Ryujinx.

What license does odysseylocalcoop use?

License terms are not described in the shown README, check the repository's license file for exact terms.

How hard is odysseylocalcoop to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is odysseylocalcoop for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.