• Jagex Launcher ¹⁾
• Old School RuneScape ²⁾
• Legacy Java Client

• 2023/07/23: The legacy Java client is deprecated! (news post)
• 2023/07/23: These notes won't work with the current linked Jagex Launcher folder since there's not a previous OSRS Java install present and these notes are mainly here for historical reference; see the C++ version instead!
• TODO: The Java legacy option shows in Jagex Launcher if the old OldSchool.msi (non Jagex-Launcher/Java) is installed; presumably the Java version can still work in 2024, but wine is still needed for Jagex Launcher

• This allows running the Jagex Launcher through wine, while keeping OSRS ran natively through java
• 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 ³⁾
• 2023/07/23: This cannot be installed along-side the C++ version with current notes since they share the same Wine Prefix location; TODO: Change Wine prefix names for OSRS Java

• Fedora Workstation
• Wine

• i915 on GNOME 44 shows notable tearing on OSRS when rotating the camera from Xorg, but not Wayland

• wmctrl is used to toggle between windowed and fullscreen states

sudo dnf install java-11-openjdk wmctrl && sync

• You need to supply your own Jagex Launcher files as the installer doesn't work ⁴⁾
• Google Drive link to a clean Jagex Launcher folder with SHA256 below

mkdir -p ~/'.wine' && WINEPREFIX=~/'.wine/Old School RuneScape' WINEARCH='win32' wineboot && sync

sha256sum ~/'Downloads/20230709 Jagex Launcher.zip' | grep '0f68835338fedf1e51ee252ab2b7e08b99c21d24d89c9bf85d7d113524151fe9' > '/dev/null' && unzip -b -o -qq ~/'Downloads/20230709 Jagex Launcher.zip' -d ~/'.wine/Old School RuneScape/drive_c/Program Files' && sync

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

• If the installer ever works, this is the preferred installation method
• 2023/07/19: The installer didn't appear to launch or show any GUI

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 explorer /desktop='Jagex-Launcher','1280x720' ~/'Downloads/Jagex Launcher Installer.exe'

• 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 explorer /desktop='Jagex-Launcher','1280x720' ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe' --disable-gpu --disable-software-rasterizer

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

• Source for the symlink advice
• Re-run this command and change sun.java2d.uiScale to adjust UI scaling level

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

• 2023/07/19: Cache clean-up command TODO

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 explorer /desktop='Jagex-Launcher','1280x720' '/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.'"
Exec='/bin/bash' -c "sync && notify-send 'The cache cleanup option is not implemented yet.'"
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_java'
Name=Installation Notes

• The icon provided from the macOS .dmg is higher-res than the one in the Windows .msi
• .icns isn't a valid image file format according to Freedesktop.org Specifications so this isn't in the standard icon folder

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

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

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

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

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

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'

WINEDEBUG=''

explorer /desktop='Jagex-Launcher','1280x720'

--disable-gpu --disable-software-rasterizer

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

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