• 2004Scape Server ¹⁾

• These notes provide a local single-player server for 2004Scape ²⁾
• Last tested commit: 6af5422

• Launcher Presentation Video
• Progress Pics

• Ubuntu

• Lost City Forums
• World Map (interactive)

• https://github.com/2004Scape/Server?tab=readme-ov-file#dependencies

sudo apt install git node-latest-version npm openjdk-24-jre-headless

• https://github.com/2004Scape/Server/commits/main/

cd ~ && mkdir -p ~/'Projects' && rm -Rf ~/'Projects/2004Scape-Server/src' && git clone --branch 'main' --depth '1' --recurse-submodules 'https://github.com/2004Scape/Server.git' ~/'Projects/2004Scape-Server/src' && sync

cd ~/'Projects/2004Scape-Server/src' && npm install --verbose

• Set up as a development world

cd ~/'Projects/2004Scape-Server/src' && npm run 'setup'

mkdir -p ~/'Projects/2004Scape-Server/scripts' && nano ~/'Projects/2004Scape-Server/scripts/localhost-server-start.sh' && chmod +x ~/'Projects/2004Scape-Server/scripts/localhost-server-start.sh'

#!/bin/bash

cd ~/'Projects/2004Scape-Server/src'
npm run 'quickstart'

# End

~/'Projects/2004Scape-Server/scripts/localhost-server-start.sh'

mkdir -p ~/'Projects/2004Scape-Server/scripts' && nano ~/'Projects/2004Scape-Server/scripts/localhost-server-update.sh' && chmod +x ~/'Projects/2004Scape-Server/scripts/localhost-server-update.sh'

#!/bin/bash

git -C ~/'Projects/2004Scape-Server/src' reset --hard
git -C ~/'Projects/2004Scape-Server/src' pull origin 'main' --rebase

cd ~/'Projects/2004Scape-Server/src'
npm run 'clean'
npm install
npm run 'setup'

notify-send -a '2004Scape' -e -i ~/'Projects/2004Scape-Server/ext/favicon.ico' '2004Scape localhost server update complete'

# End

~/'Projects/2004Scape-Server/scripts/localhost-server-update.sh'

mkdir -p ~/'Projects/2004Scape-Server/scripts' && nano ~/'Projects/2004Scape-Server/scripts/localhost-save-backup.sh' && chmod +x ~/'Projects/2004Scape-Server/scripts/localhost-save-backup.sh'

#!/bin/bash

tar -czf ~/'Downloads/'$(date +%Y-%m-%d-%s)'-2004Scape-Server-localhost-Saves.tar.gz' -C ~/'Projects/2004Scape-Server/src/data/players' 'main'

notify-send -a '2004Scape' -e -i ~/'Projects/2004Scape-Server/ext/favicon.ico' '2004Scape Save Data Backed-up Successfully to Downloads'

# End

~/'Projects/2004Scape-Server/scripts/localhost-save-backup.sh'

• https://raw.githubusercontent.com/2004Scape/Server/7b0f1ec303dc1f76c7b29a2fff83b5797dafa01b/public/favicon.ico

rm -f '/tmp/2004Scape-favicon.ico' && mkdir -p ~/'Projects/2004Scape-Server/ext' && wget -O '/tmp/2004Scape-favicon.ico' 'https://raw.githubusercontent.com/2004Scape/Server/7b0f1ec303dc1f76c7b29a2fff83b5797dafa01b/public/favicon.ico' && sha384sum '/tmp/2004Scape-favicon.ico' | grep 'c70ef71357951b3c1895cf205746eb93959cf8031d1f83b6f43d8a9efbb272d79ed6b4a64fb1c39f6898ed56601bfc63' > '/dev/null' && mv -f '/tmp/2004Scape-favicon.ico' ~/'Projects/2004Scape-Server/ext/favicon.ico' && ls ~/'Projects/2004Scape-Server/ext/favicon.ico'

• https://runescape.wiki/w/World_map#/media/File:June_2004_Map.jpg

rm -f '/tmp/June_2004_Map.jpg' && mkdir -p ~/'Projects/2004Scape-Server/ext' && wget -O '/tmp/June_2004_Map.jpg' 'https://runescape.wiki/images/June_2004_Map.jpg?35d17' && sha384sum '/tmp/June_2004_Map.jpg' | grep 'abfdfe4597975addbb9d79d2cce2e56f0054f2742f351bd9dc700f55e91157e6c2142749f113927b027ed42efb8ad833' > '/dev/null' && mv -f '/tmp/June_2004_Map.jpg' ~/'Projects/2004Scape-Server/ext/June_2004_Map.jpg' && ls ~/'Projects/2004Scape-Server/ext/June_2004_Map.jpg'

• Add symlink above notify-send in update script
• TimGM6mb.sf2

sudo apt install musescore-general-soundfont-lossless timgm6mb-soundfont opl3-soundfont fluidr3mono-gm-soundfont csound-soundfont

nano ~/'Projects/2004Scape-Server/scripts/localhost-server-update.sh'

ls '/usr/share/sounds/sf2'

ln -f -s '/usr/share/sounds/sf2/x' ~/'Projects/2004Scape-Server/src/public/client/SCC1_Florestan.sf2'

mkdir -p ~/'.local/share/applications' && nano ~/'.local/share/applications/2004Scape-localhost.desktop' && sed -i 's/'CHANGEME'/'$USER'/g' ~/'.local/share/applications/2004Scape-localhost.desktop' && update-desktop-database --quiet ~/'.local/share/applications'

[Desktop Entry]
Name=2004Scape
Categories=Game;
Exec='/bin/bash' -c "gio open 'http://localhost:8888/rs2.cgi'"
Type=Application
StartupNotify=false
Icon=/home/CHANGEME/Projects/2004Scape-Server/ext/favicon.ico
Actions=Map;Server;Update;Saves;Notes;

[Desktop Action Map]
StartupNotify=false
Exec='/bin/bash' -c "gio open ~/'Projects/2004Scape-Server/ext/June_2004_Map.jpg'"
Name=World Map

[Desktop Action Server]
Exec='/bin/bash' -c "gnome-terminal --window -t '2004Scape — Server' -- bash -c ~/'Projects/2004Scape-Server/scripts/localhost-server-start.sh'"
Name=Server - Start

[Desktop Action Update]
Exec='/bin/bash' -c "gnome-terminal --window -t '2004Scape — Updater' -- bash -c ~/'Projects/2004Scape-Server/scripts/localhost-server-update.sh'"
Name=Server - Update

[Desktop Action Saves]
StartupNotify=false
Exec='/bin/bash' -c "~/'Projects/2004Scape-Server/scripts/localhost-save-backup.sh'"
Name=Save Data Back-up

[Desktop Action Notes]
StartupNotify=false
Exec='/bin/bash' -c "gio open 'https://wiki.realmofespionage.xyz/games:linux:2004scape_localhost'"
Name=Install Notes

# End

• http://localhost:8888/rs2.cgi

cd ~/'Projects/2004Scape-Server/src' && npm run 'quickstart' --verbose

• https://github.com/2004Scape/Server/commits/main/

git -C ~/'Projects/2004Scape-Server/src' reset --hard && git -C ~/'Projects/2004Scape-Server/src' pull origin 'main' --rebase && cd ~/'Projects/2004Scape-Server/src' && npm run 'clean' --verbose && npm install --verbose && npm run 'setup' --verbose

tar -cvzf ~/'Downloads/'$(date +%Y-%m-%d-%s)'-2004Scape-Server-localhost-Saves.tar.gz' -C ~/'Projects/2004Scape-Server/src/data/players' 'main'

• Restoring a .sav may require logging in once to Tutorial Island, logging out, then re-restoring the .sav

mkdir -p ~/'Projects/2004Scape-Server/src/data/players' && gio open ~/'Projects/2004Scape-Server/src/data/players'

• https://github.com/2004Scape/Server/commits/main/

git -C ~/'Projects/2004Scape-Server/src' reset --hard '42af1c2d152c9cfa174a49f56b51906d8a2c8374'

git -C ~/'Projects/2004Scape-Server/src' pull origin --rebase '42af1c2d152c9cfa174a49f56b51906d8a2c8374'

cd ~/'Projects/2004Scape-Server/src' && npm run 'clean'