| Next revision | Previous revision |
| games:bsd:wine:old_school_runescape_jagex_launcher_c [2025/08/30 00:51] – created Sean Rhone | games:bsd:wine:old_school_runescape_jagex_launcher_c [2026/06/28 00:14] (current) – [Prerequisites] Sean Rhone |
|---|
| ====== Information ====== | ====== Information ====== |
| |
| * Jagex Launcher ((https://www.jagex.com/en-GB/launcher)) | * Old School RuneScape ((https://oldschool.runescape.com/)) |
| * Old School RuneScape ((http://oldschool.runescape.com)) (for RuneScape/RS3, see [[games;linux;wine;runescape_nxt_jagex_launcher|these notes instead]]) | * Jagex Launcher ((https://support.runescape.com/hc/en-gb/articles/34153164257425-Jagex-Launcher-FAQ)) |
| * C++ Client | * C++ Client |
| |
| * Jagex Launcher can be closed after pressing ''Play'' and the OSRS client window appears ((the log-in session carries over through world switches and even log-outs; Jagex Launcher only needs to be re-opened if you close the OSRS client window)) | * Jagex Launcher can be closed after pressing ''Play'' and the OSRS client window appears ((the log-in session carries over through world switches and even log-outs; Jagex Launcher only needs to be re-opened if you close the OSRS client window)) |
| |
| ===== Media ===== | * :!: 2026/06/27: WIP ([[https://forums.freebsd.org/threads/what-about-gaming-on-freebsd.723/page-13#post-715021|post]]) |
| | |
| * [[https://www.youtube.com/watch?v=dThU5GKjNRo|Installation Video]] | |
| |
| ===== Prerequisites ===== | ===== Prerequisites ===== |
| |
| * [[linux;distros;opensuse_tumbleweed_gnome|openSUSE Tumbleweed (GNOME)]] ((2025/08/28: Works perfect still after all this time :p)) | * [[bsd:freebsd_15.1_xfce|FreeBSD 15.1 (Xfce)]] |
| * [[linux:notes:wine|Wine]] | * [[bsd;notes;wine|Wine]] (old WoW64) |
| |
| ===== Notes ===== | ===== Notes ===== |
| * On the first OSRS client launch, it may start an invisible game window; Close ''osclient.exe'' and re-launch it from Jagex Launcher ((on Windows this seems to manifests as a //visible// game window that doesn't appear in the taskbar; OSRS defies typical window-management logic :p presumably when it tries to define a default window position on first-launch)) | * On the first OSRS client launch, it may start an invisible game window; Close ''osclient.exe'' and re-launch it from Jagex Launcher ((on Windows this seems to manifests as a //visible// game window that doesn't appear in the taskbar; OSRS defies typical window-management logic :p presumably when it tries to define a default window position on first-launch)) |
| * :!: When first launching OSRS after installation, at the lobby before pressing Play Now, allow OSRS to download its full data cache ((2024/04/29: It downloads around 500 KB/s and bandwidth can be observed through GNOME System Monitor; should be done within a few minutes)) | * :!: When first launching OSRS after installation, at the lobby before pressing Play Now, allow OSRS to download its full data cache ((2024/04/29: It downloads around 500 KB/s and bandwidth can be observed through GNOME System Monitor; should be done within a few minutes)) |
| |
| ====== 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)) | |
| * 2024/04: The Jagex Launcher tray icon was fine on Xfce and KDE Plasma 6, so presumably this only applies to GNOME | |
| |
| gnome-extensions disable 'appindicatorsupport@rgcjonas.gmail.com' | |
| |
| gnome-extensions disable 'ubuntu-appindicators@ubuntu.com' | |
| |
| ====== Install ====== | ====== Install ====== |
| |
| * :!: 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 or [[#manual|zipped to continue following these notes]]; you don't need to log-in but ideally run it once after installation for it to update to the latest version)) | * :!: 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 or [[#manual|zipped to continue following these notes]]; you don't need to log-in but ideally run it once after installation for it to update to the latest version)) |
| * See [[games;linux;wine;jagex_launcher|Jagex Launcher Installer]] notes for installer testing | |
| |
| ==== Google Drive ==== | ==== Google Drive ==== |
| * [[https://drive.google.com/file/d/1ycvSFHTCXNQ7kXnPTS8XHFg__qgfB2ti/view?usp=sharing|Google Drive]] link to a clean ''Jagex Launcher'' folder with SHA256 | * [[https://drive.google.com/file/d/1ycvSFHTCXNQ7kXnPTS8XHFg__qgfB2ti/view?usp=sharing|Google Drive]] link to a clean ''Jagex Launcher'' folder with SHA256 |
| * Use this if at all unsure | * Use this if at all unsure |
| | * :?: [[https://drive.google.com/file/d/1jKDfv6PVew-774eXp_-FkOEzSjPJDpEc/view?usp=sharing|2026-06-27 Test]] |
| |
| sha256sum ~/'Downloads/20240509-Jagex-Launcher.zip' | grep 'bc143b9cafbf6d735193d64e486be5015d4a4e857c61329e1a49f7143987789d' > '/dev/null' && unzip -b -o -qq ~/'Downloads/20240509-Jagex-Launcher.zip' -d ~/'.wine/Old School RuneScape/drive_c/Program Files' && sync | sha256sum ~/'Downloads/20240509-Jagex-Launcher.zip' | grep 'bc143b9cafbf6d735193d64e486be5015d4a4e857c61329e1a49f7143987789d' > '/dev/null' && unzip -b -o -qq ~/'Downloads/20240509-Jagex-Launcher.zip' -d ~/'.wine/Old School RuneScape/drive_c/Program Files' && sync |
| ====== Settings ====== | ====== Settings ====== |
| |
| * 1080p, fullscreen, max draw distance, MSAA x4, W416, Nearest-neighbour UI scaling | mkdir -p ~/'.wine/Old School RuneScape/drive_c/users/'$USER'/AppData/Local/Jagex/Old School Runescape' && ee ~/'.wine/Old School RuneScape/drive_c/users/'$USER'/AppData/Local/Jagex/Old School Runescape/preferences_client.dat' |
| * :!: If using Wayland, set ''FpsLimit'' to the screen's refresh rate to prevent uncapped framerates ((changing the in-game Framerate limit option to anything will overwrite whatever was specified, including going back to ''0'' with Unlimited)) | |
| |
| * Last updated: 2024/01/31 | rm ~/'.wine/Old School RuneScape/drive_c/users/'$USER'/AppData/Local/Jagex/Old School Runescape/preferences_client.dat' && ee ~/'.wine/Old School RuneScape/drive_c/users/'$USER'/AppData/Local/Jagex/Old School Runescape/preferences_client.dat' |
| | |
| mkdir -p ~/'.wine/Old School RuneScape/drive_c/users/'$USER'/AppData/Local/Jagex/Old School Runescape' && nano ~/'.wine/Old School RuneScape/drive_c/users/'$USER'/AppData/Local/Jagex/Old School Runescape/preferences_client.dat' | |
| |
| <code> | <code> |
| | AFKTimeout 25 |
| | AnisotropyExponent 0 |
| AntiAliasingSampleLevel 2 | AntiAliasingSampleLevel 2 |
| Brightness 0 | BackgroundFpsLimit 15 |
| DefaultWorldId 416 | Brightness 55 |
| DisplayBuildInfo 0 | DisplayBuildInfo 0 |
| DisplayFps 0 | DisplayFps 0 |
| DrawDistance 90 | DrawDistance 90 |
| | ForceDisableRSeven 1 |
| FpsLimit 0 | FpsLimit 0 |
| Fullscreen 1 | Fullscreen 0 |
| HideUserName 0 | HideUserName 0 |
| LastWorldId 416 | IsSfx8Bit 0 |
| | LastWorldId 393 |
| | MasterVolume 100 |
| | TermsAndPrivacy -1 |
| MasterVolume 100 | MasterVolume 100 |
| TitleVolume 100 | TitleVolume 100 |
| UIQuality 0 | UIQuality 0 |
| WindowHeight 1080 | WindowHeight 671 |
| WindowMode 2 | WindowMode 2 |
| WindowTopmost 0 | WindowTopmost 0 |
| WindowWidth 1920</code> | WindowWidth 1089</code> |
| | |
| ===== Steam ===== | |
| | |
| * ''preferences_client.dat'' if OSRS is installed through Steam and ran through Proton | |
| | |
| mkdir -p ~/'.local/share/Steam/steamapps/compatdata/1343370/pfx/drive_c/users/steamuser/AppData/Local/Jagex/Old School Runescape' && nano ~/'.local/share/Steam/steamapps/compatdata/1343370/pfx/drive_c/users/steamuser/AppData/Local/Jagex/Old School Runescape/preferences_client.dat' | |
| |
| ====== Desktop Launcher ====== | ====== Desktop Launcher ====== |
| **** | **** |
| |
| WINEPREFIX=~/'.wine/Old School RuneScape' winecfg | WINEPREFIX=~/'.wine/Old School RuneScape' wine64 winecfg |
| |
| ===== Winetricks ===== | ===== Winetricks ===== |
| **** | **** |
| |
| WINEPREFIX=~/'.wine/Old School RuneScape' regedit | WINEPREFIX=~/'.wine/Old School RuneScape' wine64 regedit |
| |
| ===== Kill ===== | ===== Kill ===== |
| ==== Jagex Launcher ==== | ==== Jagex Launcher ==== |
| |
| * This has no enforced Vsync nor Zink usage | **** |
| | |
| <code>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 --single-process --silent --launch='osrs'</code> | |
| | |
| ==== Vsync ==== | |
| | |
| * ''vblank_mode=3'' | |
| |
| <code>cd ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher' && vblank_mode='3' WINEPREFIX=~/'.wine/Old School RuneScape' wine ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe' --disable-gpu --disable-software-rasterizer --single-process --silent --launch='osrs'</code> | <code>cd ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher' && vblank_mode='3' WINEPREFIX=~/'.wine/Old School RuneScape' wine ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/JagexLauncher.exe' --disable-gpu --disable-software-rasterizer --single-process --silent --launch='osrs'</code> |
| |
| ==== Troubleshooting ==== | |
| |
| * Wine's virtual desktop may be necessary with certain desktop/window managers and with Wayland | |
| |
| <code>explorer /desktop='Jagex-Launcher','1280x720'</code> | |
| |
| ===== File Manager ===== | |
| |
| ==== Jagex Launcher ==== | |
| |
| **** | |
| |
| gio open ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/' | |
| |
| ==== Old School RuneScape ==== | |
| |
| **** | |
| |
| <code>gio open ~/'.wine/Old School RuneScape/drive_c/Program Files/Jagex Launcher/Games/Old School RuneScape/Client/'</code> | |
| |
