syldrathecat / nxtlauncher

Third-party launcher for RuneScape NXT.
The Unlicense
7 stars 0 forks source link
game launcher linux

nxtlauncher

nxtlauncher is a third-party launcher for RuneScape NXT on Linux.

Current version is 2.1, compatible with NXT 2.2.4.

Warning: Using this probably violates RuneScape's terms of service and might stop working one day.

What?

The launcher is the program you install locally that downloads the latest RuneScape client and runs it.

Instructions for installing the official Jagex launcher on Ubuntu are available here:

https://www.runescape.com/download

An unofficial re-distribution of the official launcher for Arch Linux is available here:

https://aur.archlinux.org/packages/runescape-launcher/

Why?

The official Linux RuneScape launcher has consistently been released with annoying bugs that nxtlauncher avoids such as keyboard focus issues and the splash loading screen being stuck open.

It also requires far less disk space to install than the official launcher (which depends on WebKitGTK+) and can integrate more naturally on non-Ubuntu platforms.

Note that you still need to ensure you install the dependencies for the game client itself manually. Check for missing dependencies by using the command ldd ~/Jagex/launcher/rs2client | grep "not found" if the game does not load.

Installation

nxtlauncher is written in C++ and can be built and installed using CMake.

Dependencies

nxtlauncher depends on getopt (part of glibc), libcurl, and liblzma.

Build + Install Steps

cmake -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=Release .
make
sudo make install

This will install both nxtlauncher and runescape to /usr/local/bin/.

Please see the CMake documentation for more info.

Usage

An included script runescape wraps the launcher the same way the official runescape-launcher script does. Executing nxtlauncher directly will not set the required environment variables for the game to work correctly (resulting in, for example, no 3D graphics appearing for some graphics drivers).

nxtlauncher supports overriding the launcher path and configuration files through environment variables or command line options.

It also supports re-using downloaded game configurations / sessions (valid for 24 hours), and certain extended launcher preferences such as configuration URI and client window dimensions.

Environment Variables

Command Line Options

Config Settings

nxtlauncher will read certain additional settings from the launcher config file (NXTLAUNCHER_CONFIG or preferences.cfg).

Note: Spaces should not appear around the equals sign (e.g. x_config_uri=https://...).

Wishlist

Features from the official launcher missing in nxtlauncher: