====== Information ======
* RT4 Client ((https://gitlab.com/2009scape/rt4-client))
===== Prerequisites =====
* [[windows;10|Windows 10 (21H2)]]
* [[programs;windows;git|Git]]
* [[servers:windows:games:2009scape_localhost|2009Scape localhost Server]]
====== Dependencies ======
* https://gitlab.com/2009scape/rt4-client#instructions
===== Java =====
==== 21 ====
* https://learn.microsoft.com/en-us/java/openjdk/download#openjdk-21
* Last tested: ''microsoft-jdk-21.0.7-windows-x64.msi''
* Entire feature install of ''Microsoft Build of OpenJDK''
==== 17 ====
* https://learn.microsoft.com/en-us/java/openjdk/download#openjdk-17
* Last tested: ''microsoft-jdk-17.0.15-windows-x64.msi''
* 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
====== Download Source ======
* 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"
====== Build ======
===== Settings =====
MKDIR "%UserProfile%\Projects\RT4-Client\scripts"
"notepad.exe" "%UserProfile%\Projects\RT4-Client\scripts\client-settings-sed.sh"
#!/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
===== Build =====
"%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.15.6-hotspot" && "%UserProfile%\Projects\RT4-Client\src\gradlew.bat" "jar" --no-daemon
====== Settings ======
* Last commit: [[https://gitlab.com/2009scape/rt4-client/-/commit/4377d4958e1ccc9b97c6c99b9e2a9df8dfbae5e5|September 25, 2022]] ''4377d495''
* [[https://gitlab.com/2009scape/rt4-client/-/commits/master/client/config.json?ref_type=heads|New commits check]]
* [[https://gitlab.com/2009scape/rt4-client/-/blob/master/client/config.json?ref_type=heads|Upstream client/config.json]] ([[https://gitlab.com/2009scape/rt4-client/-/raw/master/client/config.json?ref_type=heads|raw]])
MKDIR "%UserProfile%\Projects\RT4-Client\conf"
"notepad.exe" "%UserProfile%\Projects\RT4-Client\conf\localhost.json"
{
"ip_management": "localhost",
"ip_address": "localhost",
"world": 1,
"server_port": 43594,
"wl_port": 43595,
"js5_port": 43595,
"mouseWheelZoom": false,
"pluginsFolder": "null"
}
====== Scripts ======
****
MKDIR "%UserProfile%\Projects\RT4-Client\scripts"
===== Client Start =====
MKDIR "%UserProfile%\Projects\RT4-Client\cache"
"notepad.exe" "%UserProfile%\Projects\RT4-Client\scripts\client-start.bat"
@echo off
CD "%UserProfile%\Projects\RT4-Client\src\client"
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
"%UserProfile%\Projects\RT4-Client\scripts\client-start.bat"
==== High DPI ====
"notepad.exe" "%UserProfile%\Projects\RT4-Client\scripts\client-hidpi-start.bat"
@echo off
CD "%UserProfile%\Projects\RT4-Client\src\client"
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
"%UserProfile%\Projects\RT4-Client\scripts\client-hidpi-start.bat"
===== Client Update =====
"notepad.exe" "%UserProfile%\Projects\RT4-Client\scripts\client-update.bat"
@echo off
"%ProgramFiles%\Git\bin\git.exe" -C "%UserProfile%\Projects\RT4-Client\src" reset --hard
"%ProgramFiles%\Git\bin\git.exe" -C "%UserProfile%\Projects\RT4-Client\src" pull origin "master" --rebase
"%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"
CALL "%UserProfile%\Projects\RT4-Client\src\gradlew.bat" "clean" --no-daemon
CALL "%UserProfile%\Projects\RT4-Client\src\gradlew.bat" "jar" --no-daemon
:: End
"%UserProfile%\Projects\RT4-Client\scripts\client-update.bat"
====== Extras ======
===== Icon =====
* Convert source ''saradomin.png'' to ''saradomin.ico'', save to ''ext'' folder ((Windows can't use ''.png'' as icons))
* [[https://www.gimp.org/downloads/|GIMP]]
* ''Ctrl-Shift-E'' (Export As)
MKDIR "%UserProfile%\Projects\RT4-Client\ext"
"%LocalAppData%\Programs\GIMP 3\bin\gimp-3.exe" "%UserProfile%\Projects\RT4-Client\src\client\src\main\resources\saradomin.png"
..\..\..\..\..\ext\saradomin.ico
====== Launcher Shortcuts ======
===== Desktop =====
==== Client ====
"%UserProfile%\Projects\RT4-Client\scripts\client-start.bat"
2009Scape
=== Icon ===
****
"%UserProfile%\Projects\RT4-Client\ext\saradomin.ico"
==== High DPI ====
"%UserProfile%\Projects\RT4-Client\scripts\client-hidpi-start.bat"
2009Scape (HiDPI)
===== Start Menu =====
MKDIR "%AppData%\Microsoft\Windows\Start Menu\Programs\2009Scape"
"explorer.exe" "%AppData%\Microsoft\Windows\Start Menu\Programs\2009Scape"
==== Client ====
"%UserProfile%\Projects\RT4-Client\scripts\client-start.bat"
2009Scape (localhost)
=== Icon ===
****
"%UserProfile%\Projects\RT4-Client\ext\saradomin.ico"
==== High DPI ====
"%UserProfile%\Projects\RT4-Client\scripts\client-hidpi-start.bat"
2009Scape (HiDPI)
==== Update ====
"%UserProfile%\Projects\RT4-Client\scripts\client-update.bat"
Client Updater
==== Install Notes ====
"https://wiki.realmofespionage.xyz/games;windows;rt4_client_runescape_530"
Install Notes (Client)