Repository navigation
msr2ds 2.0
msr2ds 2.0 no longer runs on an emulator. The game's code is recompiled from your own dump into native code, and a small 3DS runtime of its own runs it. Nothing of the game is included: you need your own decrypted dump of Metroid: Samus Returns (USA) (.3ds, .cci, .cxi, or compressed .zcci/.zcxi).
The emulator-based version (1.x) is still here: its releases below, and its code on the emu_ver branch.
Downloads
- Windows (x64):
msr2ds-2.0-windows-x64.zip. Unzip it anywhere you can write to and startmsr-native.exe. - Linux / Steam Deck (x86_64):
msr2ds-2.0-x86_64.AppImage. Make it executable (chmod +x) and start it. - macOS (Apple Silicon, macOS 13 or newer):
msr2ds-2.0-macos-arm64.zip. Unzip it, movemsr-native.appto Applications (or anywhere) and open it. The app is not notarized: the first time, macOS refuses to open it; choose Open Anyway in System Settings → Privacy & Security (or runxattr -dr com.apple.quarantine msr-native.app).
First start
- On the Game tab, under Game file, choose your dump.
- Click Build the native code. The first build downloads its tools (about 105 MB) and takes a few minutes, once.
- Click Play. The launcher comes back when the game closes. In the game, F1 or the controller's Select/View button opens the same menu.
Once the native code is built, msr-native-direct.exe (Linux: msr-native-direct.sh; macOS: msr-native-direct.app) appears beside the program: it starts the game straight away, for a shortcut, Steam or a frontend.
Coming from 1.x
2.0 is a separate program with its own user folder: user\ beside msr-native.exe on Windows, ~/.local/share/msr-native/user on Linux (or a user/ folder beside the AppImage), ~/Library/Application Support/msr-native/user on macOS (or a user/ folder beside msr-native.app). The Open the user folder button on the Game tab opens it.
- Saves: Import saves... on the Game tab brings them over: choose the folder of your 1.x copy (or of an emulator, or a Checkpoint or JKSM backup) and confirm. The saves you had are kept in
msr/save-backups. You can also copy them intonative-save/savedatathere yourself, asprofile0,profile1andprofile2. - Texture packs go in
mods/textures, game mods (Citra/Azahar format, Randovania seeds) inmods/game, one folder each.
What's in it
- The single 16:9 screen with the HUD, or ultrawide up to 32:9 in play.
- 30 to 144 FPS, up to 10x internal resolution (4K at 9x), HDR (Windows), bloom and camera zoom.
- Hard Mode from the start, the amiibo galleries and Fusion Mode unlocked, the Fusion suit and cheats.
- Texture packs, game mods and Randovania seeds; quick save and load (F5, F8).
- Keyboard and mouse (WASD, Space to jump, click to shoot, hold right click to aim at the pointer) and controllers, with button icons for Xbox, PlayStation, Nintendo or the keyboard.
- Updates: the launcher tells you when a newer msr2ds release is out and can put it in place itself, keeping your user folder.
Requirements
- A graphics card with Vulkan 1.3 (on a Mac: any Apple Silicon Mac, through MoltenVK, included).
- About 1 GB of free space for the first build.
Not affiliated with Nintendo. Licensed GPL 3.0 or later (the parts from the emulator-based port: GPL 2.0 or later).