User Tools

Site Tools


games:wine:runescape_jagex_launcher

This is an old revision of the document!


Information

  • Jagex Launcher 1)
  • RuneScape 2)
  • NXT Client
  • This allows running the Jagex Launcher with Wine, and the NXT RS3 client natively
  • Jagex Launcher can be closed after pressing Play and the RuneScape client window appears 3)

Prerequisites

Notes

  • TODO

Install

Jagex Launcher

  • :!: You need to supply your own Jagex Launcher files as the installer doesn't work 4)
  • Google Drive link to a clean Jagex Launcher folder with SHA256 below
mkdir -p ~/'.wine' && WINEPREFIX=~/'.wine/RuneScape' WINEARCH='win64' wineboot && sync
sha256sum ~/'Downloads/20230810 Jagex Launcher.zip' | grep '60d8ce5ccfab7e3d0aab9048db8664d9795aab7e90a9ae69ac78a97ed968e15e' > '/dev/null' && unzip -b -o -qq ~/'Downloads/20230810 Jagex Launcher.zip' -d ~/'.wine/RuneScape/drive_c/Program Files' && sync
gio open ~/'.wine/RuneScape/drive_c/Program Files'

Official Installer

RuneScape

Jagex Launcher

  • Update launcher if prompted, log-in, select RuneScape → Install
  • Fully-exit Jagex Launcher after installation
cd ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher' && WINEPREFIX=~/'.wine/RuneScape' wine ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe' --disable-gpu --disable-software-rasterizer

RuneScape

cd ~ && rm -Rf ~/'.runescape' ~/'.wine/RuneScape/Jagex/launcher' ~/'.wine/RuneScape/Jagex/updater' ~/'.wine/RuneScape/Jagex/RuneScape/GlobalSettings.jcache' ~/'.wine/RuneScape/Jagex/RuneScape/Settings.jcache' ~/'.wine/RuneScape/Jagex/RuneScape/ShaderManager.jcache' ~/'.local/share/icons/hicolor/'*'/apps/runescape.png' ~/'.local/share/applications/RuneScape.desktop' '/tmp/runescape' && mkdir -p ~/'.wine/RuneScape/Jagex/updater' '/tmp/runescape' && wget -O '/tmp/runescape/runescape-launcher-amd64.deb' 'https://content.runescape.com/downloads/ubuntu/pool/non-free/r/runescape-launcher/runescape-launcher_2.2.11_amd64.deb' && unar -o '/tmp/runescape' '/tmp/runescape/runescape-launcher-amd64.deb' && unar -o '/tmp/runescape' '/tmp/runescape/runescape-launcher-amd64/data.tar.xz' && cp '/tmp/runescape/data/usr/bin/runescape-launcher' '/tmp/runescape/data/usr/share/games/runescape-launcher/runescape' ~/'.wine/RuneScape/Jagex/updater' && cp -R '/tmp/runescape/data/usr/share/icons' ~/'.local/share' && ls ~/'.wine/RuneScape/Jagex/updater/runescape' ~/'.wine/RuneScape/Jagex/updater/runescape-launcher' > '/dev/null' && rm -Rf '/tmp/runescape' && ln --backup --symbolic --force ~/'.wine/RuneScape/Jagex/updater/runescape-launcher' ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher/Games/RuneScape/RuneScape.exe' && sync

Disable Disk Logging

  • This puts logs into the user's /run folder which in Fedora's case is tmpfs
rm -Rf ~/'.wine/RuneScape/drive_c/users/'$USER'/AppData/Local/Jagex Launcher/logs' && ln --force --symbolic '/run/user/'"$(id --user)" ~/'.wine/RuneScape/drive_c/users/'$USER'/AppData/Local/Jagex Launcher/logs'

Undo

rm -Rf ~/'.wine/RuneScape/drive_c/users/'$USER'/AppData/Local/Jagex Launcher/logs' && mkdir -p ~/'.wine/RuneScape/drive_c/users/'$USER'/AppData/Local/Jagex Launcher/logs'

runescape-launcher

  • See RuneScape for other graphics cards and other environment variables
nano ~/'.wine/RuneScape/Jagex/updater/runescape-launcher'
#!/bin/sh

if [ -z $1 ]; then
    configURI=http://www.runescape.com/k=5/l=\$\(Language:0\)/jav_config.ws
else
    configURI=$1
    shift
fi

export SDL_VIDEO_X11_WMCLASS="RuneScape"
export PULSE_LATENCY_MSEC='100'

# PulseAudio
#export SDL_AUDIODRIVER='pulseaudio'
#export PULSE_PROP_OVERRIDE="application.name='RuneScape' application.icon_name='runescape' media.role='game'"

# PipeWire
export SDL_AUDIODRIVER='pipewire'

# Display Server
#export SDL_VIDEODRIVER='wayland'
export SDL_VIDEODRIVER='x11'

# Custom

# Modern Open/Mesa Graphics
export MESA_SHADER_CACHE_DIR=~/'Jagex'
export MESA_GL_VERSION_OVERRIDE='4.6COMPAT'
export MESA_NO_ERROR='1'
export mesa_glthread='true'
export MESA_DISK_CACHE_SINGLE_FILE='1'
export MESA_DISK_CACHE_DATABASE='1'

unset XMODIFIERS
~/'.wine/RuneScape/Jagex/updater/runescape --configURI $configURI $@

Desktop Launcher

  • If Jagex Launcher doesn't render or acts differently than when it was ran above, add --disable-gpu --disable-software-rasterize 5)
mkdir -p ~/'.local/share/applications/wine/Programs/Jagex' && nano ~/'.local/share/applications/wine/Programs/Jagex/RuneScape.desktop'
[Desktop Entry]
Name=RuneScape
Comment=A unique MMO set in the vast, fantasy world of Gielinor, brimming with diverse races, guilds and ancient gods battling for dominion. RuneScape now features more ways to play, brand new skills and over 200 gripping story-driven quests.
Categories=Game;AdventureGame;RolePlaying
Exec='/bin/bash' -c "cd ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher' && PULSE_LATENCY_MSEC='400' MESA_SHADER_CACHE_DIR=~/'.wine/RuneScape' WINEPREFIX=~/'.wine/RuneScape' wine ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe'"
Type=Application
StartupNotify=true
Icon=runescape
StartupWMClass=RuneScape
Actions=Kill;Cache;Notes;

[Desktop Action Kill]
Exec='/bin/bash' -c "WINEPREFIX=~/'.wine/RuneScape' wineserver --kill && killall' -9 'rs2client' 'runescape' 'runescape-launcher'"
Name=Force-close

[Desktop Action Cache]
Exec='/bin/bash' -c "rm -Rf ~/'.runescape' ~/'.wine/RuneScape/Jagex/mesa_shader_cache' ~/'.wine/RuneScape/Jagex/GLCache' ~/'.wine/RuneScape/Jagex/launcher/instance.lock' ~/'.wine/RuneScape/Jagex/RuneScape/ShaderManager.jcache' '/tmp/runescape' && sync && notify-send 'The RuneScape cache has been cleaned.'"
Name=Cache Clean-up

[Desktop Action Notes]
StartupNotify=false
Exec='/bin/bash' -c "gio open 'https://wiki.realmofespionage.xyz/games:wine:runescape_jagex_launcher'"
Name=Installation Notes

# End

Quick Commands

Winecfg

WINEPREFIX=~/'.wine/RuneScape' winecfg

Winetricks

WINEPREFIX=~/'.wine/RuneScape' winetricks

Registry Editor

WINEPREFIX=~/'.wine/RuneScape' regedit

Kill

WINEPREFIX=~/'.wine/RuneScape' wineserver --kill && killall' -9 'rs2client' 'runescape' 'runescape-launcher'

Execute

Jagex Launcher

cd ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher' && 
PULSE_LATENCY_MSEC='400' MESA_SHADER_CACHE_DIR=~/'.wine/RuneScape' WINEPREFIX=~/'.wine/RuneScape' wine ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe'

Troubleshooting

  • Wine's virtual desktop may be necessary with certain desktop/window managers and with Wayland
WINEDEBUG=''
explorer /desktop='Jagex-Launcher','1280x720'
--disable-gpu --disable-software-rasterizer

File Manager

Jagex Launcher

gio open ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher/'

Cache

gio open ~/'.wine/RuneScape/drive_c/ProgramData/Jagex/RuneScape/'
3)
the log-in session carries over through world switches and even log-outs; Jagex Launcher only needs re-opened if you close the RS client window
4)
install Jagex Launcher on a Windows machine first, and then the Jagex Launcher folder in Program Files can be copied over as-is to the Wine prefix; you don't need to log-in but ideally run it once after installation for it to update to the latest version
5)
it's assumed that if Vulkan isn't present that the launcher will fallback to its included software renderer .dll without intervention
6)
may prevent random audio glitching if it's still present; this was copied from OSRS notes but RS had similar issues early-2023
/var/www/wiki/data/attic/games/wine/runescape_jagex_launcher.1692561383.txt.gz · Last modified: 2023/08/20 15:56 by Sean Rhone