Linux Native Clients

This article discusses ways to play the Java version of RuneScape on Linux. Linux isn't an officially supported platform for RuneScape, so we're not able to offer official support for this.


Need help with Linux?
RuneScape runs fine through the browser most of the time on Linux, but sometimes it is better to play through the client to avoid browser related problems or to bypass limitations that the Java Plugin might have.

Thanks to the awesome Linux community in RuneScape there are several ways to run the RuneScape client on Linux. There are scripts just to get up and running and even an unofficial "Client" for Linux/Unix.

Please be aware that some of the clients or crucial files are not available in certain countries due to Legal Reasons.

NOTE: Remember that the Bash Client ShellScripts and the RuneScape UNIX Client are made by other players and are not Officially supported by Jagex!


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 clients 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 are 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.

Get help from the community!           


Was this article helpful?