• Jagex Launcher ¹⁾
• RuneScape ²⁾ (for Old School RuneScape/OSRS, see these notes instead)
• 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 ³⁾

• Fedora Workstation
• Wine

• Be sure the cache is fully-downloaded, and ideally toggle Options → Textures between Compressed and Uncompressed for both caches

• Jagex Launcher sometimes has issues with being interacted with from GNOME tray with the AppIndicator/KStatusNotifierItem support for GNOME Shell extension ⁴⁾
• Can be an issue on other desktop environments ⁵⁾

gnome-extensions disable 'ubuntu-appindicators@ubuntu.com'

gnome-extensions disable 'appindicatorsupport@rgcjonas.gmail.com'

sudo dnf install 'openssl1.1.x86_64' && sync

mkdir -p ~/'.wine' && WINEPREFIX=~/'.wine/RuneScape' WINEARCH='win64' wineboot && sync

• You'll need to supply Jagex Launcher files as the installer doesn't work ⁶⁾
• See Jagex Launcher Installer notes for installer testing

• Google Drive link to a clean Jagex Launcher folder with SHA256
• Use this if at all unsure

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'

• Expects something like ~/Downloads/20230920-Jagex-Launcher.zip with any date
• The top-level of the archive should be the Jagex Launcher folder ⁷⁾

unzip -b -o -qq ~/'Downloads/'*'Jagex'*'Launcher.zip' -d ~/'.wine/RuneScape/drive_c/Program Files' && sync

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

• Update launcher if prompted, log-in, select RuneScape → Install
• Fully-exit Jagex Launcher after installation

mkdir -p ~/'.wine/RuneScape/dxvk_shader_cache' && cd ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher' && MESA_SHADER_CACHE_DIR=~/'.wine/RuneScape' DXVK_STATE_CACHE_PATH=~/'.wine/RuneScape/dxvk_shader_cache' WINEPREFIX=~/'.wine/RuneScape' wine ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe' --disable-gpu --disable-software-rasterizer

• Version-check occasionally, as this currently expects runescape-launcher_2.2.11_amd64.deb
• Last tested: 2024/02/08 on Fedora 39

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

• See RuneScape for other graphics cards, notes, and more 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"

# Audio
#export SDL_AUDIODRIVER='pipewire'
export PULSE_LATENCY_MSEC='400'
export SDL_AUDIODRIVER='pulseaudio'
export PULSE_PROP_OVERRIDE="application.name='RuneScape' application.icon_name='runescape' media.role='game'"

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

# Custom

# Modern Open/Mesa Graphics
export MESA_SHADER_CACHE_DIR=~/'.wine/RuneScape'
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 $@

rm -f ~/'Downloads/Jagex Launcher Installer.exe' ~/'Downloads/'*'Jagex Launcher.zip' && cd ~ && sync

mkdir -p ~/'.local/share/applications/wine/Programs/Jagex' && nano ~/'.local/share/applications/wine/Programs/Jagex/RuneScape.desktop'

[Desktop Entry]
Name=RuneScape
Categories=Game;AdventureGame;RolePlaying
Exec='/bin/bash' -c "cd ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher' && MESA_SHADER_CACHE_DIR=~/'.wine/RuneScape' WINEPREFIX=~/'.wine/RuneScape' wine ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe' --disable-gpu --disable-software-rasterizer"
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

WINEPREFIX=~/'.wine/RuneScape' winecfg

WINEPREFIX=~/'.wine/RuneScape' winetricks

WINEPREFIX=~/'.wine/RuneScape' regedit

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

cd ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher' && 

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

• 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

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

• All the .jcache files can be backed-up and restored, but ideally exclude GlobalSettings.jcache, ObjCache.jcache, and ShaderManager.jcache ⁸⁾

gio open ~/'.wine/RuneScape/drive_c/ProgramData/Jagex/RuneScape/'