Check paths first.

macOS Says The App Is Damaged Or Cannot Be Opened

Download the newest DMG from GitHub releases first. Older packages before v1.2.3 could contain an app bundle whose internal resources were not sealed correctly, so a fresh macOS user account could reject the app even when the developer account opened it.

If the newest DMG still fails, remove the old copy from ~/Applications, reinstall from the DMG with Install to My Applications.command, then open System Settings > Privacy & Security and allow the app if macOS asks. RipperMoonKit is ad-hoc signed for now, not Apple Developer ID notarized.

Update Banner Still Appears After Updating

If the app says an update is available, runs Update From GitHub, relaunches, and still shows the same update, install the newest DMG from GitHub releases.

The v1.2.13.1 app could rebuild from its bundled support source when the local support folder was not a Git checkout. That made the app relaunch the old build even though GitHub had a newer release. v1.2.13.2 and newer fix this by replacing a non-Git support source with a fresh GitHub checkout before rebuilding, and by reading the installed app version from the bundled VERSION file.

If the banner still returns after an update, check for multiple app copies. Older updater builds could install the rebuilt app into ~/Applications while relaunching the old copy from /Applications or a mounted DMG. v1.2.16 and newer always install launcher updates to ~/Applications/RipperMoonKit Launcher.app. Remove stale /Applications copies so Spotlight opens the user-scoped app.

GPTK Shows Missing

Make sure Game Porting Toolkit is installed or mounted. The launcher accepts configured GPTK paths, the Apple app in /Applications, and patched runners under $GPTK_HOME/runners.

Game Opens Then Exits

Install Visual C++ runtime into that profile's prefix from the GUI, or run:

gptk-vcrun --prefix GamePrefix

Steam Download Or Web Runtime Fails

If a Steam download ends with content unavailable, or Steam tries to install a Web Runtime and fails, first confirm the Steam library path is on a mounted writable drive with enough free space. Then repair the Steam prefix compatibility files:

gptk-steam --repair-compat

Restart Steam after repair. If the issue continues, inspect the Steam logs inside the Steam prefix before deleting downloaded data.

Clair Obscur Shows NVIDIA Driver Prompt

Some Windows games see GPTK's compatibility GPU report and show a NVIDIA driver warning. On Apple Silicon, do not install NVIDIA drivers. Use the profile's GPTK/Metal launch options, then change the game's own graphics settings from inside the game.

Clair Obscur WineGStreamer Color Assertion

If the popup references winegstreamer/colorconvert.c, the tested behavior was that ignoring the popup allowed the cutscene and gameplay to continue. If video playback becomes a hard blocker, capture the newest log and compare it with the Clair Obscur tested profile notes.

God Of War Ragnarök Does Not Start

Run the PlayStation PC runtime installer inside the game's prefix first, then launch again. If it still exits, check the log for missing API/runtime lines such as GameInput, Vulkan fallback attempts, or D3D12 feature queries before changing broad runner settings.

Elden Ring ERSC Closes After Golden Pot

If the logs show pipe: Too many open files, eventfd: Too many open files, or NtCreateFile Too many open files even after the launcher reports open-file limit 49152, use the current ERSC profile with esync disabled.

The confirmed fix is to start both Steam and ERSC from the same RipperMoonKit Elden Ring ERSC profile so both use GPTK_WINEESYNC=0. Stop old Wine sessions first:

gptk-steam --kill

If the logs instead repeat getsockname failed in BGetBoundAddr with error: 10022, CSteamEngine::BMainLoop appears to have stalled, or DirectSoundCaptureDevice.lock, Steam was likely already running with a different Wine runner or esync state. Close Steam, start it from the Elden Ring profile, then launch ERSC or ModEngine from that same profile.

Read the confirmed esync descriptor fix report.

Steam Game Cannot See Steam

Start Steam first and launch the game from the same prefix. For ERSC, the tested profile uses the Steam prefix.

Save Files Do Not Appear

Create one fresh save in the game, exit, then copy your backup saves into the exact folder the game just created.

Find Logs

ls -lt "$GPTK_HOME/logs" | head