Both sides previous revisionPrevious revisionNext revision | Previous revision |
games:linux:rt4_client_runescape_530 [2024/11/02 06:18] – [Dependencies] Sean Rhone | games:linux:rt4_client_runescape_530 [2025/05/16 21:39] (current) – external edit 127.0.0.1 |
---|
| |
* RT4 Client ((https://gitlab.com/2009scape/rt4-client)) | * RT4 Client ((https://gitlab.com/2009scape/rt4-client)) |
* ''master'' Branch ((https://gitlab.com/2009scape/rt4-client/-/tree/master?ref_type=heads)) | |
| * These notes provide a game client for 2009Scape |
| * Last tested commit: [[https://gitlab.com/2009scape/rt4-client/-/commit/cd081deb896dc7280da547220074375bb9150a21|cd081deb]] |
| |
===== Prerequisites ===== | ===== Prerequisites ===== |
| |
* [[linux;distros;fedora_workstation_gnome|Fedora Workstation]] | * [[linux;distros;opensuse_tumbleweed_gnome|openSUSE Tumbleweed (GNOME)]] |
| |
| ===== Resources ===== |
| |
| * [[https://cdn.2009scape.org/wiki/quest_guides/quest_guides|Quest Guides]] |
| * [[https://cdn.2009scape.org/wiki/quest_guides/quest_experience_by_skill|Quest Experience by Skill]] |
| |
===== Notes ===== | ===== Notes ===== |
| |
* :!: This is for private server use | * :!: This is for private server use |
* See [[servers:linux:games:2009scape_localhost|2009Scape localhost Server]] to set-up a local server | * See [[servers:linux:games:2009scape_localhost|2009Scape localhost Server]] to set-up a server |
| |
====== Dependencies ====== | ====== Dependencies ====== |
| |
* https://gitlab.com/2009scape/rt4-client#instructions | * https://gitlab.com/2009scape/rt4-client#instructions |
* Builds with Java 17 but uses system-wide for running Client ((2024/11/02: F41 is OpenJDK 21 and default-installs non-GUI ''headless'')) ((2024/11/02: 2009Scape's RT4-Client [[https://gitlab.com/2009scape/rt4-client/-/blob/master/gradle/wrapper/gradle-wrapper.properties?ref_type=heads#L3|forces Gradle 7.4.2]] which only supports up to Java 17; [[games:linux:rt4_client_runescape_530?rev=1730467025|Pazaz's older RT4-Client]] builds fine on Java 23)) | |
| |
sudo dnf install git-core java-17-openjdk-headless java-openjdk | sudo zypper install git-core java-17-openjdk-headless java-21-openjdk |
| |
====== Download Source ====== | ====== Download Source ====== |
| |
**** | * https://gitlab.com/2009scape/rt4-client/-/commits/master?ref_type=heads |
| |
cd ~ && mkdir -p ~/'Projects' && rm -Rf ~/'Projects/RT4-Client/src' && git clone --branch 'master' --depth '1' --recurse-submodules 'https://gitlab.com/2009scape/rt4-client.git' ~/'Projects/RT4-Client/src' && sync | cd ~ && mkdir -p ~/'Projects' && rm -Rf ~/'Projects/RT4-Client/src' && git clone --branch 'master' --depth '1' --recurse-submodules 'https://gitlab.com/2009scape/rt4-client.git' ~/'Projects/RT4-Client/src' && sync |
| |
====== Build ====== | ====== Build ====== |
| |
| ===== Settings ===== |
| |
| sed -i 's/USE_TWEENING = true/USE_TWEENING = false/g' ~/'Projects/RT4-Client/src/client/src/main/java/rt4/GlobalConfig.java' |
| |
| sed -i 's/BILINEAR_MINIMAP = true/BILINEAR_MINIMAP = false/g' ~/'Projects/RT4-Client/src/client/src/main/java/rt4/GlobalConfig.java' |
| |
| sed -i 's/USE_SHIFT_CLICK = true/USE_SHIFT_CLICK = false/g' ~/'Projects/RT4-Client/src/client/src/main/java/rt4/GlobalConfig.java' |
| |
| sed -i 's/MOUSEWHEEL_ZOOM = true/MOUSEWHEEL_ZOOM = false/g' ~/'Projects/RT4-Client/src/client/src/main/java/rt4/GlobalConfig.java' |
| |
| cat ~/'Projects/RT4-Client/src/client/src/main/java/rt4/GlobalConfig.java' | grep 'public static boolean' |
| |
| gnome-text-editor ~/'Projects/RT4-Client/src/client/src/main/java/rt4/GlobalConfig.java' |
| |
| ===== Build ===== |
| |
**** | **** |
| |
cd ~/'Projects/RT4-Client/src' && JAVA_HOME='/usr/lib/jvm/jre-17-openjdk' ~/'Projects/RT4-Client/src/gradlew' 'clean' && JAVA_HOME='/usr/lib/jvm/jre-17-openjdk' ~/'Projects/RT4-Client/src/gradlew' 'jar' && ~/'Projects/RT4-Client/src/gradlew' --stop | cd ~/'Projects/RT4-Client/src' && JAVA_HOME='/usr/lib64/jvm/jre-17-openjdk' ~/'Projects/RT4-Client/src/gradlew' 'clean' --no-daemon && JAVA_HOME='/usr/lib64/jvm/jre-17-openjdk' ~/'Projects/RT4-Client/src/gradlew' 'jar' --no-daemon |
| |
====== Settings ====== | ====== Settings ====== |
| |
===== Client Update ===== | ===== Client Update ===== |
| |
* [[https://gitlab.com/2009scape/rt4-client/-/commits/master|Commits History]] | |
* [[#scape_localhost|Desktop Action Client-Update]] | |
| |
mkdir -p ~/'Projects/RT4-Client/scripts' && nano ~/'Projects/RT4-Client/scripts/client-update.sh' && chmod +x ~/'Projects/RT4-Client/scripts/client-update.sh' | mkdir -p ~/'Projects/RT4-Client/scripts' && nano ~/'Projects/RT4-Client/scripts/client-update.sh' && chmod +x ~/'Projects/RT4-Client/scripts/client-update.sh' |
git -C ~/'Projects/RT4-Client/src' reset --hard | git -C ~/'Projects/RT4-Client/src' reset --hard |
git -C ~/'Projects/RT4-Client/src' pull origin 'master' --rebase | git -C ~/'Projects/RT4-Client/src' pull origin 'master' --rebase |
| |
| sed -i 's/USE_TWEENING = true/USE_TWEENING = false/g' ~/'Projects/RT4-Client/src/client/src/main/java/rt4/GlobalConfig.java' |
| sed -i 's/BILINEAR_MINIMAP = true/BILINEAR_MINIMAP = false/g' ~/'Projects/RT4-Client/src/client/src/main/java/rt4/GlobalConfig.java' |
| sed -i 's/USE_SHIFT_CLICK = true/USE_SHIFT_CLICK = false/g' ~/'Projects/RT4-Client/src/client/src/main/java/rt4/GlobalConfig.java' |
| sed -i 's/MOUSEWHEEL_ZOOM = true/MOUSEWHEEL_ZOOM = false/g' ~/'Projects/RT4-Client/src/client/src/main/java/rt4/GlobalConfig.java' |
| |
cd ~/'Projects/RT4-Client/src' | cd ~/'Projects/RT4-Client/src' |
JAVA_HOME='/usr/lib/jvm/jre-17-openjdk' ~/'Projects/RT4-Client/src/gradlew' 'clean' | JAVA_HOME='/usr/lib64/jvm/jre-17-openjdk' ~/'Projects/RT4-Client/src/gradlew' 'clean' --no-daemon |
JAVA_HOME='/usr/lib/jvm/jre-17-openjdk' ~/'Projects/RT4-Client/src/gradlew' 'jar' | JAVA_HOME='/usr/lib64/jvm/jre-17-openjdk' ~/'Projects/RT4-Client/src/gradlew' 'jar' --no-daemon |
~/'Projects/RT4-Client/src/gradlew' --stop | |
| |
echo '' | zenity --title '2009Scape Updater' --text 'RT4 Client update complete' --icon ~/'Projects/RT4-Client/src/client/src/main/resources/saradomin.png' --timeout '2' --info |
read -n '1' -s -r -p 'Done! Press any key to exit.' | |
| |
# End</code> | # End</code> |
===== 2009Scape (localhost) ===== | ===== 2009Scape (localhost) ===== |
| |
* Mostly requires [[servers:linux:games:2009scape_localhost#scripts|2009Scape localhost Server scripts]] | mkdir -p ~/'.local/share/applications' ~/'Projects/RT4-Client/cache' && nano ~/'.local/share/applications/2009Scape-localhost.desktop' && sed -i 's/'CHANGEME'/'$USER'/g' ~/'.local/share/applications/2009Scape-localhost.desktop' && update-desktop-database --quiet ~/'.local/share/applications' |
| |
mkdir -p ~/'.local/share/applications/' && nano ~/'.local/share/applications/2009Scape-localhost.desktop' && update-desktop-database --quiet ~/'.local/share/applications' | |
| |
<code> | <code> |
Name=2009Scape | Name=2009Scape |
Categories=Game; | Categories=Game; |
Exec='/bin/bash' -c "cd ~/'Projects/RT4-Client/src/client' && JAVA_TOOL_OPTIONS='-XX:+UseSerialGC -Xms1G -Xmx4G --add-exports=java.desktop/sun.awt=ALL-UNNAMED' java -jar ~/'Projects/RT4-Client/src/client/build/libs/client-'*'.jar' --config ~/'Projects/RT4-Client/conf/localhost.json'" | Exec='/bin/bash' -c "cd ~/'Projects/RT4-Client/src/client' && mesa_glthread='false' vblank_mode='3' java -Dsun.java2d.uiScale='1' --add-exports='java.desktop/sun.awt=ALL-UNNAMED' -DclientFps='140' -DclientHomeOverride=$HOME'/Projects/RT4-Client/cache/' -Djava.io.tmpdir=$HOME'/Projects/RT4-Client/cache/' -jar ~/'Projects/RT4-Client/src/client/build/libs/client-'*'.jar' --config ~/'Projects/RT4-Client/conf/localhost.json'" |
Type=Application | Type=Application |
StartupNotify=false | StartupNotify=false |
#Icon=TODO | Icon=/home/CHANGEME/Projects/RT4-Client/src/client/src/main/resources/saradomin.png |
Actions=Client-Update;Server-Update;Server;Saves;Client-Notes;Server-Notes; | Actions=HiDPI;Server;Saves;Server-Update;Client-Update;Client-Notes;Server-Notes; |
| |
[Desktop Action Client-Update] | [Desktop Action HiDPI] |
Exec='/bin/bash' -c "ptyxis --standalone --title='RT4 Client Updater — ' -- ~/'Projects/RT4-Client/scripts/client-update.sh'" | Exec='/bin/bash' -c "cd ~/'Projects/RT4-Client/src/client' && mesa_glthread='false' vblank_mode='3' java -Dsun.java2d.uiScale='2' --add-exports='java.desktop/sun.awt=ALL-UNNAMED' -DclientFps='140' -DclientHomeOverride=$HOME'/Projects/RT4-Client/cache/' -Djava.io.tmpdir=$HOME'/Projects/RT4-Client/cache/' -jar ~/'Projects/RT4-Client/src/client/build/libs/client-'*'.jar' --config ~/'Projects/RT4-Client/conf/localhost.json'" |
Name=Update Client | Name=Client (HiDPI) |
| |
[Desktop Action Server-Update] | |
Exec='/bin/bash' -c "ptyxis --standalone --title='2009Scape localhost Updater — ' -- ~/'Projects/2009Scape-Server/scripts/localhost-server-update.sh'" | |
Name=Update Local Server | |
| |
[Desktop Action Server] | [Desktop Action Server] |
Exec='/bin/bash' -c "ptyxis --standalone --title='2009Scape localhost Server — ' -- ~/'Projects/2009Scape-Server/scripts/localhost-server-start.sh'" | Exec='/bin/bash' -c "ptyxis --standalone --title='2009Scape Server — ' -- ~/'Projects/2009Scape-Server/scripts/localhost-server-start.sh'" |
Name=Launch Local Server | Name=Launch Local Server |
| |
Exec='/bin/bash' -c "~/'Projects/2009Scape-Server/scripts/localhost-save-backup.sh'" | Exec='/bin/bash' -c "~/'Projects/2009Scape-Server/scripts/localhost-save-backup.sh'" |
Name=Save Data Back-up | Name=Save Data Back-up |
| |
| [Desktop Action Server-Update] |
| Exec='/bin/bash' -c "ptyxis --standalone --title='2009Scape Server Updater — ' -- ~/'Projects/2009Scape-Server/scripts/localhost-server-update.sh'" |
| Name=Update Local Server |
| |
| [Desktop Action Client-Update] |
| Exec='/bin/bash' -c "ptyxis --standalone --title='2009Scape RT4 Client Updater — ' -- ~/'Projects/RT4-Client/scripts/client-update.sh'" |
| Name=Update Client |
| |
[Desktop Action Client-Notes] | [Desktop Action Client-Notes] |
StartupNotify=false | StartupNotify=false |
Exec='/bin/bash' -c "gio open 'https://wiki.realmofespionage.xyz/games:linux:rt4_client_runescape_530'" | Exec='/bin/bash' -c "gio open 'https://wiki.realmofespionage.xyz/games:linux:rt4_client_runescape_530'" |
Name=Client Installation Notes | Name=Client Notes |
| |
[Desktop Action Server-Notes] | [Desktop Action Server-Notes] |
StartupNotify=false | StartupNotify=false |
Exec='/bin/bash' -c "gio open 'https://wiki.realmofespionage.xyz/servers:linux:games:2009scape_localhost'" | Exec='/bin/bash' -c "gio open 'https://wiki.realmofespionage.xyz/servers:linux:games:2009scape_localhost'" |
Name=localhost Server Installation Notes | Name=Server Notes |
| |
# End</code> | # End</code> |
**** | **** |
| |
cd ~/'Projects/RT4-Client/src/client' && java -jar ~/'Projects/RT4-Client/src/client/build/libs/client-'*'.jar' --config ~/'Projects/RT4-Client/conf/localhost.json' | mkdir -p ~/'Projects/RT4-Client/cache' && cd ~/'Projects/RT4-Client/src/client' && mesa_glthread='false' vblank_mode='3' java -Dsun.java2d.uiScale='1' -XX:+UseSerialGC -Xms1G -Xmx4G --add-exports='java.desktop/sun.awt=ALL-UNNAMED' -DclientFps='120' -DclientHomeOverride=$HOME'/Projects/RT4-Client/cache/' -Djava.io.tmpdir=$HOME'/Projects/RT4-Client/cache/' -jar ~/'Projects/RT4-Client/src/client/build/libs/client-'*'.jar' --config ~/'Projects/RT4-Client/conf/localhost.json' |
| |
| ==== High DPI ==== |
| |
| * ''-Dsun.java2d.uiScale=2'' |
| |
| mkdir -p ~/'Projects/RT4-Client/cache' && cd ~/'Projects/RT4-Client/src/client' && mesa_glthread='false' vblank_mode='3' java -Dsun.java2d.uiScale='2' -XX:+UseSerialGC -Xms1G -Xmx4G --add-exports='java.desktop/sun.awt=ALL-UNNAMED' -DclientFps='120' -DclientHomeOverride=$HOME'/Projects/RT4-Client/cache/' -Djava.io.tmpdir=$HOME'/Projects/RT4-Client/cache/' -jar ~/'Projects/RT4-Client/src/client/build/libs/client-'*'.jar' --config ~/'Projects/RT4-Client/conf/localhost.json' |
| |
==== Testing ==== | ==== Testing ==== |
| |
GDK_BACKEND='x11' GDK_SCALE='2' | <code>GDK_BACKEND='x11' GDK_SCALE='2'</code> |
| |
| <code>GALLIUM_HUD='cpu0+cpu1+cpu2+cpu3;API-thread-offloaded-slots+API-thread-direct-slots+API-thread-num-syncs;fps'</code> |
| |
| <code>mesa_glthread='true'</code> |
| |
| <code>vblank_mode='0'</code> |
| |
| <code>-DclientFps='999'</code> |
| |
| === FPS === |
| |
| * Uncapped/''999'' FPS limit |
| * ''vblank_mode=0'' |
| * ''GDK_BACKEND=x11'' |
| |
GALLIUM_HUD='cpu0+cpu1+cpu2+cpu3;API-thread-offloaded-slots+API-thread-direct-slots+API-thread-num-syncs;fps' mesa_glthread='true' | mkdir -p ~/'Projects/RT4-Client/cache' && cd ~/'Projects/RT4-Client/src/client' && GDK_BACKEND='x11' GALLIUM_HUD='cpu0+cpu1+cpu2+cpu3;API-thread-offloaded-slots+API-thread-direct-slots+API-thread-num-syncs;fps' mesa_glthread='false' vblank_mode='0' java -Dsun.java2d.uiScale='1' -XX:+UseSerialGC -Xms1G -Xmx4G --add-exports='java.desktop/sun.awt=ALL-UNNAMED' -DclientFps='999' -DclientHomeOverride=$HOME'/Projects/RT4-Client/cache/' -Djava.io.tmpdir=$HOME'/Projects/RT4-Client/cache/' -jar ~/'Projects/RT4-Client/src/client/build/libs/client-'*'.jar' --config ~/'Projects/RT4-Client/conf/localhost.json' |
| |
cd ~/'Projects/RT4-Client/src/client' && JAVA_TOOL_OPTIONS='-XX:+UseSerialGC -Xms1G -Xmx4G --add-exports=java.desktop/sun.awt=ALL-UNNAMED' java -jar ~/'Projects/RT4-Client/src/client/build/libs/client-'*'.jar' --config ~/'Projects/RT4-Client/conf/localhost.json' | mkdir -p ~/'Projects/RT4-Client/cache' && cd ~/'Projects/RT4-Client/src/client' && vblank_mode='3' java -Djdk.gtk.version='3' -Dsun.java2d.uiScale='1' --add-exports='java.desktop/sun.awt=ALL-UNNAMED' -DclientFps='146' -DclientHomeOverride=$HOME'/Projects/RT4-Client/cache/' -Djava.io.tmpdir=$HOME'/Projects/RT4-Client/cache/' -jar ~/'Projects/RT4-Client/src/client/build/libs/client-'*'.jar' --config ~/'Projects/RT4-Client/conf/localhost.json' |
| |
===== Update ===== | ===== Update ===== |
| |
* [[https://gitlab.com/2009scape/rt4-client/-/commits/master|Commits History]] | * https://gitlab.com/2009scape/rt4-client/-/commits/master?ref_type=heads |
| |
git -C ~/'Projects/RT4-Client/src' reset --hard && git -C ~/'Projects/RT4-Client/src' pull origin 'master' --rebase && cd ~/'Projects/RT4-Client/src' && ~/'Projects/RT4-Client/src/gradlew' 'clean' && ~/'Projects/RT4-Client/src/gradlew' 'jar' && ~/'Projects/RT4-Client/src/gradlew' --stop && cd ~ && sync | git -C ~/'Projects/RT4-Client/src' reset --hard && git -C ~/'Projects/RT4-Client/src' pull origin 'master' --rebase && cd ~/'Projects/RT4-Client/src' && sed -i 's/USE_TWEENING = true/USE_TWEENING = false/g' ~/'Projects/RT4-Client/src/client/src/main/java/rt4/GlobalConfig.java' && cd ~/'Projects/RT4-Client/src' && ~/'Projects/RT4-Client/src/gradlew' 'clean' --no-daemon && ~/'Projects/RT4-Client/src/gradlew' 'jar' --no-daemon && cd ~ && sync |
| |
~/'Projects/RT4-Client/scripts/client-update.sh' | ~/'Projects/RT4-Client/scripts/client-update.sh' |
| |
ptyxis --standalone --title='RT4 Client Updater — ' -- ~/'Projects/RT4-Client/scripts/client-update.sh' | ptyxis --standalone --title='2009Scape RT4 Client Updater — ' -- ~/'Projects/RT4-Client/scripts/client-update.sh' |
| |
===== gradlew ===== | ===== gradlew ===== |
| |
* Lists available ''gradlew'' commands | * Lists available ''gradlew'' commands |
| * ''tasks --all'' for more Tasks |
| * ''gradlew.bat --stop'' to stop Gradle daemons in-lieu of ''--no-daemon'' |
| |
cd ~/'Projects/RT4-Client/src' && JAVA_HOME='/usr/lib/jvm/jre-17-openjdk' ~/'Projects/RT4-Client/src/gradlew' 'tasks' && ~/'Projects/RT4-Client/src/gradlew' --stop | cd ~/'Projects/RT4-Client/src' && ~/'Projects/RT4-Client/src/gradlew' 'tasks' --no-daemon |
| |
cd ~/'Projects/RT4-Client/src' && JAVA_HOME='/usr/lib/jvm/jre-17-openjdk' ~/'Projects/RT4-Client/src/gradlew' 'tasks' --all && ~/'Projects/RT4-Client/src/gradlew' --stop | ===== Git ===== |
| |
| git -C ~/'Projects/RT4-Client/src' fsck --full --strict |
| |
| git -C ~/'Projects/RT4-Client/src' gc --aggressive --prune='all' |
| |
===== File Manager ===== | ===== File Manager ===== |
| |
gio open ~/'Projects/RT4-Client/src' | gio open ~/'Projects/RT4-Client/src' |
| |
| ====== Tests ====== |
| |
| ===== GTK3 ===== |
| |
| * ''jdk.gtk.version=3'' |
| |
| sudo zypper install 'libgthread-2_0-0' |
| |
| ~/Projects/RT4-Client/src/client> mkdir -p ~/'Projects/RT4-Client/cache' && cd ~/'Projects/RT4-Client/src/client' && java -Dsun.java2d.uiScale='1' --add-exports='java.desktop/sun.awt=ALL-UNNAMED' -DclientFps='999' -DclientHomeOverride=$HOME'/Projects/RT4-Client/cache/' -Djava.io.tmpdir=$HOME'/Projects/RT4-Client/cache/' -Djdk.gtk.version='3' -jar ~/'Projects/RT4-Client/src/client/build/libs/client-'*'.jar' --config ~/'Projects/RT4-Client/conf/localhost.json' |
| |
| ===== Flags ===== |
| |
| * VK and ''WLToolkit'' need JetBrain's java |
| |
| <code>-Djdk.gtk.verbose='True'</code> |
| |
| <code>-Djdk.gtk.version='3'</code> |
| |
| <code>-Dawt.toolkit.name='WLToolkit'</code> |
| |
| <code>-Dsun.java2d.vulkan='True'</code> |
| |
| <code>-Dsun.java2d.vulkan.deviceNumber='1'</code> |
| |
| <code>J2D_TRACE_LEVEL='1'</code> |
| |
| <code>_JAVA_AWT_WM_NONREPARENTING='1'</code> |
| |
| <code>GDK_BACKEND='wayland'</code> |
| |