The GPU plugin requires Windows (7, 8, or 10), MacOS, or Linux, a GPU with support for OpenGL 4.3 or newer, and 2GB of VRAM. This requires either a Nvidia GeForce 400 or newer, an AMD Radeon HD 5000 Series or newer, or Intel HD Graphics with an Intel Haswell processor or newer. Ensure your GPU drivers are up to date.
It is possible there are configurations on which the GPU plugin does not work correctly. In particular, we recommend you do not enable it in dangerous situations ingame (HCIM!) until you sufficiently test whether the plugin is stable on your system.
Exit your client and launch it again to update. Ensure you are using a supported operating system and graphics card (see above). You can then enable the plugin "GPU" on the plugin sidebar.
The plugin will turn off automatically if it is not supported on your current setup. If your system meets the requirements, but the plugin still turns itself off, see the troubleshooting steps below.
Try disabling Hardware Acceleration. Otherwise, make sure your system meets the requirements.
If you have a Nvidia GPU, make sure you are using the 32 or 64 bit version of RuneLite, not the For All Platforms Version. Then go into NVIDIA Control Panel -> Manage 3D settings -> Program settings. Click Add and find RuneLite on the list, add it. In the lower section, find the OpenGL rendering GPU option, and set it to your NVIDIA GPU. When finished, it should look something like this:
If you have an AMD graphics card, roll back the driver to version 18.12.1
If you have an AMD graphics card, roll back the driver to version 18.12.1
If you have an AMD graphics card, roll back the driver to version 18.12.1
Try turning off compatibility mode on the RuneLite launcher, running in Administrator mode, turning off fullscreen optimization, or other Windows compatibility settings.
If you have a program called playstv, turn it off.
If you are on Linux, update Mesa to version 19.1.3 or later.
If you are on Windows, open task manager and kill any jogamp_exe_tst processes twice (they will have random numbers after the tst). This may need to be done during RuneLite startup if the GPU plugin is still set to enabled.
Click distance has been limited to 45 tiles.
90 tiles.
The client will only display loaded regions regardless of draw distance settings.
It is being considered as an improvement, no ETA.
The Orb of Oculus functionality is not part of the GPU plugin.
Try disabling anti-aliasing in your GPU properties and in RuneLite, or reset your GPU properties to default. You can also try disabling any driver settings which override application-specific AA settings, such as those in Nvidia Control Panel.
Run cmd.exe (Windows Key + R) and paste the following into the command prompt:
%localappdata%\runelite\runelite.exe --safe-mode
Once RuneLite fully loads, you can close the client and relaunch as normal; GPU will be disabled.
Run Terminal.app and paste the following into the Terminal window:
/Applications/RuneLite.app/Contents/MacOS/RuneLite --safe-mode
Once RuneLite fully loads, you can close the client and relaunch as normal; GPU will be disabled.
If you are using the AppImage version, open Terminal and run the following, edited as appropriate:
./path/to/RuneLite.AppImage --safe-mode
Once RuneLite fully loads, you can close the client and relaunch as normal; GPU will be disabled.
If you downloaded the .jar version of the launcher, run this:
java -jar Location-of-RuneLite.jar --safe-mode
Once RuneLite fully loads, you can close the client and relaunch as normal; GPU will be disabled.
In Windows Powershell run the following command:
(Get-Content $env:userprofile\.runelite\settings.properties).replace('runelite.gpuplugin=true', 'runelite.gpuplugin=false') | Set-Content $env:userprofile\.runelite\settings.properties
This bug seems to be caused by changes in the Intel graphics drivers. the 27.20.100.xxxx drivers can produce green lines at the time of writing. Downgrading back to the 26.20.100.xxxx drivers seems to be resolving this problem.
Disable Compute Shaders from the GPU plugin options and toggle the plugin off and back on. Use of mining software or video rendering are common GPU compute loads.
Open the Nvidia Control Panel, open "Manage 3D Settings" under the 3D settings group, select "Program Settings", add RuneLite (it can be easily found under your recently-opened programs), apply the following settings, and relaunch RuneLite:
- Monitor Technology: Fixed Refresh Rate
- OpenGL Rendering GPU: Set to your graphics card
- Vertical Sync: Off
This can be caused by multiple things
The launcher will be automatically scaled by Windows if you have scaling in Windows enabled. You can override the amount that the launcher is scaled by passing the --scale argument to the launcher. For example --scale=1.0 will cause RuneLite to not be scaled, even if scaling is enabled in Windows.
Drivers can force certain AA levels or types, and when the GPU plugin is on it will be forced to use those, making the ui look different than normal.
For Nvidia drivers go into NVIDIA Control Panel -> Manage 3D settings for managing its settings
- Set
Antialiasing - FXAAto off - Set
Antialiasing - Modeto Application-controlled
Symptom: GPU driver crash (black screen) when turning on or using the GPU plugin
Solution: Disable hardware acceleration using method 2 found here https://github.com/runelite/runelite/wiki/Disable-Hardware-Acceleration#method-2-starting-the-launcher-with-hw-accel-disabled-from-cmd