golt

README

⚔️ golt

golt is a CLI-based third-party game launcher for OldSchool Runescape.

Why?

The official recommendation points to several community projects, most which run the launcher in Wine or similar. I wanted a native solution, or one that was more reasonable than installing a 1.5GB compatibility layer just to run the launcher.

There's a similarly named project that does work natively in Linux (and functionality-wise it simply just works); however there were some boxes that it didn't tick for me:

• It's installation size is ~460MB
• It doesn't support overriding the client launch command/environment
• It's a bit of a pain to compile

In comparison, the linux-amd64 build for golt is only 6.8MB.

Installation

Either download the latest binary form the Releases page, or build it yourself, and add it to your PATH.

Then, create a desktop entry for the application:

[Desktop Entry]
Type=Application
Name=golt
Exec=golt %U
StartupNotify=true
Terminal=true
MimeType=x-scheme-handler/jagex;

Then, register it to be the default handler for the jagex:<...> scheme:

xdg-mime default golt.desktop x-scheme-handler/jagex

Finally, set up an iptable entry to redirect localhost:80 to localhost:8080:

sudo iptables -t nat -I OUTPUT -p tcp -d 127.0.0.1 --dport 80 -j REDIRECT --to-ports 8080

Why?

The login flow is currently done in the browser:

• The OAuth login redirects to a page which invokes a scheme handler
• The game login step redirects to http://localhost

These redirect URLs are validated server side, so cannot be modified on the client side.

As for the iptable entry, most Linux distros don't allow binding to port 80, so golt binds to port 8080 instead.

Configuration

Environment Variable	Default	Description
GOLT_GAME_PATH	RuneLite.AppImage	Either a binary on PATH, or an absolute path to the client to launch. This value is passed to exec.Command(docs)

Disclaimer

This project is not affiliated with or endorsed by Jagex Ltd. It is an independent project created for educational and testing purposes. Please use responsibly and adhere to Jagex's terms of service.