games:wine:runescape_jagex_launcher
This is an old revision of the document!
Table of Contents
Information
- Jagex Launcher 1)
- RuneScape 2) (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 3)
Prerequisites
Notes
- Be sure the cache is fully-downloaded, and ideally toggle Options → Textures between
Compressed
andUncompressed
for both caches
Install
Jagex Launcher
- 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
- 2023/07/23: The installer didn't appear to launch or show any GUI
- See Jagex Launcher Installer notes for testing
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
- Version-check occasionally, as this currently expects
runescape-launcher_2.2.11_amd64.deb
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 istmpfs
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, 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 $@
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' && 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' &&
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
- All the
.jcache
files can be backed-up and restored, but ideally excludeGlobalSettings.jcache
,ObjCache.jcache
, andShaderManager.jcache
6)
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 version5)
it's assumed that if Vulkan isn't present that the launcher will fallback to its included software renderer
.dll
without intervention6)
2023/08/20: Full cache is around
10.6 GB
/srv/www/wiki/data/attic/games/wine/runescape_jagex_launcher.1692927757.txt.gz · Last modified: (external edit)