This project is a minimalistic launcher for Runescape 3 (NXT). Compatible with v2.2.4. It uses a (portable, /bin/sh) shell script to download the game config, update files and then run the game. This project has been tested on Debian, Void and Solus GNU + Linux.
The shell script requies the following programs:
curl - curl - used to download files
7zip - p7zip-full - used to compress/decompress files
And compiling the program
gcc - gcc - compile the program
To run on a fresh ubuntu install you should be able to run:
sudo apt install curl p7zip-full gcc git libsdl2-2.0-0
and then follow the instructions below. (except for installing the old version of libGLEW)
git clone https://github.com/yoloium/rs3-launcher.git # Clone repository
cd rs3-launcher
vim launcher.c # Edit the window dimensions (width and height etc) by modifying the integer values in the #define at the top
gcc launcher.c -o launcher # compile the file, pass the '-Os' flag for a smaller file.
mkdir -p $HOME/Jagex/launcher # Create nessessary files
touch $HOME/Jagex/launcher/rs2client # Create empty file so that it can be checksum'd.
Now would be a good time to add a desktop entry;
vim runescape.desktop
and edit the 'Exec' Line to point to the script wherever you have it currently - you must use absolute paths, no $HOME or ~/ ! You can cheat with:
sed -i "s:directory:$PWD:g" runescape.desktop
Then when it is corretly edited, copy to the correct directory (requires root);
sudo cp runescape.desktop /usr/share/applications/
Now we can run the script, or launch from our Desktop environment's menu;
./rs3-launcher
If the game window doesn't open, make sure that all dependencies of the newly downloaded client are met:
ldd ~/Jagex/launcher/rs2client | grep 'not found'
The game doesn't render the world; it's just sky blue. Fix: add this to the main scope of the script:
export MESA_GL_VERSION_OVERRIDE=3.0
NOTE if you have an older graphics card, you can replace '3.0' with '2.1' so that you can play on a system which does not support opengl 3.0
Will consider accepting pull requests. But don't expect me to look here frequently. PM me in game or something to let me know; RSN = yoloium
- Single shell script but python based RS3 NXT Launcher: https://gist.github.com/yoloium/3b2ece56c33cf6dc013e75cc64e4124a. (v2.2.4 compatible)
- Minimal (legacy) java client launcher: https://gist.github.com/yoloium/0dd28b23da8cf1d9c409972141137967. NOTE: read comment for RS3 usage.
- (bloated) C++ equivalent: https://github.com/syldrathecat/nxtlauncher
This project is licensed under the MIT License - see the LICENSE file for details
syldrathecat for https://github.com/syldrathecat/nxtlauncher. This project served as inspiration this project. It provides a lot of answers on how the client executes.