RuneLite Launcher Configuration - rmobis/runelite GitHub Wiki
The RuneLite Launcher Configuration window was added in launcher version 2.6.3, released March 5, 2023. To update your launcher please visit the RuneLite website and select to download the setup file for your Operating System then install the launcher using that.
The Configure window can be then opened by selecting the RuneLite (configure)
start menu entry, on Windows, or if using Mac/Linux by passing the command line argument --configure
to the launcher (e.g. on mac, run /Applications/RuneLite.app/Contents/MacOS/RuneLite --configure
in Terminal).
The Configuration Window allows all launcher and client arguments to be configured and saved for use on any subsequent launch. The configuration is also saved in such a way that when launching RuneLite through the Jagex Launcher they are also applied.
- Debug
- Disable TLS verification
- Safe mode
- Disable diffs
- Disable updates
- Client arguments
- JVM arguments
- Scale
- Hardware acceleration
- Launch mode
Runs the launcher and client in debug mode. Debug mode writes debug level logging to the log files.
cli: --debug
Downloads full artifacts for updates instead of diffs.
cli: --nodiff
Disables TLS verification.
cli: --insecure-skip-tls-verification
Disables the launcher self updating.
cli: --noupdate
Launches the client in safe mode. This disables loading of plugins installed from the Plugin-Hub and disables the core GPU plugin.
cli: --safe-mode
Optional arguments passed to the client. One per line.
A popular client argument being profile
to load a specific settings profile on launch.
The profile arg can be supplied with a profile name such as --profile=ironman
to load on client launch the settings profile named "ironman". If this argument is passed with a value that doesn't match the name of an existing profile, a new profile with that name will be created.
cli: --profile=<profile_name>
Optional arguments passed to the JVM. One per line.
This is commonly used to increase the max heap size (the memory limit). This can be done via the -Xmx
option, for example use -Xmx1536M
to double the clients available heap size. Some 3rd party plugins use an unbounded amount of memory, and increasing the max heap size only increases the time until the client crashes. In this case, you will likely need to remove the bad plugin(s).
Scaling factor for Java 2D. For use overriding scaling performed by your Operating System.
Values passed should be in the format of #.#
, 1.0 for no scaling, 2.0 for scaled up to double size, 0.5 for scaling down to half size, and such.
cli: --scale=<VALUE>
Hardware acceleration mode for Java 2D.
- AUTO - lets the launcher set the mode to whatever is default for your operating system
- OFF (Linux default) - disables hardware acceleration
- DIRECTDRAW (Windows default) - enables Direct3D for hardware acceleration (Windows only)
- OPENGL (macOS default) - enables the OpenGL-based pipeline for hardware acceleration
- METAL - enables the Apple Metal API for hardware acceleration (macOS only)
cli: --hw-accel=<OPTION>
- AUTO
- JVM
- FORK
- REFLECT
cli: --launch-mode=<OPTION>