| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| games:wine:runescape_jagex_launcher [2024/02/08 19:13] – Sean Rhone | games:wine:runescape_jagex_launcher [2024/08/06 09:45] (current) – removed Sean Rhone |
|---|
| ====== Information ====== | |
| |
| * Jagex Launcher ((https://www.jagex.com/en-GB/launcher)) | |
| * RuneScape ((http://runescape.com)) (for Old School RuneScape/OSRS, see [[games:wine:old_school_runescape_jagex_launcher_c|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 ((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)) | |
| |
| ===== Prerequisites ===== | |
| |
| * [[distros:fedora_workstation_gnome|Fedora Workstation]] | |
| * [[notes:wine|Wine]] | |
| |
| ===== Notes ===== | |
| |
| * Be sure the cache is fully-downloaded, and ideally toggle Options -> Textures between ''Compressed'' and ''Uncompressed'' for both caches | |
| |
| ====== 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 seemed fine with openSUSE TW)) | |
| |
| gnome-extensions disable 'ubuntu-appindicators@ubuntu.com' | |
| |
| gnome-extensions disable 'appindicatorsupport@rgcjonas.gmail.com' | |
| |
| ====== Dependencies ====== | |
| |
| **** | |
| |
| sudo dnf install 'openssl1.1.x86_64' && sync | |
| |
| ====== Install ====== | |
| |
| ===== Initial ===== | |
| |
| **** | |
| |
| mkdir -p ~/'.wine' && WINEPREFIX=~/'.wine/RuneScape' WINEARCH='win64' wineboot && 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/1a0pQ0HooeNp3hV_WJL3nVcfXPA_WPvEj/view?usp=sharing|Google Drive]] link to a clean ''Jagex Launcher'' folder with SHA256 | |
| * Use this if at all unsure | |
| |
| 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' | |
| |
| ==== Manual ==== | |
| |
| * Expects something like ''~/Downloads/20230920-Jagex-Launcher.zip'' with any date | |
| * 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 ===== | |
| |
| ==== Jagex Launcher ==== | |
| |
| * Update launcher if prompted, log-in, select RuneScape -> Install | |
| * Fully-exit Jagex Launcher after installation | |
| |
| 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/02/08 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 | |
| |
| ===== runescape-launcher ===== | |
| |
| * :!: See [[games:runescape_native#launcher|RuneScape]] for other graphics cards, notes, and more environment variables | |
| |
| nano ~/'.wine/RuneScape/Jagex/updater/runescape-launcher' | |
| |
| <code> | |
| #!/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 $@</code> | |
| |
| ===== Clean Up ===== | |
| |
| **** | |
| |
| 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> | |
| |
| <code> | |
| [Desktop Entry] | |
| Name=RuneScape | |
| 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' --disable-gpu --disable-software-rasterizer" | |
| 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</code> | |
| |
| ====== Quick Commands ====== | |
| |
| ===== Winecfg ===== | |
| |
| **** | |
| |
| <code>WINEPREFIX=~/'.wine/RuneScape' winecfg</code> | |
| |
| ===== Winetricks ===== | |
| |
| **** | |
| |
| <code>WINEPREFIX=~/'.wine/RuneScape' winetricks</code> | |
| |
| ===== Registry Editor ===== | |
| |
| **** | |
| |
| <code>WINEPREFIX=~/'.wine/RuneScape' regedit</code> | |
| |
| ===== Kill ===== | |
| |
| **** | |
| |
| <code>WINEPREFIX=~/'.wine/RuneScape' wineserver --kill && killall' -9 'rs2client' 'runescape' 'runescape-launcher'</code> | |
| |
| ===== Execute ===== | |
| |
| ==== Jagex Launcher ==== | |
| |
| <code>cd ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher' && </code> | |
| |
| <code>MESA_SHADER_CACHE_DIR=~/'.wine/RuneScape' WINEPREFIX=~/'.wine/RuneScape' wine ~/'.wine/RuneScape/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe'</code> | |
| |
| ==== Troubleshooting ==== | |
| |
| * Wine's virtual desktop may be necessary with certain desktop/window managers and with Wayland | |
| |
| <code>WINEDEBUG=''</code> | |
| |
| <code>explorer /desktop='Jagex-Launcher','1280x720'</code> | |
| |
| <code>--disable-gpu --disable-software-rasterizer</code> | |
| |
| ===== 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 exclude ''GlobalSettings.jcache'', ''ObjCache.jcache'', and ''ShaderManager.jcache'' ((2023/08/20: Full cache is around ''10.6 GB'')) | |
| |
| <code>gio open ~/'.wine/RuneScape/drive_c/ProgramData/Jagex/RuneScape/'</code> | |
| |
