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

  * Old School RuneScape ((http://oldschool.runescape.com))
  * RuneLite ((https://runelite.net/))

====== Notes ======

  * :!: 117 HD plugin caused ''amdgpu'' driver to crash (see [[https://github.com/RS117/RLHD/issues/307|#307]])
  * Disabling **Compute Shaders** with the built-in GPU plug-in improves performance, but may prevent increasing view distance beyond the default ''25''
  * :!: **Anisotropic Filtering** with the built-in GPU plug-in set to any value other than ''0'' causes fishing spots in water to become significantly more subtle and harder to see, notably affects Tree textures, and seemingly is the cause for blurry things in-general

===== Worlds =====

==== Lowest Latency ====

  * Last checked: 2023/05/18 US East

  * 354 - Castle Wars 2
  * 362 - TzHaar Fight Pit
  * 369 - Wilderness PK - Members
  * 370 - Fishing Trawler
  * 377 - Mort'ton temple, Rat Pits

==== Specific ====

  * 344 - Pest Control
  * 353 - 1250 skill total (US)

====== Ubuntu ======

  * https://snapcraft.io/runelite

  sudo snap install 'runelite' && sync

====== Download ======

  * https://runelite.net/ ((If at all in-doubt, go to the [[https://oldschool.runescape.com/|OSRS home page]] and click RuneLite from their sidebar))

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

====== Install/Update ======

===== Java =====

==== Dependencies ====

  * [[distros:fedora_workstation_gnome|Fedora Workstation]]
  * 2023/03/21: LWJGL reports ''Unsupported JNI version'' for Java 19, but seems to work fine
  * :!: If Steam hooking is wanted, use [[#appimage|the AppImage]] instead

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

==== Set Default Java ====

****

  sudo update-alternatives --config 'java'

==== RuneLite ====

  * This expects ''RuneLite.jar'' to be in the ''~/Downloads'' folder

  mkdir -p ~/'.local/bin/runelite' ~/'.runelite' && mv --force --verbose ~/'Downloads/RuneLite.jar' ~/'.local/bin/runelite' && chmod +x ~/'.local/bin/runelite/RuneLite.jar' && sync

===== AppImage =====

  * This expects ''RuneLite.AppImage'' from ''Linux (x64)'' to be in the ''~/Downloads'' folder

  mkdir -p ~/'.local/bin/runelite' ~/'.runelite' && mv --force --verbose ~/'Downloads/RuneLite.AppImage' ~/'.local/bin/runelite' && chmod +x ~/'.local/bin/runelite/RuneLite.AppImage' && sync

===== SELinux =====

****

  sudo restorecon -F -I -R ~/'.local/bin/runelite' && sync

====== Launcher ======

  * :!: Adjust ''# Launch'' if using AppImage instead of Java

  nano ~/'.local/bin/runelite/runelite.sh' && chmod +x ~/'.local/bin/runelite/runelite.sh' && sync

<code>
#!/bin/bash

# Working Directory
cd ~/'.runelite'

export MESA_SHADER_CACHE_DIR=~/'.runelite'
export _JAVA_OPTIONS='-XX:+UseConcMarkSweepGC'

# Launch

# Java
java -jar ~/'.local/bin/runelite/RuneLite.jar' --disable-telemetry

# AppImage
#~/'.local/bin/runelite/RuneLite.AppImage' --disable-telemetry --J=-XX:+UseConcMarkSweepGC

# End</code>

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

===== RuneLite =====

  mkdir -p ~/'.local/share/applications' && nano ~/'.local/share/applications/RuneLite.desktop'

<code>
[Desktop Entry]
Name=RuneLite
Comment=A popular free, open-source and super fast client for Old School RuneScape
Categories=Game;Java;AdventureGame;RolePlaying
Exec='/home/CHANGEME/.local/bin/runelite/runelite.sh'
Type=Application
StartupNotify=true
Path=/home/CHANGEME/.runelite
Icon=/home/CHANGEME/.runelite/icon.png
Actions=Screen;Cache;Notes;

[Desktop Action Screen]
StartupNotify=false
Exec='/usr/bin/wmctrl' -r 'net-runelite-client-RuneLite.net-runelite-client-RuneLite' -x -b 'toggle,fullscreen'
Name=Toggle Fullscreen/Windowed

[Desktop Action Cache]
StartupNotify=false
Exec='/bin/bash' -c "rm -Rf '/home/CHANGEME/.runelite/cache' '/home/CHANGEME/.runelite/jagexcache' '/home/CHANGEME/.runelite/mesa_shader_cache'* '/home/CHANGEME/.runelite/jagex_cl_oldschool_LIVE.dat' '/home/CHANGEME/.runelite/random.dat' '/home/CHANGEME/.runelite/'*'.log' '/tmp/oldschool' && sync && notify-send 'The RuneLite cache has been cleaned.'"
Name=Cache Cleanup

[Desktop Action Notes]
StartupNotify=false
Exec=gio open 'https://wiki.realmofespionage.xyz/games:old_school_runescape_runelite'
Name=Installation Notes</code>

  sed -i 's/'CHANGEME'/'$USER'/g' ~/'.local/share/applications/RuneLite.desktop'