Disable Hardware Acceleration

Tomas Slusny edited this page Oct 24, 2018 · 19 revisions

Important! Before attempting the steps below, make sure you have installed the latest RuneLite Launcher! If you are unsure, simply reinstall the launcher.

As of RuneLite Launcher 1.5.1, RuneLite attempts to enable hardware acceleration based on your operating system. If you are having hardware-acceleration issues (such as artifacting) you can disable it by following one of the instructions below.

Table Of Contents

Windows

Method 1: Creating a shortcut

You can create desktop shortcut with "--mode=OFF" (without quotes) at the end of the target box. (Video below)

Client View

Method 2: Creating .bat file

If you are on Windows using the official installer, download and run the link below:

Or copy the text below, save as a .bat file and run.

start "" "%localappdata%\RuneLite\RuneLite.exe" --mode=OFF
exit

Method 3: Starting the launcher with HW accel disabled from CMD

Run cmd.exe (Windows Key + R) and paste this into the command prompt:

java -jar %localappdata%\RuneLite\RuneLite.jar --mode=OFF

macOS

Run Terminal.app and paste this into the command prompt:

/Applications/RuneLite.app/Contents/MacOS/RuneLite --mode=OFF

Linux

Arch Linux

If you downloaded the client via the Arch User Repository (AUR) execute this command:

echo " --mode=OFF" | sudo tee -a /usr/sbin/runelite

Other distributions

Method 1: Creating shortcut for the launcher

If you're using another distribution and downloaded the RuneLite.jar file, you can add an entry to your launcher. Put this into ~/.local/share/applications/runelite.desktop.

[Desktop Entry]
Encoding=UTF-8
Type=Application
Exec=java -jar path/to/RuneLite.jar --mode=OFF
Name=RuneLite
Comment=RuneLite launcher

Replace path/to/RuneLite.jar with wherever you downloaded the file.

Additionally you can run the following command to automatically add the shortcut, although remember to edit the path like previously mentioned.

printf '[Desktop Entry]\nEncoding=UTF-8\nType=Application\nExec=java -jar path/to/RuneLite.jar --mode=OFF\nName=RuneLite\nComment=RuneLite launcher' >> ~/.local/share/applications/runelite.desktop

Method 2: Running launcher directly from the desktop

Open terminal and type:

nano /home/user/Desktop/RuneLite.sh

Replace user with your username, in my case I replaced user with zetix

Desktop Shortcut

This should open up an empty terminal for the RuneLite.sh file we are going to create

In the terminal, type:

#!/bin/sh
java -jar /path/to/RuneLite.jar --mode=OFF

Press ctrl+x to exit, y if asked to save.

Replace /path/to/RuneLite.jar with the directory location your RuneLite.jar is located. In my case, RuneLite.jar was located in my Documents folder.

Run Command

If RuneLite.sh is opening in Text Editor, Open Files > Preferences > Behavior >

Files is your file manager

Under Executable Text Files, Select Run them to run all .sh files, or Ask what to do if you want to choose to run or view all .sh files.

All platforms

If you downloaded the .jar version of the launcher, run this:

java -jar Location-of-RuneLite.jar --mode=OFF

Table of Contents

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.