Mac Native GamesTHE APPLE SILICON FIELD GUIDE

Project notebook

Mac game updates and rebuild notes

Follow MacNativeGames fixes, graphics and controller changes, and Ship of Harkinian releases. Find the affected version and the next step.

Use the affected version and symptom to decide whether to rebuild, change a setting or keep your current app.

  1. MacNativeGames

    A targeted mitigation for the long-session crash in issue #57

    Affected: Mac players who saw SIGBUS at main+0x1561c after long sessions (issue #57).

    Next step: The author added a guard for one identified stale-reference case. Check whether your build includes e8b5259 and retain logs if it still crashes. The issue remained open on 20 Oct while long-session retests were requested.

    Issue #57 ↗ · Commit e8b5259 ↗

    Investigate the long-session crash →

  3. MacNativeGames

    RomFS mods can add files the game does not have

    Affected: Players using data mods such as The Second Quest (issue #48). ExeFS parts of mods are still not supported.

    Next step: Rebuild, then run make_mod_manifest.py on the mod folder again so new files are listed with “-” as the original hash.

    Issue #48 ↗ · Commit 15b1afd ↗

    Install the mod and create its manifest →

  4. MacNativeGames

    Other genuine retail dumps and merged updates are accepted

    Affected: NSP builders stopped by “ExeFS main.npdm: SHA-256 … is not the expected …” or “BKTR verification failed”.

    Next step: Use the source version in the build guide, then run the same command again. A main.npdm that is neither the pinned file nor Nintendo-signed is still rejected (issue #65, open).

    PR #47 ↗ · PR #46 ↗ · Issue #65 ↗

    Recover from dump or update errors →

  5. MacNativeGames

    build_app.py checks the C++ headers before it starts

    Affected: Macs whose developer tools lack the C++ standard library (issue #41, “’string’ file not found”).

    Next step: Nothing unless the new error appears; then follow its xcode-select hint.

    Issue #41 ↗ · Commit 8b5b428 ↗

    Repair the missing C++ headers →

  6. MacNativeGames

    Remap controller buttons with controls.txt

    Affected: Mac players with a game controller (PR #35). Tap, toggle and aim modes are available.

    Next step: Rebuild, then add a controls.txt if you want a different layout.

    PR #35 ↗

    Create a controller layout →

  7. MacNativeGames

    PlayStation and Xbox face buttons map by position

    Affected: DualSense and Xbox players (issue #10): the right button is now A, as the game’s Switch prompts show.

    Next step: Rebuild. To get the old by-label mapping, launch with TOTK_FACE_BUTTONS=label.

    Issue #10 ↗ · Commit 31052d6 ↗

    Choose position or label mapping →

  10. MacNativeGames

    Starts on macOS 27; long sessions no longer run out of audio decoders

    Affected: macOS 27 Macs that exited at “reserve the 64 GiB alias region” (issue #8) and players who saw “hardware Opus decoder table full” (issue #9).

    Next step: Rebuild using the source version in the build guide.

    PR #11 ↗ · PR #18 ↗ · PR #40 ↗

    Find the launch or audio case →