Welcome!

By registering with us, you'll be able to discuss, share and private message with other members of our community.

Sign up now!

Tutorial RuneMate on Linux

Guy who knows things
Joined
Apr 2, 2018
Messages
25
Setting up Rune Mate For Linux users:

Authors notes:

I don't write guides often, well ever.. in fact this is my first one.
That being said I noticed a big lack of Linux installation support; and thus here we are!

Now, I've tried my best to make this as clear and concise as possible so you should just be able to copy the

commends

for every step and paste them into your terminal window.
All should work out fine HOWEVER....

I am using Ubuntu 18.04 x64; but this guide is written using a Terminal interface so it should work for any 64-bit Debian based OS that uses apt-get

With all that said swapping out apt-get with your package manager of choice's syscall should make this guide usable for you.
Example:
Arch based distros replace apt-get update and apt-get install oracle-java8-installer with pacman -syu oracle-java8-installer

Confirmed working OS list:
Ubuntu 17.10 x64
Ubuntu 18.04 x64​


Anyway, lets get to it! but first.....


0.) **BEFORE STARTING**

I have removed OpenJDK and installed Oracle Java prior to this; you can get Oracle Java by running the following commands in a terminal:

sudo add-apt-repository ppa:webupd8team/java
sudo apt-get update
sudo apt-get install oracle-java8-installer

wait for it to do it's thing once it's done you'll begin..


1.) **INSTALLING THE RSU CLIENT**

Next, download the RSU from here: rsu-client/rsu-client
choose the required file depending on your OS version (this guide assumes 64 bit) and save it to your Downloads folder.

Navigate to your downloads folder using your file manager of choice and extract the .run file from the zip file.
Open a Terminal and run:

cd $HOME/Downloads
This will bring you to your downloads folder next run:

sudo ./RSU-linux-x64-installer.run
It will do everything it needs to for you.
[NOTE]: Debian based distributions can simply run the following commands:

sudo add-apt-repository ppa:hikariknight/unix-runescape-client

sudo apt-get update

sudo apt-get install runescape

Once it's completed, move on to..


2.) **INSTALLING RUNEMATE**

First download RuneMate for Linux from the official download page and save it to your downloads folder.
Open up a Terminal and run:

cd $HOME/Downloads
Then run:

chmod +x RuneMate_setup.sh
Finally run:

sudo ./RuneMate_setup.sh
Follow the on screen prompts and you're done!

Once that's completed Launch RuneMate and follow this guide here: Tutorial - How to Use RuneMate Spectre to get started using it

Set up your bot and...

Congratulations, RuneMate now runs!

Or does it...?

2.5) **SETTING JAVA OVERRIDE**
I ran into an issue that prevented RuneMate from hooking to RSU and thus running..
If you're like me and have the same issue, follow the steps below:

Launch a terminal window and use the command:


sudo gedit /opt/runemate/RuneMate
then uncomment the line:
# INSTALL4J_JAVA_HOME_OVERRIDE=
and replace it with:
INSTALL4J_JAVA_HOME_OVERRIDE=/usr/lib/jvm/java-8-oracle
Then save the file.

Congratulations, you're all set! Enjoy RuneMate on Linux!



If this thread has helped you; please post saying "thanks" or something of the sort to keep it bumped for other Linux users.
Or if nothing else; like it so i know it's helping someone.

3) **Updating Runemate**

Updating Runemate on Linux can sometimes be a pain, downloading the new script, flagging it as executable, running it.
Qverkk has made a wonderful guide on how to make it easy, check it out in the link below:
Tutorial - Update/Run RM on Linux




CHANGELOG:
V2.4: Added a list of OS's that this guide is confirmed working with.

V2.3: Added ppa links for Debian based distributions.

V2.2: Formatting changes to highlight commands and chapters.

V2.1: Changed "[Depricated]" line to Troubleshooting Steps

V2.0: Added instructions on how to set Java Override in the original RuneMate.sh

V1.2: Uploaded runemate.sh bash and added instructions

V1.1: Sudo not needed when running Jar from /opt/runemate/

V1: Initial Release







--------------------------- [Still having trouble?] --------------------------


TROUBLESHOOTING STEPS

Below are some steps that i used to perform to get the RuneMate client working with RSU and/or loading bots; I since found the Java Override in the RuneMate.sh file located in /opt/runemate/ so this SHOULD no longer needed...
Note i said SHOULD.. For whatever reason i can't seem to get the above to work anymore; it worked one time then poof! nothing..



Can't launch RSU from RuneMate? try..

**Manually set the JAVA_HOME path in /etc/environment**

1.) Launch a terminal and run the following command:

sudo nano /etc/environment
once in nano add the following lines below PATH="Stuff/goes/here"

JAVA_HOME="/usr/lib/jvm/java-8-oracle"
export JAVA_HOME

ctrl+x to exit nano, hit y to save.
//NOTES [
JAVA_HOME path is set to that of the Oracle Java; the path is different for OpenJDK; again i assume you are using Oracle Java.

"export JAVA_HOME" may not be needed.
]
2.) Reboot
3.) Once rebooted open a terminal and run the following command:

java -jar /opt/runemate/RuneMate.jar

Everything should work fine from then on; do note that you are required to run the last command everytime you plan to use RuneMate.



If you need to use the above solution to launch RuneMate successfully; please feel free to try...

**The RuneMate Launch Bash**

If you are like me and had to use the above fix; I've written a little bash so you can launch RuneMate with an easier command.
To do this simply download the attached .zip file and extract the runemate.sh file to your Home directory

chmod +x runemate.sh

You can now launch RuneMate with the following command:

./runemate.sh

Alternatively if you don't want to run a command and just want to use a quick launch you can also extract the RuneMate.desktop file from the downloaded .zip where ever you'd like (Example used is Documents).
Open a terminal change your directory to wherever you extracted the RuneMate.desktop file.
example:

cd $HOME/Documents
and mark that as executable with the following command:

chmod +x RuneMate.desktop

From here you just double click the file and launch it. that simple.
 

Attachments

  • runemate.zip
    582 bytes · Views: 112
Last edited:
Joined
Nov 29, 2016
Messages
10
I have succesfully installed RuneMate and Rsu-client to Ubuntu 18.04, but when im trying to start bot it cancels that. So i can't start bots. I have already tried this fix
n.) **SETTING JAVA OVERRIDE**

and when im trying to run this
java -jar /opt/runemate/RuneMate.jar
i get this error
Error: Unable to access jarfile /opt/runemate/RuneMate.jar

 
Last edited:
Guy who knows things
Joined
Apr 2, 2018
Messages
25
It sounds like the file is missing or your Java is messed up.

What version of Java are you using? And if you run it from a terminal what happens? (just type RuneMate in a terminal)

finally post your /opt/runemate/RuneMate file
 
Joined
Nov 29, 2016
Messages
10
I'm using java8 and after i wrote RuneMate to terminal i get this:
18:22:42.168: Failed to load module "canberra-gtk-module"
[Debug] Java Home: /opt/runemate/jre
[Debug] Java Version: 8u121 x64 (Oracle Corporation)
[Debug] Maximum Heap Size: 683MB
[Debug] RuneMate Version: 2.84.1
[Debug] Operating System: Linux x64

and after that it launched.
 
Guy who knows things
Joined
Apr 2, 2018
Messages
25
Hmm; try downloading the launch script attached to the first post; follow the instructions to convert it into an executable document and try running it that way
 
Joined
Nov 29, 2016
Messages
10
I extracted runemate.sh to home folder and wrote chmod +x to it and when i launch it with ./runemate.sh it launches normally, but when im trying to login RuneMate says: Could not connect to the server. Please check your firewall settings." So i disabled firewall, restarted pc and it's still saying that.

Got this error to terminal after trying to login Runemate with ./runemate (I can login runemate if i use client installed with installer.)
javax.net.ssl.SSLException: java.lang.RuntimeException: Unexpected error: java.security.InvalidAlgorithmParameterException: the trustAnchors parameter must be non-empty
at sun.security.ssl.Alerts.getSSLException(Alerts.java:208)
at sun.security.ssl.SSLSocketImpl.fatal(SSLSocketImpl.java:1964)
at sun.security.ssl.SSLSocketImpl.fatal(SSLSocketImpl.java:1921)
at sun.security.ssl.SSLSocketImpl.handleException(SSLSocketImpl.java:1904)
at sun.security.ssl.SSLSocketImpl.startHandshake(SSLSocketImpl.java:1420)
at sun.security.ssl.SSLSocketImpl.startHandshake(SSLSocketImpl.java:1397)
at sun.net.www.protocol.https.HttpsClient.afterConnect(HttpsClient.java:559)
at sun.net.www.protocol.https.AbstractDelegateHttpsURLConnection.connect(AbstractDelegateHttpsURLConnection.java:185)
at sun.net.www.protocol.http.HttpURLConnection.getOutputStream0(HttpURLConnection.java:1334)
at sun.net.www.protocol.http.HttpURLConnection.getOutputStream(HttpURLConnection.java:1309)
at sun.net.www.protocol.https.HttpsURLConnectionImpl.getOutputStream(HttpsURLConnectionImpl.java:259)
at nul.iiIiIIiiiiiII.null(abc:178)
at nul.iiIiIIiiiiiII.null(abc:101)
at nul.IIIIIIiiIIiIi.null(srb:193)
at nul.IiiiiiiIIIiIi.null(elb:18)
at java.lang.Thread.run(Thread.java:748)
Caused by: java.lang.RuntimeException: Unexpected error: java.security.InvalidAlgorithmParameterException: the trustAnchors parameter must be non-empty
at sun.security.validator.PKIXValidator.<init>(PKIXValidator.java:91)
at sun.security.validator.Validator.getInstance(Validator.java:179)
at sun.security.ssl.X509TrustManagerImpl.getValidator(X509TrustManagerImpl.java:312)
at sun.security.ssl.X509TrustManagerImpl.checkTrustedInit(X509TrustManagerImpl.java:171)
at sun.security.ssl.X509TrustManagerImpl.checkTrusted(X509TrustManagerImpl.java:184)
at sun.security.ssl.X509TrustManagerImpl.checkServerTrusted(X509TrustManagerImpl.java:124)
at sun.security.ssl.ClientHandshaker.serverCertificate(ClientHandshaker.java:1596)
at sun.security.ssl.ClientHandshaker.processMessage(ClientHandshaker.java:216)
at sun.security.ssl.Handshaker.processLoop(Handshaker.java:1052)
at sun.security.ssl.Handshaker.process_record(Handshaker.java:987)
at sun.security.ssl.SSLSocketImpl.readRecord(SSLSocketImpl.java:1072)
at sun.security.ssl.SSLSocketImpl.performInitialHandshake(SSLSocketImpl.java:1385)
at sun.security.ssl.SSLSocketImpl.startHandshake(SSLSocketImpl.java:1413)
... 11 more
Caused by: java.security.InvalidAlgorithmParameterException: the trustAnchors parameter must be non-empty
at java.security.cert.PKIXParameters.setTrustAnchors(PKIXParameters.java:200)
at java.security.cert.PKIXParameters.<init>(PKIXParameters.java:120)
at java.security.cert.PKIXBuilderParameters.<init>(PKIXBuilderParameters.java:104)
at sun.security.validator.PKIXValidator.<init>(PKIXValidator.java:89)
... 23 more
 
Last edited:
Guy who knows things
Joined
Apr 2, 2018
Messages
25
Hrm... I can't say I've ran into that; Is this a fresh install of 18.04 or did you upgrade?
 
Joined
Nov 29, 2016
Messages
10
Woah! I found the solution. I just installed ubuntu 17.10 and followed these and now runemate works perfectly. There was something strange with 18.04 even i followed instructions. So i recommend to use ubuntu 17.10. Anyways thanks to @SFBDaBot for his awesome guide :)
 
Last edited:
Guy who knows things
Joined
Apr 2, 2018
Messages
25
Glad it helped!
I'm using 18.04 and did not run into the issue; but I'll see what i can do inside of a VM to see if i can replicate it.
 
Guy who knows things
Joined
Apr 2, 2018
Messages
25
I have only used it on x86, however if the SBC can run Linux then i'd imagine that this will work just fine.
 
Joined
Oct 11, 2018
Messages
1
I am running into this error when trying to run runemate.sh

gzip: sfx_archive.tar.gz: not in gzip format
I am sorry, but the installer file seems to be corrupted.
If you downloaded that file please try it again. If you
transfer that file with ftp please make sure that you are
using binary mode.

I have not modified the file and saved it directly from a download.
 
Eyyyyy Macarena
Joined
Oct 24, 2018
Messages
58
Gah, tried the solutions in this post but can't get the bugger to work :(

Code:
root@art-oobster-reinstalled:/opt/runemate# java -jar ./RuneMate.jar
Error: Could not find or load main class com.runemate.boot.Boot
Caused by: java.lang.NoClassDefFoundError: javafx/application/Application
root@art-oobster-reinstalled:/opt/runemate# echo $JAVA_HOME
/usr/lib/jvm/java-11-oracle
root@art-oobster-reinstalled:/opt/runemate# java -version
java version "11.0.1" 2018-10-16 LTS
Java(TM) SE Runtime Environment 18.9 (build 11.0.1+13-LTS)
Java HotSpot(TM) 64-Bit Server VM 18.9 (build 11.0.1+13-LTS, mixed mode)
root@art-oobster-reinstalled:/opt/runemate#

Using ubuntu 17. The java override is set to the same path @ the RuneLite file. Trying to launch via RuneLite as opposed to RuneLite.jar results in these exceptions. Any ideas?
 
Eyyyyy Macarena
Joined
Oct 24, 2018
Messages
58
Found another fix on RuneLite of all places and it actually worked for me! Only tried this with the standalone version:

Code:
java -jar ./RuneMate.jar --mode=OFF

Using Oracle java 8
 
Joined
Apr 16, 2019
Messages
4
Right now the repositories are depreciated because Oracle requires license agreement through their company website. You must now download the rpm or tar files from the company website and install them on your computer in order to do this. I had some problems at first, this is a necessary revision to this guide.

It's important to follow from step one, because if installation exists at directory /opt/runescape using the open source java binary then problems may persist.

Download Oracle Java Development Kit (JDK) from site. Note: You must use the JDK and not the JRE as libraries for LinuxVirtualMachine from attach are only present in the JDK.

install JDK
>sudo tar xzvpf oracle-8-JDK -C /usr/lib/jvm
>sudo update-alternatives --install "/usr/bin/java" "java" "/usr/lib/jvm/oracle-8-JDK/bin/java" 1
>sudo update-alternatives --config java
>1

install RSU-linux
>cd /tmp
>sudo wget -c "https://github.com/rsu-client/rsu-client/releases/download/v4.3.7/RSU-linux-x64-installer.run.zip"
>sudo unzip RSU-linux-x64-installer.run.zip
>sudo chmod 'u+x' RSU-linux-x64-installer.run
>sudo ./RSU-linux-x64-installer.run
remove the existing installation under /opt/runescape or wherever it is before continuing.

now use runemate, it doesn't matter the order you install runemate as long as the symlink for java points to /usr/lib/jvm/oracle-8-JDK/bin/java
>cd /opt/runemate
>java -jar RuneMate.jar


It should work correctly now.
 
Joined
May 4, 2019
Messages
1
Right now the repositories are depreciated because Oracle requires license agreement through their company website. You must now download the rpm or tar files from the company website and install them on your computer in order to do this. I had some problems at first, this is a necessary revision to this guide.

It's important to follow from step one, because if installation exists at directory /opt/runescape using the open source java binary then problems may persist.

Download Oracle Java Development Kit (JDK) from site. Note: You must use the JDK and not the JRE as libraries for LinuxVirtualMachine from attach are only present in the JDK.

install JDK
>sudo tar xzvpf oracle-8-JDK -C /usr/lib/jvm
>sudo update-alternatives --install "/usr/bin/java" "java" "/usr/lib/jvm/oracle-8-JDK/bin/java" 1
>sudo update-alternatives --config java
>1

install RSU-linux
>cd /tmp
>sudo wget -c "https://github.com/rsu-client/rsu-client/releases/download/v4.3.7/RSU-linux-x64-installer.run.zip"
>sudo unzip RSU-linux-x64-installer.run.zip
>sudo chmod 'u+x' RSU-linux-x64-installer.run
>sudo ./RSU-linux-x64-installer.run
remove the existing installation under /opt/runescape or wherever it is before continuing.

now use runemate, it doesn't matter the order you install runemate as long as the symlink for java points to /usr/lib/jvm/oracle-8-JDK/bin/java
>cd /opt/runemate
>java -jar RuneMate.jar


It should work correctly now.

Edit: I fixed my issue, not sure exactly what fixed it. Might have been just a reboot.

For anyone else finding this thread in the future, the download from Java SE Development Kit 8 - Downloads is now called jdk1.8.0_211, not oracle-8-JDK. Make sure to get the right version for your system (32bit vs 64 bit).
 
Last edited:
Top