Open-source multiplayer game server compatible with the RuneScape client https://www.openrs2.org/
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 9cd2c25601 Switch to vendored implementation of Pack200 1 month ago
.github/workflows Re-add support for deploying with CI 1 year ago
.idea Update run configurations 3 years ago
all Update clikt 1 month ago
archive Switch to vendored implementation of Pack200 1 month ago
asm Switch to vendored implementation of Pack200 1 month ago
buffer Update Guice 1 year ago
buffer-generator Update clikt 1 month ago
cache Fix Js5MasterIndex creation if the LENGTHS format is used 10 months ago
cache-550 Update Guice 1 year ago
cache-cli Update clikt 1 month ago
cli Add Gradle 7 version catalog 4 years ago
compress Add blank line between is blocks 2 years ago
compress-cli Switch to vendored implementation of Pack200 1 month ago
conf Add support for dedicated activity flag 1 year ago
crc32 Update clikt 1 month ago
crypto Rename XteaKey to SymmetricKey 1 year ago
db Update dependencies 3 years ago
decompiler Update clikt 1 month ago
deob Update clikt 1 month ago
deob-annotations Rename dev.openrs2 package to org.openrs2 4 years ago
deob-ast Update clikt 1 month ago
deob-bytecode Update clikt 1 month ago
deob-processor Add blank line between is blocks 2 years ago
deob-util Update Guice 1 year ago
etc Implement world list packet 3 years ago
game Update clikt 1 month ago
gradle Switch to vendored implementation of Pack200 1 month ago
http Update Guice 1 year ago
inject Add assisted injection extension 2 years ago
json Update Guice 1 year ago
log Switch to Ktor's Jetty backend 2 years ago
net Update Guice 1 year ago
patcher Update clikt 1 month ago
protocol Format WorldListResponseCodec 1 year ago
share Make enabled transformers and their order configurable in profile 10 months ago
util Add ZipInputStreamExtensions 1 year ago
xtea-plugin Remove PF4J 1 year ago
yaml Update Guice 1 year ago
.editorconfig Ignore ktlint rules we're not compatible with yet 1 year ago
.gitignore Remove Drone configuration 1 year ago
.mailmap Map old Git author emails to openrs2.org 4 years ago
CONTRIBUTING.md Make CONTRIBUTING.md slightly more accurate 3 years ago
DCO Move DCO to a separate file 5 years ago
LICENSE Update copyright year 2 years ago
README.md Replace Drone badge with GitHub Actions 1 year ago
build.gradle.kts Update dependencies 1 month ago
gradle.properties Update Dokka to 1.4.0-rc 4 years ago
gradlew Update Gradle 1 month ago
gradlew.bat Update Gradle 1 month ago
settings.gradle.kts Update dependencies 1 month ago

README.md

OpenRS2

GitHub Actions Discord ISC license

Introduction

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.

Prerequisites

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:

nonfree
├── 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.

Building

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

License

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.