Overview

The cache is 13.6GB. It's highly recommended to download the pre-processed cache from the link below if you don't want to wait for it to build.
Jump down to the DIY Cache Setup section if you understand and want to build it yourself.

Requirements

• Git
• Node 20 or newer (for the server)
• Java 8 or newer (for the client)
• 910 RS3 Cache "2019Scape-Pack.7z" on mega.nz (caches are paired to clients)

Server Setup

1. You'll need the server repository (you are here). Clone it down.
2. Download the cache and extract it to data/ so you have a data/pack/ folder inside.
3. Start the server using npm start.
4. Build the cache patches using npm run cache:build.

git clone https://github.com/LostCityRS/2019Scape
cd 2019Scape
npm ci
# this line is not a command. go ahead and extract 2019Scape-Pack.7z to data/ now.
npm run cache:build
npm run dev

Client Setup

1. Clone the client repository.
2. Start the client using ./gradlew run.

git clone https://github.com/LostCityRS/2019Scape-Client
cd 2019Scape-Client
./gradlew run

DIY Cache Setup

OpenRS2 Cache

This grabs a flat-file.tar.gz from OpenRS2, extracts it, and packs it into the .js5 format.

As a result it takes 3 times the disk space (download, extract, pack). You'll want to delete the data/cache/ folder afterwards to reclaim some space.

cd 2019Scape
npm run js5pack:openrs2

If anything goes wrong with the download you can get the flat file cache manually from OpenRS2. Then move the file to data/cache/1730/ and rename it to flat-file.tar.gz. Run npm run js5pack:openrs2 again and it will see the tar is downloaded, ready to extract.

Dat-per-Idx Cache

Place your main_file_cache files inside data/cache/.

cd 2019Scape
npm run js5pack:dat2split

Delete the data/cache/dump/ folder afterwards to reclaim some space.