====== 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"

<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 =====

  "%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"

<code>
{
    "ip_management": "localhost",
    "ip_address": "localhost",
    "world": 1,
    "server_port": 43594,
    "wl_port": 43595,
    "js5_port": 43595,
    "mouseWheelZoom": false,
    "pluginsFolder": "null"
}
</code>

====== 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"

<code>
@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</code>

  "%UserProfile%\Projects\RT4-Client\scripts\client-start.bat"

==== High DPI ====

  "notepad.exe" "%UserProfile%\Projects\RT4-Client\scripts\client-hidpi-start.bat"

<code>
@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</code>

  "%UserProfile%\Projects\RT4-Client\scripts\client-hidpi-start.bat"

===== Client Update =====

  "notepad.exe" "%UserProfile%\Projects\RT4-Client\scripts\client-update.bat"

<code>
@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</code>

  "%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"

<code>..\..\..\..\..\ext\saradomin.ico</code>

====== 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)