User Tools

Site Tools


games:wine:old_school_runescape_jagex_launcher

This is an old revision of the document!


Information

  • Jagex Launcher 1)
  • Old School RuneScape 2)
  • This allows running the Jagex Launcher through wine, while keeping OSRS ran natively through java
  • :!: This is a result of Jagex not caring about Linux users 3)
  • Jagex Launcher in this context is used for the account authentication, and passes the log-in session data to the OSRS client
  • Jagex Launcher can be closed after pressing Play and the OSRS client window appears 4)

Prerequisites

Install

Dependencies

  • wmctrl is used to toggle between windowed and fullscreen states
sudo dnf install java-11-openjdk wmctrl && sync

Jagex Launcher

  • This needs installed on a Windows machine first, and then the Jagex Launcher folder in Program Files can be copied as-is to the Wine prefix
  • Google Drive link to a clean Jagex Launcher folder
mkdir -p ~/'.wine' && WINEPREFIX=~/'.wine/Old School RuneScape' WINEARCH='win32' wineboot && sync
gio open ~/'.wine/Old School RuneScape/drive_c/Program Files'

Official Installer

  • 2023/07/19: The installer didn't appear to launch or show any GUI
  • If the installer ever works, this is the preferred installation method
mkdir -p ~/'.wine' && wget 'https://cdn.jagex.com/Jagex%20Launcher%20Installer.exe' -O ~/'Downloads/Jagex Launcher Installer.exe' && WINEPREFIX=~/'.wine/Old School RuneScape' WINEARCH='win32' wine ~/'Downloads/Jagex Launcher Installer.exe'

Old School RuneScape

Jagex Launcher

  • Update launcher if prompted, log-in, select OSRS → Official Client → Install
cd ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher' && WINEPREFIX=~/'.wine/Old School RuneScape' wine ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe' --disable-gpu --disable-software-rasterizer

Native Old School RuneScape

rm -Rf ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/Games/Old School RuneScape/linux/jagexappletviewer.jar' && mkdir -p ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/Games/Old School RuneScape/linux' '/tmp/oldschool' && wget -O '/tmp/oldschool/OldSchool.msi' 'https://www.runescape.com/downloads/oldschool.msi' && 7z e -o'/tmp/oldschool/OldSchool-msi' -y '/tmp/oldschool/OldSchool.msi' && 7z e -o'/tmp/oldschool/rslauncher-cab' -y '/tmp/oldschool/OldSchool-msi/rslauncher.cab' && cp '/tmp/oldschool/rslauncher-cab/JagexAppletViewerJarFile'* ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/Games/Old School RuneScape/linux/jagexappletviewer.jar' && cp '/tmp/oldschool/rslauncher-cab/JagexAppletViewerPngFile' ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/Games/Old School RuneScape/linux/jagexappletviewer.png' && rm -Rf '/tmp/oldschool' && sync

Launch Script Magic

  • Source for the symlink advice
nano ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/Games/Old School RuneScape/linux/osrs.sh' && chmod +x ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/Games/Old School RuneScape/linux/osrs.sh' && ln --symbolic --force ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/Games/Old School RuneScape/linux/osrs.sh' ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/Games/Old School RuneScape/bin/JagexLauncher.exe'
#!/bin/bash
cd "${0%/*}"

export JDK_JAVA_OPTIONS='-Dsun.java2d.uiScale=1'

'/usr/lib/jvm/jre-11/bin/java' -Xms256M -Xmx2G -XX:+UseSerialGC -Duser.home='.' -Djava.class.path='jagexappletviewer.jar' -Dcom.jagex.config='http://oldschool'116'.runescape.com/k=3/l=$(Language:0)/jav_config.ws' -Dhttps.protocols='TLSv1.3' -Dsun.java2d.opengl='false' 'jagexappletviewer' 'oldschool'

# End

Desktop Launcher

  • 2023/07/19: Cache clean-up command TODO
  • The other Exec= is to run Jagex Launcher in a virtual desktop window to workaround oddities likely on Wayland sessions 5)
mkdir -p ~/'.local/share/applications/wine/Programs/Jagex' && nano ~/'.local/share/applications/wine/Programs/Jagex/Old School RuneScape.desktop' && sed -i 's/'CHANGEME'/'$USER'/g' ~/'.local/share/applications/wine/Programs/Jagex/Old School RuneScape.desktop'
[Desktop Entry]
Name=Old School RuneScape
Comment=Relive the challenging levelling system and risk-it-all PvP of the biggest retro styled MMO. Play with millions of other players in this piece of online gaming heritage where the community controls the development so the game is truly what you want it to be!
Categories=Game;Java;AdventureGame;RolePlaying
Exec=env WINEPREFIX='/home/CHANGEME/.wine/Old School RuneScape' wine '/home/CHANGEME/.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe' --disable-gpu --disable-software-rasterizer
#Exec=env WINEPREFIX='/home/CHANGEME/.wine/Old School RuneScape' wine explorer /desktop='Jagex-Launcher','1440x900' '/home/CHANGEME/.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe' --disable-gpu --disable-software-rasterizer
Type=Application
StartupNotify=true
Path=/home/CHANGEME/.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher
Icon=/home/CHANGEME/.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/Games/Old School RuneScape/linux/OSRS.icns
StartupWMClass=jagexappletviewer
Actions=Cache;Kill;Screen;Notes;

[Desktop Action Cache]
StartupNotify=false
#Exec='/bin/bash' -c "rm -Rf '/home/CHANGEME/runescape/oldschool/jagexcache' '/home/CHANGEME/runescape/oldschool/jagexappletviewer.preferences' '/home/CHANGEME/runescape/oldschool/jagex_cl_oldschool_LIVE.dat' '/home/CHANGEME/runescape/oldschool/random.dat' '/home/CHANGEME/runescape/oldschool/'*'.log' '/home/CHANGEME/runescape/oldschool/.java' '/tmp/oldschool' && sync && notify-send 'The Old School RuneScape cache has been cleaned.'"
Name=Cache Cleanup

[Desktop Action Kill]
Exec=env WINEPREFIX='/home/CHANGEME/.wine/Old School RuneScape' wineserver --kill
Name=Force-close

[Desktop Action Screen]
StartupNotify=false
Exec='/usr/bin/wmctrl' -r 'jagexappletviewer.jagexappletviewer' -x -b 'toggle,fullscreen'
Name=Toggle Fullscreen/Windowed

[Desktop Action Notes]
StartupNotify=false
Exec=gio open 'https://wiki.realmofespionage.xyz/games:wine:old_school_runescape_jagex_launcher'
Name=Installation Notes

Icon

rm -Rf '/tmp/oldschool' && mkdir -p '/tmp/oldschool' && wget -O '/tmp/oldschool/OldSchool.dmg' 'https://www.runescape.com/downloads/OldSchool.dmg' && 7z e -o'/tmp/oldschool/OldSchool-dmg' -y '/tmp/oldschool/OldSchool.dmg' && cp '/tmp/oldschool/OldSchool-dmg/OSRS.icns' ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/Games/Old School RuneScape/linux/OSRS.icns' && rm -Rf '/tmp/oldschool' && sync

Quick Commands

Winecfg

WINEPREFIX=~/'.wine/Old School RuneScape' winecfg

Winetricks

WINEPREFIX=~/'.wine/Old School RuneScape' winetricks

Registry Editor

WINEPREFIX=~/'.wine/Old School RuneScape' regedit

Kill

WINEPREFIX=~/'.wine/Old School RuneScape' wineserver --kill

Execute

Jagex Launcher

cd ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher' && 
WINEDEBUG=''
WINEPREFIX=~/'.wine/Old School RuneScape' wine ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe'
--disable-gpu --disable-software-rasterizer

File Manager

Jagex Launcher

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

Old School RuneScape

gio open ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/Games/Old School RuneScape/linux/'
3)
Jagex Accounts are an answer to PEBKAC account hijacks, and are being enforced for all RuneScape players in the future. You can upgrade switch to a Jagex Account now, but note it is irreversible. Switching to a Jagex Account disables old user/pass logins through RuneScape clients, and requires logging into PC clients through the Jagex Launcher or Steam. Jagex has no plans on providing a native Linux version of the Jagex Launcher even though it's a typical bulky GPU-eating overkill Electron app, and have no problem providing a native macOS client. All Jagex would have to do is press a button to compile a Linux version and provide it to players in a tar.gz like Discord does their client, and if Discord can get away with that so can a company charging close to AAA MMORPG monthly subscription prices so shamelessly :p
4)
the log-in session carries over through world switches and even log-outs; Jagex Launcher only needs re-opened if you close the OSRS client window
5)
it's overall better even on Xorg, but not as-nice looking for the few seconds the launcher is really needed :p
/usr/local/www/wiki/data/attic/games/wine/old_school_runescape_jagex_launcher.1689822854.txt.gz · Last modified: by Sean Rhone

Except where otherwise noted, content on this wiki is licensed under the following license: CC0 1.0 Universal
CC0 1.0 Universal Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki