Skip to content

Using-Jagex-Accounts: include info on quiet launcher settings save failure - #180

Open
leafyboat wants to merge 3 commits into
runelite:masterfrom
leafyboat:jagex-macos-app-management
Open

leafyboat wants to merge 3 commits into
runelite:masterfrom
leafyboat:jagex-macos-app-management

Conversation

@leafyboat

@leafyboat leafyboat commented Aug 27, 2026

Copy link
Copy Markdown

On MacOS, trying to set client arguments fails if the Terminal app doesn't have the correct permissions, and you only notice if you read the terminal output closely afterwards. You get a message like

ERROR n.runelite.launcher.LauncherSettings - unable to save launcher settings!
java.nio.file.FileSystemException: ... -> settings.json: Operation not permitted

This made me run around for a bit trying to get it to work, there was no clear fix. So this updates the wiki on how to use Jagex Accounts by including info on how to notice/bypass this issue

leafyboat and others added 3 commits August 26, 2026 21:44
On macOS the launcher resolves settings.json relative to its working
directory, which for a Jagex Launcher install is inside the RuneLite.app
bundle. macOS 14 blocks writes there, so saving from the Configure window
fails -- silently, since saveSettings() only logs the IOException and
ConfigurationFrame.save() then reports success and closes.

Document the symptom, how to confirm it from launcher.log, and the
App Management workaround, plus a pointer from the launcher configuration
page.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019JUr8EC6SnLs2zBvNGUnFi
@leafyboat leafyboat changed the title Using-Jagex-Accounts: document macOS App Management save failure Using-Jagex-Accounts: include info on quiet launcher settings save failure Sep 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant