1. This site uses cookies. By continuing to use this site, you are agreeing to our use of cookies. Learn More.

Tutorial RuneMate on Linux

Discussion in 'Client & Site Support' started by SFBDaBot, Apr 3, 2018.

  1. SFBDaBot

    SFBDaBot Guy who knows things

    Joined:
    Apr 2, 2018
    Messages:
    25
    Likes Received:
    6
    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 bot, 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.
     

    Attached Files:

    #1 SFBDaBot, Apr 9, 2018
    Last edited: Aug 5, 2018
    ShadowGo and TheDude like this.
  2. Hakuna Matata

    Joined:
    Oct 12, 2014
    Messages:
    181
    Likes Received:
    38
    Excellent guide. Had troubles with running RuneMate on Debian 8 but something in this guide fixed it.
     
    SFBDaBot likes this.
  3. SFBDaBot

    SFBDaBot Guy who knows things

    Joined:
    Apr 2, 2018
    Messages:
    25
    Likes Received:
    6
    Thanks, glad it helped :)
     
  4. ShadowGo

    Joined:
    Nov 29, 2016
    Messages:
    10
    Likes Received:
    1
    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

     
    #4 ShadowGo, Jun 10, 2018
    Last edited: Jun 10, 2018
  5. SFBDaBot

    SFBDaBot Guy who knows things

    Joined:
    Apr 2, 2018
    Messages:
    25
    Likes Received:
    6
    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
     
  6. ShadowGo

    Joined:
    Nov 29, 2016
    Messages:
    10
    Likes Received:
    1
    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.
     
  7. SFBDaBot

    SFBDaBot Guy who knows things

    Joined:
    Apr 2, 2018
    Messages:
    25
    Likes Received:
    6
    Hmm; try downloading the launch script bot attached to the first post; follow the instructions to convert it into an executable document and try running it that way
     
  8. ShadowGo

    Joined:
    Nov 29, 2016
    Messages:
    10
    Likes Received:
    1
    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
     
    #8 ShadowGo, Jun 10, 2018
    Last edited: Jun 10, 2018
  9. SFBDaBot

    SFBDaBot Guy who knows things

    Joined:
    Apr 2, 2018
    Messages:
    25
    Likes Received:
    6
    Hrm... I can't say I've ran into that; Is this a fresh install of 18.04 or did you upgrade?
     
  10. ShadowGo

    Joined:
    Nov 29, 2016
    Messages:
    10
    Likes Received:
    1
    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 :)
     
    #10 ShadowGo, Jun 21, 2018
    Last edited: Jun 22, 2018
  11. SFBDaBot

    SFBDaBot Guy who knows things

    Joined:
    Apr 2, 2018
    Messages:
    25
    Likes Received:
    6
    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.
     
  12. orbitPI

    Joined:
    Feb 8, 2018
    Messages:
    43
    Likes Received:
    1
    Will this work on S.B. ARM prosesors? Exampel raspbery pi, android phone's.
     
  13. SFBDaBot

    SFBDaBot Guy who knows things

    Joined:
    Apr 2, 2018
    Messages:
    25
    Likes Received:
    6
    I have only used it on x86, however if the SBC can run Linux then i'd imagine that this will work just fine.
     
  14. droidekka2

    Joined:
    Jul 22, 2018
    Messages:
    9
    Likes Received:
    0
    only java oracle 10 works now no?
     
  15. Gavin Mawston

    Joined:
    Oct 11, 2018
    Messages:
    1
    Likes Received:
    0
    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.
     
  16. Alqira

    Alqira Eyyyyy Macarena

    Joined:
    Oct 24, 2018
    Messages:
    58
    Likes Received:
    10
    Gah, tried the solutions in this post but can't get the bugger to work :(

    Code (Text):
    1. root@art-oobster-reinstalled:/opt/runemate# java -jar ./RuneMate.jar
    2. Error: Could not find or load main class com.runemate.boot.Boot
    3. Caused by: java.lang.NoClassDefFoundError: javafx/application/Application
    4. root@art-oobster-reinstalled:/opt/runemate# echo $JAVA_HOME
    5. /usr/lib/jvm/java-11-oracle
    6. root@art-oobster-reinstalled:/opt/runemate# java -version
    7. java version "11.0.1" 2018-10-16 LTS
    8. Java(TM) SE Runtime Environment 18.9 (build 11.0.1+13-LTS)
    9. Java HotSpot(TM) 64-Bit Server VM 18.9 (build 11.0.1+13-LTS, mixed mode)
    10. 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?
     
  17. JontyMcNab

    Joined:
    Nov 12, 2018
    Messages:
    4
    Likes Received:
    1
  18. Alqira

    Alqira Eyyyyy Macarena

    Joined:
    Oct 24, 2018
    Messages:
    58
    Likes Received:
    10
    Found another fix on RuneLite of all places and it actually worked for me! Only tried this with the standalone version:

    Code (Text):
    1. java -jar ./RuneMate.jar --mode=OFF
    Using Oracle java 8
     
  19. bibleman

    Joined:
    Apr 16, 2019
    Messages:
    4
    Likes Received:
    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.
     
  20. angel_bots

    Joined:
    May 4, 2019
    Messages:
    1
    Likes Received:
    0
    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).
     
    #20 angel_bots, May 4, 2019
    Last edited: May 4, 2019

Share This Page

Loading...