Information

RT4 Client ¹⁾

These notes provide a game client for 2009Scape

Prerequisites

Windows 10

Resources

Notes

This is for private server use
See 2009Scape localhost Server to set-up a server

Dependencies

https://gitlab.com/2009scape/rt4-client#instructions

Git

https://www.git-scm.com/download/win
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

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.14-windows-x64.msi
2025/01/14: Required for building ²⁾

All secondary features manually-marked unavailable ³⁾

Download Source

https://gitlab.com/2009scape/rt4-client/-/commits/master?ref_type=heads

git clone --branch "master" --depth "1" --recurse-submodules "https://gitlab.com/2009scape/rt4-client.git" "%UserProfile%\Projects\RT4-Client\src"

Build

Disable Tweening

Aka: Animation Smoothing
Fixes certain animations ⁴⁾

notepad "%UserProfile%\Projects\RT4-Client\src\client\src\main\java\rt4\GlobalConfig.java"

public static boolean USE_TWEENING = false;

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

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

Settings

Last commit: September 25, 2022 4377d495
New commits check
Upstream client/config.json (raw)

MKDIR "%UserProfile%\Projects\RT4-Client\conf"

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

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

@echo off

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"

:: End

High DPI

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

@echo off

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"

:: End

Client Update

https://gitlab.com/2009scape/rt4-client/-/commits/master?ref_type=heads

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

@echo off

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"
CALL "%UserProfile%\Projects\RT4-Client\src\gradlew.bat" "clean" --no-daemon
CALL "%UserProfile%\Projects\RT4-Client\src\gradlew.bat" "jar" --no-daemon

:: End

Launcher Shortcuts

Icon

Convert source saradomin.png to saradomin.ico, save to ext folder ⁵⁾
Start Menu and Desktop shortcuts expect saradomin.ico

MKDIR "%UserProfile%\Projects\RT4-Client\ext"

explorer "%UserProfile%\Projects\RT4-Client\ext"

explorer "%UserProfile%\Projects\RT4-Client\src\client\src\main\resources"

"%UserProfile%\Projects\RT4-Client\ext\saradomin.ico"

..\..\..\..\..\ext\saradomin.ico

Desktop

Right-click Desktop → New → Shortcut

Client

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

2009Scape

"%UserProfile%\Projects\RT4-Client\ext\saradomin.ico"

High DPI

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

2009Scape (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"

Client

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

2009Scape (localhost)

"%UserProfile%\Projects\RT4-Client\ext\saradomin.ico"

High DPI

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

2009Scape (HiDPI)

"%UserProfile%\Projects\RT4-Client\ext\saradomin.ico"

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)

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

-DclientFps="120"

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

Upstream Plugins

Compiled with Client
Enable by setting pluginsFolder to plugins in json conf
BasicInputQOL provides mouse-wheel control ⁶⁾

explorer "%UserProfile%\Projects\RT4-Client\src\client\plugins"

¹⁾

https://gitlab.com/2009scape/rt4-client

²⁾

17 for Gradle requirement; client runs 21+

³⁾

only need the binary files present

⁴⁾

Lumbridge grain mill and nearby sign animation loops

⁵⁾

Windows 10 can't use .png as icons; GIMP converts easily

⁶⁾

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

RoE | Wiki

Table of Contents

Information

Prerequisites

Resources

Notes

Dependencies

Git

Java

17

Download Source

Build

Disable Tweening

Build

Settings

Scripts

Client Start

High DPI

Client Update

Launcher Shortcuts

Icon

Desktop

Client

High DPI

Start Menu

Client

High DPI

Update

Install Notes

Quick Commands

Execute

High DPI

Java 17

Flags

Update

gradlew

File Manager

Root

Plugins