This is a fix release with 33 fixes; details below.

What changed

  • Full screen: games with a community full-screen patch use the patch; a few games without one use S2Arm's own full screen (coverage is growing).
  • iPhone: each game's settings in the library (and the gear menu in game) add "Sound → Game volume" with five levels — mute, 25%, 50%, 75%, 100% — remembered per game and applied immediately in game, so you can turn the game down while listening to music.
  • iPhone: the screen stays on while a game is in front, so cutscenes and external displays no longer lock the phone; auto-lock works as usual again once you're back in the library or quit.
  • iPhone: the save backup and restore page adds "Quit". Use it when you only wanted a backup — next time S2Arm opens straight into the game instead of this page (it's hidden while a restore is unfinished).
  • iPhone / iPad: the settings page now ends with a "Developer & diagnostics" entry (it used to need a long press on the title); on wide screens such as iPad in landscape the settings page is back to two columns.
  • The self-sign export done page now names the .img files you need to copy this time (the rest are the same as last time and needn't be copied again if the phone has them); the first export after an update shows "Checking games to export" game by game instead of looking stuck.
  • Mac: on Macs with a 120 Hz display, the "Auto" frame-rate level of a frame-rate patch now picks 120 fps, so you no longer need to choose it in launch settings (resolves the Mac part of the v0.4.1 note); levels you picked yourself are left alone.
  • Mac controller panel: long controller names no longer break the panel, and licensed Switch Pro controllers that macOS doesn't recognise (read through the fallback path) are now listed.
  • Fixed a black screen at start in some games since 0.4.0 (S2Arm's own full screen wrote a wrong width, even with full screen off).
  • With a game's adaptive full-screen patch and a fixed-aspect full-screen patch both on, the UI no longer misaligns, shows pink blocks, or gets forced into docked mode and drops frames.
  • iPhone: with a full-screen patch and "Frame generation" both on, black bars no longer flash on every other frame.
  • Some games load extra program modules kept encrypted inside the game files, which used to crash. Now the first time a game reaches that point S2Arm keeps the module: on Mac it works from the next launch; on iPhone it is added the next time you use "Update S2Arm on iPhone" in the desktop launcher. The Mac launcher does this automatically while it's open and the iPhone is connected (program only — game files and saves are untouched; it waits if a game is being played on the phone).
  • Some large games crashed at start because they ran out of memory address space: after one such crash, the next launch sizes memory to what the game actually needs and starts normally; oversized records saved earlier are discarded and learned again.
  • Fixed some games quitting right at start (a memory pool the game asked for was larger than the GPU's single-buffer limit).
  • Fixed some games freezing at the same spot again after a GPU hang: the rendering pipeline that caused it is now set aside and skipped next time.
  • Fixed missing objects in some games (draws with an unbound texture slot were skipped entirely).
  • iPhone: on foldable models, motion controls were turned 90° when playing on the inner screen.
  • iPhone: with iCloud saves on, uploading when you switch away from a running game failed every time; it now uploads.
  • The game language menu only offered "Follow system" and English for some games; it now lists every language, so you can pick Chinese on an English system.
  • Putting a game's full .img and its shader update package into "Import Here" together no longer wrongly reports that the phone doesn't have the game, or fails with "couldn't write …"; the update is applied once the game is unpacked.
  • The S-grade card on the export page showed a build hash for libraries made by older versions; it now shows the game version.
  • When pushing a game to iPhone from Mac or Windows, files needed to start the game that are missing on the phone are now pushed again, instead of every reinstall reporting missing files.
  • Windows: building an iPhone package for a game with an FPSLocker frame-rate patch no longer fails as a whole; that patch is skipped (with the reason) and everything else carries on.
  • Windows: fixed "file not found" at the last step of building an iPhone package for some games.
  • Windows: games already unpacked into loose files no longer fail at the unpack step (WinError 1314) without Developer Mode.
  • Windows: unpacking no longer fails when antivirus or indexing briefly holds the folder; it waits and retries.
  • Windows: when changing the library in settings fails, the launcher reconnects to the previous library and shows why under the library row (before, it looked changed and the old library was disconnected).
  • Windows: signing and install errors now name the right cause — the signing server can't be reached, or the iPhone needs pairing again — instead of a generic "check the device connection".
  • Windows: the S-grade upgrade scan now includes the bundled patches. (Thanks @ckuffff, PR #1175)
  • Language fixes: S-grade upgrade buttons are no longer cut off in English, Japanese and French; a Spanish settings button is no longer cut off; the "Update" label on the export page (Japanese, Spanish, French) and the "Import keys" capitalisation (Spanish, French) are corrected; a few leftover Chinese strings in the Japanese interface are now Japanese.
  • When a game has frame-rate patches from several sources, only one set is turned on per level (ones S2Arm has checked come first) instead of stacking them.
  • When a game crashes with patches on: if the crash is in S2Arm's own code, the first time S2Arm no longer turns your patches and cheats off — it just notes it, and only turns them off if it crashes again with the same set. Patches that were turned off automatically are turned back on, with a notice, the first time you start the game after it updates to a new version. (Mac and iPhone)
  • Lower rendering overhead: depth snapshots are no longer rebuilt every frame when a pass alternates between two depth buffers. (Thanks @AlfredChen0418, PR #1007)

Before updating

Back up saves and review migration notes for your installed version. Release notes describe upstream changes, not independent compatibility testing by this site.

Read the full upstream release