Windows, Linux (x86_64 and ARM64), macOS (Apple Silicon) and Android (arm64).
What changed since 2.0.8
Mostly Android fixes, and faster lighting everywhere.
- Android: "Not built yet" with the native code in place (#58, #63). On some devices (an Odin 3 in #58), Android gives a
recomp-androidfolder copied in from a PC an owner the app can't read. The app now makes therecomp-androidfolder itself, so a copy from the PC goes into a folder it owns. If a folder you copied in earlier can't be read, the launcher says so and what to do: delete that folder from the PC, then copy the two files from the PC'srecomp-androidfolder (libmsr_aot.soandmodule.json) into the empty one the app makes in its place. A copy dropped inside the app's folder (recomp-android/recomp-android) is moved up.launcher.logsays what the launcher found. - Android: GPUs without the 32-bit depth format with stencil (#53). These (Adreno 6xx, such as the Adreno 640) now draw with the 24-bit depth format with stencil, the one Azahar uses on them, instead of 32-bit depth without stencil. On an Adreno 640 the game crashed at the first 3D in 2.0.7, at the first use of that depth buffer. This should fix it, but it isn't confirmed on that phone yet. The game's stencil effects work there now too.
- Android: up to 1.1 GB less memory (#66). On GPUs that can't scale a depth image down, the game set aside about 1.2 GB for reading depth back at up to 10x, whatever the resolution. That memory now follows the resolution you play at: about 140 MB at 2x, 270 MB at 4x. Every 2 seconds the log now also says how much memory the game uses and how much the device has left (on Android and Linux).
- Faster lighting (#37). The world's lighting read its whole setup for every pixel. Each material's lighting setup is now built into its shader, as Azahar does it. On a PC's integrated Radeon at 4x, the GPU's time per frame went from 23.1 to 17.9 ms (41 to 53 FPS). Phones should gain too, but that isn't measured on one yet. After the update, each lit effect's shader is built again the first time it appears, so the first minutes may hitch a little.
- HDR: a gentler curve. Highlights now start at 75% of paper white (was 50%) and fade toward white as they brighten. Lit, colored surfaces (the Chozo statues' metal, orange rock, the title's planet rim) went to the display's peak at full saturation and looked neon; now only glare, white-hot spots and glows go bright. Reset HDR to the defaults in the Display tab puts highlights back to your display's peak (up to 1000 nits) and paper white back to Windows' SDR content brightness.
- Long frames in the log. Every frame that takes over 200 ms now adds a line to
msr-native.logsaying where the time went (40 lines at most). If the game freezes for a moment on your PC, that line helps.
If the game is slow on your phone (#37)
A few runs with a test switch show where your phone's GPU spends its time. For each, put that one line in a text file named env.txt in the user folder (Android/data/io.github.gminustwo.msrnative/files/user), play for a minute at the resolution you use, and copy msr-native.log before the next run (each start replaces it):
- no
env.txt(a normal run) PWR_VK_DBG=simplefsPWR_VK_DBG=nolightPWR_VK_DBG=scissor
The picture is wrong in runs 2 to 4; that's expected. Delete env.txt afterward and attach the four logs to #37.
Still planned
For phone GPUs: clears done by the pass that follows, and full-screen effects without a depth buffer. The phone runs above decide what comes first.
Getting it
- Already have 2.0 or later: open msr-native. The Game tab offers 2.0.9: click Update now.
- Windows (x64): download
msr2ds-2.0.9-windows-x64.zip, unzip it anywhere you can write to, and startmsr-native.exe.msr-native-direct.exestarts the game without the launcher, for a shortcut, Steam or a frontend. - Linux / Steam Deck (x86_64): download
msr2ds-2.0.9-x86_64.AppImage, make it executable (chmod +x) and start it. - Linux (ARM64): download
msr2ds-2.0.9-aarch64.AppImageand start it the same way. The native code is built on the device itself. - macOS (Apple Silicon): download
msr2ds-2.0.9-macos-arm64.zip, unzip it, movemsr-native.appto Applications (or anywhere) and open it. The app is not notarized, so 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.
Native code you already built with 2.0 to 2.0.8 stays valid, including the Android app's, so you don't need to rebuild it. New players: choose your game file on the Game tab, click Build the native code, then Play.
Android (experimental)
msr2ds-2.0.9-android-arm64.apk installs over 2.0.8 and keeps its user folder (your game file, native code and saves). Everything in 2.0.2's notes still applies: you need Android 10 or newer on 64-bit ARM with Vulkan 1.1 or newer, and the native code is built on a PC with Build for Android. The app is signed with a debug key and has no in-app update. If it runs slowly or not at all on your device, please attach msr-native.log (and launcher.log, and any -crashed.log) from the app's user folder to an issue.
Requirements for PC and Mac are as in 2.0 (on a Mac, Apple Silicon and macOS 13 or newer). Since 2.0.5, a PC with OpenGL 3.3 graphics also runs the game. You need your own decrypted dump of Metroid: Samus Returns (USA).