Differences

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

--- games:windows:rt4_client_runescape_530 [2025/04/03 02:36] – [Settings] Sean Rhone
+++ games:windows:rt4_client_runescape_530 [2025/06/21 16:39] (current) – Sean Rhone
@@ Line 2: / Line 2: @@
   * RT4 Client ((https://gitlab.com/2009scape/rt4-client))
-  * These notes provide a game client for 2009Scape
-  * Last tested commit: [[https://gitlab.com/2009scape/rt4-client/-/commit/5cf2f18786dab256da75a4c6f70bdc0330f24e2a|~5cf2f187]]
 ===== Prerequisites =====
-  * [[windows:10|Windows 10]]
+  * [[windows;10|Windows 10 (21H2)]]
+  * [[programs;windows;git|Git]]
-===== Resources =====
+  * [[servers:windows:games:2009scape_localhost|2009Scape localhost Server]]
-  * [[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 =====
-  * :!: This is for private server use
-  * See [[servers:windows:games:2009scape_localhost|2009Scape localhost Server]] to set-up a server
 ====== Dependencies ======
@@ Line 24: / Line 13: @@
   * https://gitlab.com/2009scape/rt4-client#instructions
-===== Git =====
+===== Java =====
-  * https://www.git-scm.com/download/win
+==== 21 ====
-  * Last tested: ''Git-2.47.1.2-64-bit.exe''
-  * No components required
-  * Git from the command line and also from 3rd-party software
-===== Java =====
   * https://learn.microsoft.com/en-us/java/openjdk/download#openjdk-21
-  * Last tested: ''microsoft-jdk-21.0.6-windows-x64.msi''
+  * Last tested: ''microsoft-jdk-21.0.7-windows-x64.msi''
   * Entire feature install of ''Microsoft Build of OpenJDK''
@@ Line 42: / Line 25: @@
   * https://learn.microsoft.com/en-us/java/openjdk/download#openjdk-17
-  * Last tested: ''microsoft-jdk-17.0.14-windows-x64.msi''
+  * Last tested: ''microsoft-jdk-17.0.15-windows-x64.msi''
-  * 2025/01/14: Required for [[#build1|building]] ((17 for [[https://gitlab.com/2009scape/rt4-client/-/blob/master/gradle/wrapper/gradle-wrapper.properties?ref_type=heads#L3|Gradle]] requirement; client runs 21+))
+  * 2025/04/03: Required for [[#build1|building]] ((17 for [[https://gitlab.com/2009scape/rt4-client/-/blob/master/gradle/wrapper/gradle-wrapper.properties?ref_type=heads#L3|Gradle 7.4.2]] requirement; client runs 21+))
-  * All secondary features manually-marked unavailable ((only need the binary files present))
+  * All secondary features manually-marked unavailable
 ====== Download Source ======
-  * https://gitlab.com/2009scape/rt4-client/-/commits/master?ref_type=heads
+  * https://gitlab.com/2009scape/rt4-client/-/commits/master?ref_type=HEADS
   "%ProgramFiles%\Git\bin\git.exe" clone --branch "master" --depth "1" --recurse-submodules "https://gitlab.com/2009scape/rt4-client.git" "%UserProfile%\Projects\RT4-Client\src"
@@ Line 55: / Line 38: @@
 ====== Build ======
-===== Disable Tweening =====
+===== Settings =====
-  * Aka: Animation Smoothing
+  MKDIR "%UserProfile%\Projects\RT4-Client\scripts"
-  * Fixes certain animations ((Lumbridge grain mill and nearby sign animation loops))
-  "notepad.exe" "%UserProfile%\Projects\RT4-Client\src\client\src\main\java\rt4\GlobalConfig.java"
+  "notepad.exe" "%UserProfile%\Projects\RT4-Client\scripts\client-settings-sed.sh"
-<code>public static boolean USE_TWEENING = false;</code>
+<code>
+#!/bin/sh
+sed -i -e 's/USE_TWEENING = true/USE_TWEENING = false/g' ~/'Projects/RT4-Client/src/client/src/main/java/rt4/GlobalConfig.java'
+sed -i -e 's/BILINEAR_MINIMAP = true/BILINEAR_MINIMAP = false/g' ~/'Projects/RT4-Client/src/client/src/main/java/rt4/GlobalConfig.java'
+sed -i -e 's/USE_SHIFT_CLICK = true/USE_SHIFT_CLICK = false/g' ~/'Projects/RT4-Client/src/client/src/main/java/rt4/GlobalConfig.java'
+sed -i -e 's/MOUSEWHEEL_ZOOM = true/MOUSEWHEEL_ZOOM = false/g' ~/'Projects/RT4-Client/src/client/src/main/java/rt4/GlobalConfig.java'
+# End</code>
 ===== Build =====
-  CD "%UserProfile%\Projects\RT4-Client\src" && SET "JAVA_HOME=%ProgramFiles%\Microsoft\jdk-17.0.14.7-hotspot" && "%UserProfile%\Projects\RT4-Client\src\gradlew.bat" "clean" --no-daemon
+  "%ProgramFiles%\Git\bin\sh.exe" -- "%UserProfile%\Projects\RT4-Client\scripts\client-settings-sed.sh"
+  CD "%UserProfile%\Projects\RT4-Client\src" && SET "JAVA_HOME=%ProgramFiles%\Microsoft\jdk-17.0.15.6-hotspot" && "%UserProfile%\Projects\RT4-Client\src\gradlew.bat" "clean" --no-daemon
-  CD "%UserProfile%\Projects\RT4-Client\src" && SET "JAVA_HOME=%ProgramFiles%\Microsoft\jdk-17.0.14.7-hotspot" && "%UserProfile%\Projects\RT4-Client\src\gradlew.bat" "jar" --no-daemon
+  CD "%UserProfile%\Projects\RT4-Client\src" && SET "JAVA_HOME=%ProgramFiles%\Microsoft\jdk-17.0.15.6-hotspot" && "%UserProfile%\Projects\RT4-Client\src\gradlew.bat" "jar" --no-daemon
 ====== Settings ======
@@ Line 101: / Line 93: @@
 ===== Client Start =====
-  notepad "%UserProfile%\Projects\RT4-Client\scripts\client-start.bat"
+  MKDIR "%UserProfile%\Projects\RT4-Client\cache"
+  "notepad.exe" "%UserProfile%\Projects\RT4-Client\scripts\client-start.bat"
 <code>
@@ Line 108: / Line 102: @@
 CD "%UserProfile%\Projects\RT4-Client\src\client"
-START "" "javaw.exe" -Dsun.java2d.uiScale="1" --add-exports="java.desktop/sun.awt=ALL-UNNAMED" -jar "%UserProfile%\Projects\RT4-Client\src\client\build\libs\client-1.0.0.jar" --config "%UserProfile%\Projects\RT4-Client\conf\localhost.json"
+SET "_JAVA_OPTIONS=-Dsun.java2d.uiScale=1 -Djava.net.preferIPv6Addresses=true --add-exports=java.desktop/sun.awt=ALL-UNNAMED -Djava.io.tmpdir=..\..\cache"
+START "" "javaw.exe" -DclientHomeOverride="..\..\cache" -jar "%UserProfile%\Projects\RT4-Client\src\client\build\libs\client-1.0.0.jar" --config "%UserProfile%\Projects\RT4-Client\conf\localhost.json"
 :: End</code>
+  "%UserProfile%\Projects\RT4-Client\scripts\client-start.bat"
 ==== High DPI ====
-  notepad "%UserProfile%\Projects\RT4-Client\scripts\client-hidpi-start.bat"
+  "notepad.exe" "%UserProfile%\Projects\RT4-Client\scripts\client-hidpi-start.bat"
 <code>
@@ Line 121: / Line 119: @@
 CD "%UserProfile%\Projects\RT4-Client\src\client"
-START "" "javaw.exe" -Dsun.java2d.uiScale="2" --add-exports="java.desktop/sun.awt=ALL-UNNAMED" -jar "%UserProfile%\Projects\RT4-Client\src\client\build\libs\client-1.0.0.jar" --config "%UserProfile%\Projects\RT4-Client\conf\localhost.json"
+SET "_JAVA_OPTIONS=-Dsun.java2d.uiScale=2 -Djava.net.preferIPv6Addresses=true --add-exports=java.desktop/sun.awt=ALL-UNNAMED -Djava.io.tmpdir=..\..\cache"
+START "" "javaw.exe" -DclientHomeOverride="..\..\cache" -jar "%UserProfile%\Projects\RT4-Client\src\client\build\libs\client-1.0.0.jar" --config "%UserProfile%\Projects\RT4-Client\conf\localhost.json"
 :: End</code>
-===== Client Update =====
+  "%UserProfile%\Projects\RT4-Client\scripts\client-hidpi-start.bat"
-  * https://gitlab.com/2009scape/rt4-client/-/commits/master?ref_type=heads
+===== Client Update =====
-  notepad "%UserProfile%\Projects\RT4-Client\scripts\client-update.bat"
+  "notepad.exe" "%UserProfile%\Projects\RT4-Client\scripts\client-update.bat"
 <code>
 @echo off
-git -C "%UserProfile%\Projects\RT4-Client\src" reset --hard
+"%ProgramFiles%\Git\bin\git.exe" -C "%UserProfile%\Projects\RT4-Client\src" reset --hard
-git -C "%UserProfile%\Projects\RT4-Client\src" pull origin "master" --rebase
+"%ProgramFiles%\Git\bin\git.exe" -C "%UserProfile%\Projects\RT4-Client\src" pull origin "master" --rebase
-notepad "%UserProfile%\Projects\RT4-Client\src\client\src\main\java\rt4\GlobalConfig.java"
+"%ProgramFiles%\Git\bin\sh.exe" -- "%UserProfile%\Projects\RT4-Client\scripts\client-settings-sed.sh"
 CD "%UserProfile%\Projects\RT4-Client\src"
-SET "JAVA_HOME=%ProgramFiles%\Microsoft\jdk-17.0.14.7-hotspot"
+SET "JAVA_HOME=%ProgramFiles%\Microsoft\jdk-17.0.15.6-hotspot"
 CALL "%UserProfile%\Projects\RT4-Client\src\gradlew.bat" "clean" --no-daemon
 CALL "%UserProfile%\Projects\RT4-Client\src\gradlew.bat" "jar" --no-daemon
@@ Line 146: / Line 146: @@
 :: End</code>
-====== Launcher Shortcuts ======
+  "%UserProfile%\Projects\RT4-Client\scripts\client-update.bat"
+====== Extras ======
 ===== Icon =====
-  * Convert source ''saradomin.png'' to ''saradomin.ico'', save to ''ext'' folder ((Windows 10 can't use ''.png'' as icons; [[https://www.gimp.org/|GIMP]] converts easily))
+  * Convert source ''saradomin.png'' to ''saradomin.ico'', save to ''ext'' folder ((Windows can't use ''.png'' as icons))
-  * Start Menu and Desktop shortcuts expect ''saradomin.ico''
+  * [[https://www.gimp.org/downloads/|GIMP]]
+  * ''Ctrl-Shift-E'' (Export As)
   MKDIR "%UserProfile%\Projects\RT4-Client\ext"
-  explorer "%UserProfile%\Projects\RT4-Client\ext"
+  "%LocalAppData%\Programs\GIMP 3\bin\gimp-3.exe" "%UserProfile%\Projects\RT4-Client\src\client\src\main\resources\saradomin.png"
-  explorer "%UserProfile%\Projects\RT4-Client\src\client\src\main\resources"
+<code>..\..\..\..\..\ext\saradomin.ico</code>
-  "%UserProfile%\Projects\RT4-Client\ext\saradomin.ico"
+====== Launcher Shortcuts ======
-<code>..\..\..\..\..\ext\saradomin.ico</code>
 ===== Desktop =====
-  * Right-click Desktop -> New -> Shortcut
 ==== Client ====
@@ Line 172: / Line 171: @@
 Scape
+=== Icon ===
+****
   "%UserProfile%\Projects\RT4-Client\ext\saradomin.ico"
@@ Line 180: / Line 183: @@
 Scape (HiDPI)
-  "%UserProfile%\Projects\RT4-Client\ext\saradomin.ico"
 ===== Start Menu =====
-  * Right-click -> New -> Shortcut
   MKDIR "%AppData%\Microsoft\Windows\Start Menu\Programs\2009Scape"
-  explorer "%AppData%\Microsoft\Windows\Start Menu\Programs\2009Scape"
+  "explorer.exe" "%AppData%\Microsoft\Windows\Start Menu\Programs\2009Scape"
 ==== Client ====
@@ Line 196: / Line 195: @@
 Scape (localhost)
+=== Icon ===
+****
   "%UserProfile%\Projects\RT4-Client\ext\saradomin.ico"
@@ Line 204: / Line 207: @@
 Scape (HiDPI)
-  "%UserProfile%\Projects\RT4-Client\ext\saradomin.ico"
 ==== Update ====
@@ Line 215: / Line 216: @@
 ==== Install Notes ====
-  https://wiki.realmofespionage.xyz/games;windows;rt4_client_runescape_530
+  "https://wiki.realmofespionage.xyz/games;windows;rt4_client_runescape_530"
   Install Notes (Client)
-====== Quick Commands ======
-===== Execute =====
-****
-  CD "%UserProfile%\Projects\RT4-Client\src\client" && "java.exe" -Dsun.java2d.uiScale="1" --add-exports="java.desktop/sun.awt=ALL-UNNAMED" -jar "%UserProfile%\Projects\RT4-Client\src\client\build\libs\client-1.0.0.jar" --config "%UserProfile%\Projects\RT4-Client\conf\localhost.json"
-==== High DPI ====
-****
-  CD "%UserProfile%\Projects\RT4-Client\src\client" && "java.exe" -Dsun.java2d.uiScale="2" --add-exports="java.desktop/sun.awt=ALL-UNNAMED" -jar "%UserProfile%\Projects\RT4-Client\src\client\build\libs\client-1.0.0.jar" --config "%UserProfile%\Projects\RT4-Client\conf\localhost.json"
-==== Java 17 ====
-****
-  CD "%UserProfile%\Projects\RT4-Client\src\client" && "%ProgramFiles%\Microsoft\jdk-17.0.14.7-hotspot\bin\java.exe" -XX:+"UseSerialGC" -Xms"2G" -Xmx"2G" -Dsun.java2d.uiScale="1" --add-exports="java.desktop/sun.awt=ALL-UNNAMED" -jar "%UserProfile%\Projects\RT4-Client\src\client\build\libs\client-1.0.0.jar" --config "%UserProfile%\Projects\RT4-Client\conf\localhost.json"
-==== Flags ====
-****
-<code>-DclientFps="120"</code>
-===== Update =====
-  * https://gitlab.com/2009scape/rt4-client/-/commits/master?ref_type=heads
-  git -C "%UserProfile%\Projects\RT4-Client\src" reset --hard && git -C "%UserProfile%\Projects\RT4-Client\src" pull origin "master" --rebase
-  notepad "%UserProfile%\Projects\RT4-Client\src\client\src\main\java\rt4\GlobalConfig.java"
-  CD "%UserProfile%\Projects\RT4-Client\src" && SET "JAVA_HOME=%ProgramFiles%\Microsoft\jdk-17.0.14.7-hotspot" && "%UserProfile%\Projects\RT4-Client\src\gradlew.bat" "clean" --no-daemon && "%UserProfile%\Projects\RT4-Client\src\gradlew.bat" "jar" --no-daemon
-===== gradlew =====
-  * Lists available ''gradlew'' commands
-  * ''tasks --all'' for more Tasks
-  * ''gradlew.bat --stop'' to stop Gradle daemons in-lieu of ''--no-daemon''
-  CD "%UserProfile%\Projects\RT4-Client\src" && SET "JAVA_HOME=%ProgramFiles%\Microsoft\jdk-17.0.14.7-hotspot" && "%UserProfile%\Projects\RT4-Client\src\gradlew.bat" "tasks" --no-daemon
-===== File Manager =====
-==== Root ====
-****
-  explorer "%UserProfile%\Projects\RT4-Client\src"
-==== Plugins ====
-  * [[https://gitlab.com/2009scape/rt4-client/-/tree/master/plugin-playground/src/main?ref_type=heads|Upstream Plugins]]
-  * [[#build1|Compiled]] with Client
-  * Enable by setting ''pluginsFolder'' to ''plugins'' in [[#settings|json conf]]
-  * [[https://gitlab.com/2009scape/rt4-client/-/blob/master/plugin-playground/src/main/kotlin/BasicInputQOL/plugin.kt?ref_type=heads|BasicInputQOL]] provides mouse-wheel control ((both zoom (hold Ctrl or Shift) **and** camera rotation movement (wheel-hold); neither are available by-default without the plugin enabled, but Bank mouse wheel scroll seemingly doesn't rely on this plugin))
-  explorer "%UserProfile%\Projects\RT4-Client\src\client\plugins"