Skip to content

The Java RS2 game client used to play on RuneJS game servers.

Notifications You must be signed in to change notification settings

Jameskmonger/refactored-client-435

This branch is 603 commits behind runejs/refactored-client-435:master.

Folders and files

NameName
Last commit message
Last commit date
May 13, 2021
Aug 6, 2022
May 13, 2021
Jul 7, 2020
Jun 19, 2021
Jul 4, 2023
May 25, 2022
Jun 19, 2021
Jun 19, 2021
Jul 7, 2020
Jul 7, 2020
Apr 20, 2021

Repository files navigation

RuneJS Java Client #435

A RuneScape game client from October 2006 which has been modified to work with RuneJS, a RuneScape game server written in NodeJS and TypeScript. This client is not for OldSchool RuneScape - client #435 pre-dates the very first OSRS client by quite some time.

We've no interest in OSRS client hacking, this client exists as a means to develop on RuneJS game servers and will not work with other server emulators.

Usage

Running the client can be done either with the pre-built client JAR file or by building the Java code and running it manually in an IDE.

Pre-Built Client

Running the pre-built client requires having Java installed: https://www.java.com/en/

Once installed, go into the /prebuilt/ and simply double-click the JAR file to run it. Alternatively if executing the JAR does not work, the command java -jar client-435-0.3.jar may be used from within the /prebuilt/ directory.

The client will use a set of default configurations if no file is provided. The default client configuration matches up to the default RuneJS server configuration for quick and easy initial setup. It's highly advised that you generate your own RSA public and private keys for long term use.

To provide your own configurations, create a file named client-435.conf.yaml in your User Home directory with the following content:

net:
  address: 127.0.0.1
  game_port: 43594
cache:
  cacheDir: .filestore_435
rsa:
  rsaPub: YOUR_RSA_PUBLIC_KEY (default dev pair provided in the example file)
  rsaModulus: YOUR_RSA_PRIVATE_KEY (default dev pair provided in the example file)
login:
  useStaticCredentials: true
  username: a
  password: a
game:
  roofsEnabled: true
  freeTeleports: false
  debugContextMenu: true
serverDisplayName: Build 435

Make sure to modify the given configuration for your specific needs.

Gradle

Gradle provides a wrapper script which downloads the build system to a local cache. This allows you to run the client without the help of an IDE such as IntelliJ. Gradle is also configured to automatically download dependencies.

The following examples use the unix executable ./gradlew, however Windows can replace these with ./gradlew.bat.

Running via Gradle

The application gradle plugin provides the run task, which starts up the Main client class. With this option, arguments can be provided via --args.

./gradlew run

Building a Jar

The jar task can be used to build a jar, which is generated in the build/libs directory.

./gradlew jar
java -jar ./build/libs/client-435-0.3.jar

About

The Java RS2 game client used to play on RuneJS game servers.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 100.0%