Reverse-engineered engine code designed to accurately simulate the cycle behaviors of early RS2. Contains the necessary data tools and compatible network protocol.

Game data is in the Content repository.

The project organizes historical versions into branches. You will need matching engine and content branches together to run the project.

The Server repository will simplify setup for most users. Download that repository and follow the instructions there.

In absence of the Server scripts, download the specific engine and content repositories/branches you desire and extract them to the same parent folder.

git clone https://github.com/LostCityRS/Engine-TS -b 244 --single-branch engine
git clone https://github.com/LostCityRS/Content -b 244 --single-branch content
cd engine
bun start

* use --single-branch when you don't need to track the commit history of all versions

Client-Java is available for all versions. This is a research project to decompile and understand the original code. It has minor fixes for OS and Java compatibility.

Client-TS may be available depending on the version. This is a human-driven port of the original code to modern browsers. This gets prebuilt and included in this repository if available.

You can use the original obfuscated compiled applet from this time period with these arguments: java -cp runescape.jar client 10 0 highmem members 32
Be aware it may have compatibility issues (that are addressed in the Client-Java repository).

• Bun 1.2
• Java 17 - later LTS versions are also fine.

Content developers should run bun start. The server will watch for changes to scripts and configs, then automatically repack everything.

Engine developers should run bun dev. This does what bun start does above, but also completely restarts the server when engine code has changed.

• '"java"' is not recognized as an internal or external command

You do not have Java installed. See dependencies above.

• XXXXX has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class file versions up to 52.0

You are using Java 8 or Java 11. If you have multiple Java versions, you will need to set JAVA_PATH=path-to-java.exe in your .env file manually.

This project is licensed under the MIT License. See the LICENSE file for details.