keepvaibin / nebula

# Nebula
Nebula runs **Super Mario Galaxy** natively on Windows. It translates the game's PowerPC
machine code into C++ ahead of time, compiles that code on your PC from your own copy of the
game, and runs it on a native runtime with a Direct3D 12 renderer and Windows audio and input.
Nebula contains no Nintendo code or assets; you need your own copy of the game.
Download ·
Controls ·
Building from source ·
Architecture
Not affiliated with or endorsed by Nintendo.
## Project status
Nebula is a work in progress. The game is playable from the start, but some areas run below
60 FPS on weaker hardware, some lighting and bloom effects differ from the original, and bugs
remain. See Known issues.
## AI-generated project
Nebula was built with AI coding agents (Anthropic's Claude). The recompiler, runtime,
installer, tests and documentation were written by AI agents and directed, reviewed and tested
by the project's author. The game's own logic, including Mario's physics, is not AI-written:
it is the original game code, translated instruction by instruction by the recompiler.
## How it works
1. **Recompiler** (`crates/`, Rust). Reads the game disc or extracted files, checks that it
 is the supported release (RMGE01, revision 0) and emits C++ for every function in the game
 executable, the HOME Menu module and the audio DSP program.
2. **Runtime** (`runtime/`, C++). Loads the compiled game module and provides what the Wii
 hardware provided: memory, a GX command processor drawn with Direct3D 12, the audio
 interface and DSP, Wii Remote input from keyboard, mouse and controllers, disc and NAND
 storage, and video timing.
3. **Installer and launcher** (`installer/`, C#). `Nebula-Setup.exe` downloads a pinned
 compiler toolchain, compiles the game modules from your copy of the game and installs the
 prebuilt runtime. `Nebula.exe` starts the game; `NebulaSettings.exe` changes settings.
## Features
- Keyboard and mouse, Xbox controllers, the Switch Pro Controller and the Switch 2 Pro
 Controller (USB), remappable. Switch controllers point with the gyro (R recenters) and tilt
 for the Star Ball and ray surfing.
 Vibration follows the game's Wii Remote motor.
- Aspect ratios from 4:3 to 32:9 and internal resolution up to 16x.
- Anti-aliasing (SMAA, FXAA), AMD FidelityFX FSR 1 upscaling, anisotropic filtering and
 optional per-pixel lighting.
- In-game settings menu (F1, View + Menu on Xbox, Minus + Plus on Switch).
- Text speed: dialogue and Rosalina's storybook at the original pace, 2x or 3x.
- The game in English, French or Spanish, the three languages of the USA release.
- Saves stored in `%LOCALAPPDATA%\Nebula\saves`, with export, import and Dolphin saves
 (see Saves).
## Requirements
- Super Mario Galaxy, USA (RMGE01), revision 0, as an ISO, RVZ or extracted folder
- Windows 10 (version 1803 or newer) or Windows 11, 64-bit
- A GPU with Direct3D 12 support
- 8 GB of RAM (Setup also installs on less, as an experimental install at your own risk);
 16 GB of free