Skip to content

msr2ds 2.0

Choose a tag to compare

@fhclimited fhclimited released this 05 Nov 03:37
· 11208 commits to fee14a68f7e7b8d46132352b837957fa34b89b4a since this release

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 start msr-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, move msr-native.app to 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 run xattr -dr com.apple.quarantine msr-native.app).

First start

  1. On the Game tab, under Game file, choose your dump.
  2. Click Build the native code. The first build downloads its tools (about 105 MB) and takes a few minutes, once.
  3. 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 into native-save/savedata there yourself, as profile0, profile1 and profile2.
  • Texture packs go in mods/textures, game mods (Citra/Azahar format, Randovania seeds) in mods/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).