Differences

This shows you the differences between two versions of the page.

--- games:wine:runescape_jagex_launcher [2023/08/20 15:37] – Sean Rhone
+++ games:wine:runescape_jagex_launcher [2024/04/04 09:02] (current) – Sean Rhone
@@ Line 2: / Line 2: @@
   * Jagex Launcher ((https://www.jagex.com/en-GB/launcher))
-  * RuneScape ((http://runescape.com))
+  * RuneScape ((http://runescape.com)) (for Old School RuneScape/OSRS, see [[games:wine:old_school_runescape_jagex_launcher_c|these notes instead]])
   * NXT Client
@@ Line 15: / Line 15: @@
 ===== Notes =====
-  * TODO
+  * Once installed, be sure the game cache is fully-downloaded, and ideally toggle Options -> Textures between ''Compressed'' and ''Uncompressed'' for both caches ((2024/03/24: ''RuneScape'' folder is 10.9 GB))
+====== Disable Legacy GNOME Tray ======
+  * :!: Jagex Launcher sometimes has issues with being interacted with from GNOME tray with the AppIndicator/KStatusNotifierItem support for GNOME Shell extension ((this automatically installs on Fedora through Steam as a dep, and is included out-the-box with Ubuntu 23.10))
+  * Can be an issue on other desktop environments ((2023/12: Xfce on openSUSE TW seemed fine))
+  gnome-extensions disable 'ubuntu-appindicators@ubuntu.com'
+  gnome-extensions disable 'appindicatorsupport@rgcjonas.gmail.com'
+====== Dependencies ======
+****
+  sudo dnf install 'openssl1.1.x86_64' && sync
 ====== Install ======
-===== Jagex Launcher =====
+===== Initial =====
-  * :!: You need to supply your own ''Jagex Launcher'' files as the installer doesn't work ((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 version))
+****
-  * [[https://drive.google.com/file/d/1a0pQ0HooeNp3hV_WJL3nVcfXPA_WPvEj/view?usp=sharing|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
+===== Jagex Launcher =====
+  * :!: You'll need to supply ''Jagex Launcher'' files as the installer doesn't work ((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 version))
+  * See [[notes:jagex_launcher_installer_wine|Jagex Launcher Installer]] notes for installer testing
+==== Google Drive ====
+  * [[https://drive.google.com/file/d/16vg7pOEbIwRjeMCo-fAveVO_YmPCs247/view?usp=sharing|Google Drive]] link to a clean ''Jagex Launcher'' folder with SHA256
+  * Use this if at all unsure
+  sha256sum ~/'Downloads/20240324-Jagex-Launcher.zip' | grep '1544a817d9fbff4377c7ca78701da5c7cf73979c3565fe09aeca4a4710765192' > '/dev/null' && unzip -b -o -qq ~/'Downloads/20240324-Jagex-Launcher.zip' -d ~/'.wine/RuneScape/drive_c/Program Files' && sync
   gio open ~/'.wine/RuneScape/drive_c/Program Files'
-==== Official Installer ====
+==== Manual ====
-  * 2023/07/23: The installer didn't appear to launch or show any GUI
+  * Expects something like ''~/Downloads/20230920-Jagex-Launcher.zip'' with any date
-  * See [[notes:jagex_launcher_installer_wine|Jagex Launcher Installer]] notes for testing
+  * The top-level of the archive should be the ''Jagex Launcher'' folder ((should have file contents like ''20240206-Jagex-Launcher.zip/Jagex Launcher/JagexLauncher.exe''))
+  unzip -b -o -qq ~/'Downloads/'*'Jagex'*'Launcher.zip' -d ~/'.wine/RuneScape/drive_c/Program Files' && sync
+  gio open ~/'.wine/RuneScape/drive_c/Program Files'
 ===== RuneScape =====
@@ Line 42: / Line 70: @@
   * 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
+  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
 ==== RuneScape ====
-****
+  * [[games:runescape_native#version_check|Version-check]] occasionally, as this currently expects ''runescape-launcher_2.2.11_amd64.deb''
+  * Last tested: 2024/04/03 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
-==== Disable Disk Logging ====
+===== runescape-launcher =====
-  * This puts logs into the user's ''/run'' folder which in Fedora's case is ''tmpfs''
-<code>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'</code>
-=== Undo ===
-****
-<code>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'</code>
-====== runescape-launcher ======
+  * :!: See [[games:runescape_native#launcher|RuneScape]] for other graphics cards, notes, and more environment variables
-  * See [[games:runescape_native#launcher|RuneScape]] for other graphics cards and other environment variables
   nano ~/'.wine/RuneScape/Jagex/updater/runescape-launcher'
@@ Line 79: / Line 96: @@
 export SDL_VIDEO_X11_WMCLASS="RuneScape"
-export PULSE_LATENCY_MSEC='100'
-# PulseAudio
-#export SDL_AUDIODRIVER='pulseaudio'
-#export PULSE_PROP_OVERRIDE="application.name='RuneScape' application.icon_name='runescape' media.role='game'"
-# PipeWire
+# Audio
-export SDL_AUDIODRIVER='pipewire'
+#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
@@ Line 95: / Line 110: @@
 # Modern Open/Mesa Graphics
-export MESA_SHADER_CACHE_DIR=~/'Jagex'
+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_glthread='true'
 export MESA_DISK_CACHE_SINGLE_FILE='1'
 export MESA_DISK_CACHE_DATABASE='1'
 unset XMODIFIERS
-~/'.wine/RuneScape/Jagex/updater/runescape --configURI $configURI $@</code>
+~/'.wine/RuneScape/Jagex/updater/runescape' --configURI $configURI $@</code>
-====== Desktop Launcher ======
+===== Clean Up =====
-  * If Jagex Launcher doesn't render or acts differently than when it was ran above, add ''--disable-gpu --disable-software-rasterize'' ((it's assumed that if Vulkan isn't present that the launcher will fallback to its included software renderer ''.dll'' without intervention))
+****
+  rm -f ~/'Downloads/Jagex Launcher Installer.exe' ~/'Downloads/'*'Jagex Launcher.zip' && cd ~ && sync
+====== Desktop Launcher ======
 <code>mkdir -p ~/'.local/share/applications/wine/Programs/Jagex' && nano ~/'.local/share/applications/wine/Programs/Jagex/RuneScape.desktop'</code>
@@ Line 114: / Line 133: @@
 [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' && PULSE_LATENCY_MSEC='400' MESA_SHADER_CACHE_DIR=~/'.wine/RuneScape' WINEPREFIX=~/'.wine/RuneScape' wine ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe'"
+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
@@ Line 124: / Line 142: @@
 [Desktop Action Kill]
-Exec='/bin/bash' -c "WINEPREFIX=~/'.wine/Old School RuneScape' wineserver --kill && killall' -9 'rs2client' 'runescape' 'runescape-launcher'"
+Exec='/bin/bash' -c "WINEPREFIX=~/'.wine/RuneScape' wineserver --kill && killall -9 'rs2client' 'runescape' 'runescape-launcher'"
 Name=Force-close
@@ Line 142: / Line 160: @@
 ===== Winecfg =====
-<code>WINEPREFIX=~/'.wine/Old School RuneScape' winecfg</code>
+****
+<code>WINEPREFIX=~/'.wine/RuneScape' winecfg</code>
 ===== Winetricks =====
-<code>WINEPREFIX=~/'.wine/Old School RuneScape' winetricks</code>
+****
+<code>WINEPREFIX=~/'.wine/RuneScape' winetricks</code>
 ===== Registry Editor =====
-<code>WINEPREFIX=~/'.wine/Old School RuneScape' regedit</code>
+****
+<code>WINEPREFIX=~/'.wine/RuneScape' regedit</code>
 ===== Kill =====
-<code>WINEPREFIX=~/'.wine/Old School RuneScape' wineserver --kill</code>
+****
+<code>WINEPREFIX=~/'.wine/RuneScape' wineserver --kill && killall' -9 'rs2client' 'runescape' 'runescape-launcher'</code>
 ===== Execute =====
@@ Line 160: / Line 186: @@
 ==== Jagex Launcher ====
-  * ''PULSE_LATENCY_MSEC=400'' [[https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1769#note_1146786|source]] ((required to fix audio glitches present in music even on Fedora 38 where PipeWire is used))
+<code>cd ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher' && </code>
-<code>cd ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher' && </code>
-<code>MESA_LOADER_DRIVER_OVERRIDE='zink' MESA_VK_WSI_PRESENT_MODE='immediate'</code>
-<code>PULSE_LATENCY_MSEC='400' MESA_SHADER_CACHE_DIR=~/'.wine/Old School RuneScape' WINEPREFIX=~/'.wine/Old School RuneScape' wine ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe'</code>
+<code>MESA_SHADER_CACHE_DIR=~/'.wine/RuneScape' WINEPREFIX=~/'.wine/RuneScape' wine ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe'</code>
 ==== Troubleshooting ====
@@ Line 184: / Line 206: @@
 ****
-  gio open ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/'
+  gio open ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher/'
-==== Old School RuneScape ====
+==== Cache ====
-****
+  * All the ''.jcache'' files can be backed-up and restored, but ideally exclude ''GlobalSettings.jcache'', ''ObjCache.jcache'', and ''ShaderManager.jcache'' ((2024/04/04: Full cache is around ''11.3 GB''))
-<code>gio open ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/Games/Old School RuneScape/Client/'</code>
+<code>mkdir -p ~/'Jagex/RuneScape' && gio open ~/'Jagex/RuneScape/'</code>