Linux Native Clients

This article discusses ways to play RuneScape on Linux. 


Need help with Linux?
It's best to play through the Linux Client to avoid browser-related problems or to bypass limitations that the Java Plugin might have.

There are many Linux distributions, so what works on one distribution may not work on another, or even on another version of the same distro.

The Linux download for RuneScape is ready for download on Ubuntu (and similar distributions), this can be picked up from our Download page.

Other players and sources have begun making this option available on other distros, such as Gentoo, and offer both steps and support for this on our Community Tech Support forum.


The Official Windows Client through WINE
The Official client made by Jagex.

  1. Firstly you need to install Wine on your Linux computer. On Ubuntu and Linux Mint this can be done by using the command: sudo apt-get install wine
  2. Then download the RuneScape Client 
  3. Install it just like on Windows.

NOTE: Running the client through Wine is often slower than running it natively.

Limitations: Cannot use more than 1GB heap space for Java (wine limitation) and is slightly slower than native alternatives.
Architecture: 32-bit (can be run with wine on 64-bit but the Client is 32-bit)
Creator/Developer: JAGEX


The RuneScape UNIX Client (RSU Client)
This Unofficial OpenSource Client is written entirely in a script language called Perl. Perl is installed by default on most UNIX platforms.

This Client works on several platforms (both supported and not supported by JAGEX) and acts as a replica of the Windows client but instead use the Java installed on the system and also integrate known fixes needed for common problems users run across when playing on these platforms.

The client uses the jagexappletviewer.jar file from either the official Windows or Mac client by calling java with a set of parameters found in a .prm file located in the clients /share folder.

Inside that same folder is a settings.conf.example file you can rename to settings.conf and later edit to enable/disable functions/fixes or alter the client's functionality (like changing the java version used to run the client).

If JAGEX updates their official clients you will easily be able to update this client too by running the update-runescape-client script.

Requirements/Dependencies (to just run it):

  • Perl
  • Perl-modules
  • Java or OpenJDK
  • grep
  • xterm (not needed if run on windows)
  • wget or curl
  • p7zip-full OR make, g++ and gcc


Extra Requirements/Dependencies if you want to use the Settings Editor, Updater and Launcher:

  • wxperl/libwx-perl/perl-wx

For sound fixes you might want:

  • Either pulseaudio and pulseaudio-utils AND/OR alsa and alsa-oss


Installation instructions:
Open the Terminal (Accessories --> Terminal) and run the command for your distro found in HikariKnight's GitHub page - this page also includes full instructions and further information.

You can now run the client by running the file "runescape" located in


Or you can install the Application menu entries by running the command:


This will add the entries for the client and updater under the Games section in your Application Menu.

Supported Platforms: Linux, Mac, BSD, Solaris, Windows & WINE
Limitations: The message windows that are not in-game are black with black text.
Architecture: 32-bit, 64-bit, SPARC & ARM
Creator/Developer: HikariKnight


Java Wrapper
For those located in texas this is a good alternative for the RSU Client.

HikariKnight have been so nice to write a java wrapper for the browser plugin which will auto-apply the OpenGL fix and tell java to run in client mode if it is available, just like the client does, this means that there is no longer any performance difference between the RSU client and the browser (except the extra resources used by the browser).

You can get and install the java-wrapper here.
NOTE: As of 20.06.2012 the browser fix is considered STABLE for use.


Basic Client ShellScript
Previously there were several bash shellscripts posted on the forums in order to run the RuneScape client on Linux, these were made by Ethoxyethaan, Garage Punk and Mr Pacman. Sadly none of these are available any longer as they have been officially replaced by the RSU-Client. It was these scripts that were used as the base for the RSU-Client and that is why they are mentioned here, for historical reasons.


Troubleshooting Linux Issues
Because how Linux can be set up, on almost any hardware, with many distributions, which may not include drivers or auto updates, a wide variety of issues can occur.

Many Client errors are caused by package incompatibility, so if you're having issues, you should ensure that you have the latest (stable, non-beta) version of your distribution. We'd also recommend sticking with Ubuntu, as the client may not download / run properly on other variants.


Get help from the community!           


Was this article helpful?