Open-source multiplayer game server compatible with the RuneScape client
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Graham 21560b1afd Ignore fsync on directory failures 1 week ago
.idea Update run configurations 1 month ago
all Exclude JNR from minimization 1 month ago
archive Fix line length 2 weeks ago
asm Convert packclass try/catch count to an unsigned short smart 5 months ago
buffer Update GeneratedByteBufExtensions 2 months ago
buffer-generator Fix buffer-generator mainClass name 2 months ago
cache Optimise uncompression of encrypted groups with invalid keys 1 month ago
cache-550 Add sprite encoder/decoder 9 months ago
cache-cli Add command for unpacking RuneLite flatcaches 2 months ago
cli Add Gradle 7 version catalog 1 year ago
compress Add JNR-based bzip2 implementation compatible with Jagex's 2 months ago
compress-cli Add gzip-jagex command 4 months ago
conf Implement world list packet 11 months ago
crc32 Add Logback configuration file 9 months ago
crypto Annotate crypto methods with @Jvm{Overloads,Static} 1 month ago
db Update dependencies 5 months ago
decompiler Add Logback configuration file 9 months ago
deob Add Logback configuration file 9 months ago
deob-annotations Rename dev.openrs2 package to org.openrs2 2 years ago
deob-ast Add else branch to non-exhaustive when statements 6 months ago
deob-bytecode Ensure flow obstructor initializers always read a static field 1 week ago
deob-processor Use type-safe project accessors 1 year ago
deob-util Use type-safe project accessors 1 year ago
etc Implement world list packet 11 months ago
game Only remove handlers from pipeline if future is successful 4 months ago
gradle Update dependencies 4 weeks ago
http Set HttpClient timeouts 5 months ago
inject Add Gradle 7 version catalog 1 year ago
json Add JSON version of the /caches page 4 months ago
log Add Logback configuration file 9 months ago
net Disable io_uring for now 11 months ago
patcher Replace BIPUSH 1 with ICONST_1 4 months ago
protocol Fix off-by-one error in JS5 response buffer capacity calculation 5 months ago
share Add Jagex loc shape names to the glossary 4 weeks ago
util Ignore fsync on directory failures 1 week ago
xtea-plugin Add RuneLite plugin for collecting XTEA keys 4 months ago
yaml Add JSON version of the /caches page 4 months ago
.drone.yml Replace with 2 years ago
.editorconfig Use 2 space indents in JSON files 12 months ago
.gitignore Switch from Jenkins to Drone 2 years ago
.mailmap Map old Git author emails to 2 years ago Make slightly more accurate 11 months ago
DCO Move DCO to a separate file 2 years ago
LICENSE Update copyright year 4 months ago Remove old idea-bug reference 9 months ago
build.gradle.kts Manage plugin versions in libs.versions.toml 4 months ago Update Dokka to 1.4.0-rc 2 years ago
gradlew Update Gradle 9 months ago
gradlew.bat Update to Gradle 6.6 2 years ago
settings.gradle.kts Update Kotlin 4 weeks ago


Drone Discord ISC license


OpenRS2 is an open-source multiplayer game server and suite of associated tools. It is compatible with build 550 of the RuneScape client, which was released in late 2009.


OpenRS2 requires version 11 or later of the Java Development Kit.

The JDK is required even if a pre-built copy of OpenRS2 is used, as it depends on JDK-only tools, such as jarsigner, at runtime.

Non-free components

OpenRS2 requires the original RuneScape client code, data and location file encryption keys, which we cannot legally distribute.

These files must be manually placed in the nonfree directory (directly beneath the root of the repository), in the following structure:

├── lib
│   ├── jaggl.pack200
│   ├── loader_gl.jar
│   ├── loader.jar
│   ├── runescape_gl.pack200
│   ├── runescape.jar
│   └── unpackclass.pack
└── share
    ├── cache
    │   ├── 0
    │   │   ├── 0.dat
    │   │   └── ...
    │   ├── ...
    │   └── 255
    │       ├── ...
    │       └── 28.dat
    └── keys.json

The CRC-32 checksums and SHA-256 digests of the correct files are:

CRC-32 checksum SHA-256 digest File
-1418094567 d39578f4a88a376bcb2571f05da1939a14a80d8c4ed89a4eb172d9e525795fe2 jaggl.pack200
-2129469231 31182683ba04dc0ad45859161c13f66424b10deb0b2df10aa58b48bba57402db loader_gl.jar
-1516355035 ccdfaa86be07452ddd69f869ade86ea900dbb916fd853db16602edf2eb54211b loader.jar
-132784534 4a5032ea8079d2154617ae1f21dfcc46a10e023c8ba23a4827d5e25e75c73045 runescape_gl.pack200
1692522675 0ab28a95e7c5993860ff439ebb331c0df02ad40aa1f544777ed91b46d30d3d24 runescape.jar
-1911426584 7c090e07f8d754d09804ff6e9733ef3ba227893b6b639436db90977b39122590 unpackclass.pack

The .gitignore file includes the nonfree directory to prevent any non-free material from being accidentally included in the repository.


Run ./gradlew to download the dependencies, build the code, run the unit tests and package it.


OpenRS2 is available under the terms of the ISC license, which is similar to the 2-clause BSD license. The full copyright notice and terms are available in the LICENSE file.