====== Information ======

  * Jagex Launcher ((https://www.jagex.com/en-GB/launcher))
  * 32-bit ((the launcher is 32-bit but games are native arch))

  * 2023/07/31: These notes provide native Linux OSRS RuneLite and NXT RuneScape (RS3) game clients
  * If looking to **only** play OSRS and use the C++ client, see [[games:wine:old_school_runescape_jagex_launcher_c|C++ notes]]

===== Prerequisites =====

  * [[distros:fedora_workstation_gnome|Fedora Workstation]]
  * [[notes:wine|Wine]]

====== Install ======

===== 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
  * [[https://drive.google.com/file/d/1e8QmSuo5OzcUGFiIUcr9tKX3gq83BlVb/view?usp=sharing|Google Drive]] link to a clean ''Jagex Launcher'' folder

  mkdir -p ~/'.wine' && WINEPREFIX=~/'.wine/Jagex Launcher' WINEARCH='win32' wineboot && sync

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

==== Official Installer ====

  * 2023/06/12: The launcher nor any GUI appeared even with a virtual desktop
  * If the installer ever works, the above ''Jagex Launcher'' folder copy stuff above can be ignored

  mkdir -p ~/'.wine' && wget 'https://cdn.jagex.com/Jagex%20Launcher%20Installer.exe' -O ~/'Downloads/Jagex Launcher Installer.exe' && WINEPREFIX=~/'.wine/Jagex Launcher' WINEARCH='win32' wine ~/'Downloads/Jagex Launcher Installer.exe'

====== Old School RuneScape ======

===== RuneLite =====

==== AppImage ====

  * Expects ''RuneLite.AppImage'' in ''~/Downloads''

  gio open 'https://runelite.net/'

  mkdir -p ~/'.wine/Jagex Launcher/drive_c/users/'$USER'/AppData/Local/RuneLite' && mv --force ~/'Downloads/RuneLite.AppImage' ~/'.wine/Jagex Launcher/drive_c/users/'$USER'/AppData/Local/RuneLite' && chmod +x ~/'.wine/Jagex Launcher/drive_c/users/'$USER'/AppData/Local/RuneLite/RuneLite.AppImage' && sync

==== Launch Script ====

  nano ~/'.wine/Jagex Launcher/drive_c/users/'$USER'/AppData/Local/RuneLite/RuneLite.sh' && chmod +x ~/'.wine/Jagex Launcher/drive_c/users/'$USER'/AppData/Local/RuneLite/RuneLite.sh' && ln --symbolic --force ~/'.wine/Jagex Launcher/drive_c/users/'$USER'/AppData/Local/RuneLite/RuneLite.sh' ~/'.wine/Jagex Launcher/drive_c/users/'$USER'/AppData/Local/RuneLite/RuneLite.exe'

<code>
#!/bin/bash
cd "${0%/*}"

export MESA_SHADER_CACHE_DIR=~/'.runelite'

./RuneLite.AppImage --disable-telemetry --J=-XX:+UseConcMarkSweepGC

# End</code>

==== Install ====

****

  WINEPREFIX=~/'.wine/Jagex Launcher' wine reg add 'HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Uninstall\RuneLite Launcher_is1' /v 'InstallLocation' /t 'REG_SZ' /d 'C:\users\'$USER'\AppData\Local\RuneLite\' /f

==== Launch ====

  * Update launcher if prompted, log-in, select OSRS -> RuneLite -> Play

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

====== RuneScape ======

  * See [[games:runescape_native]]

===== Jagex Launcher =====

  * Update launcher if prompted, log-in, select RuneScape -> Install

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

===== Launch Script =====

****

<code>ln --backup --symbolic --force ~/'Jagex/updater/runescape-launcher' ~/'.wine/Jagex Launcher/drive_c/Program Files/Jagex Launcher/Games/RuneScape/RuneScape.exe'</code>

====== Desktop Launcher ======

  mkdir -p ~/'.local/share/applications/wine/Programs/Jagex' && nano ~/'.local/share/applications/wine/Programs/Jagex/Jagex Launcher.desktop' && sed -i 's/'CHANGEME'/'$USER'/g' ~/'.local/share/applications/wine/Programs/Jagex/Jagex Launcher.desktop'

<code>
[Desktop Entry]
Name=Jagex Launcher
Comment=The Jagex Launcher allows you to access Jagex games seamlessly and securely, all in one place and with the safety and convenience of a single login.
Categories=Game
Exec=env WINEPREFIX='/home/CHANGEME/.wine/Jagex Launcher' wine '/home/CHANGEME/.wine/Jagex Launcher/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe' --disable-gpu --disable-software-rasterizer
#Exec=env WINEPREFIX='/home/CHANGEME/.wine/Jagex Launcher' wine explorer /desktop='Jagex-Launcher','1440x900' '/home/CHANGEME/.wine/Jagex Launcher/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe' --disable-gpu --disable-software-rasterizer
Type=Application
StartupNotify=true
Path=/home/CHANGEME/.wine/Jagex Launcher/drive_c/Program Files/Jagex Launcher
Icon=TODO.0
Actions=Kill;

[Desktop Action Kill]
Exec=env WINEPREFIX='/home/CHANGEME/.wine/Jagex Launcher' wineserver --kill
Name=Force-close</code>

====== Quick Commands ======

===== Winecfg =====

****

  WINEPREFIX=~/'.wine/Jagex Launcher' winecfg

===== Winetricks =====

****

  WINEPREFIX=~/'.wine/Jagex Launcher' winetricks

===== Registry Editor =====

****

  WINEPREFIX=~/'.wine/Jagex Launcher' regedit

===== Kill =====

****

  WINEPREFIX=~/'.wine/Jagex Launcher' wineserver --kill

===== Execute =====

==== Jagex Launcher ====

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

  WINEDEBUG=''

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

<code>--disable-gpu --disable-software-rasterizer</code>

<code>--single-process</code>

===== File Manager =====

==== Jagex Launcher ====

****

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

==== Old School RuneScape ====

=== Java ===

****

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

=== RuneLite ===

****

  gio open ~/'.runelite/'

==== RuneScape ====

****

  gio open ~/'Jagex/'