• 2004Scape Server ¹⁾
• main Branch ²⁾

• These notes provide a local singleplayer server for 2004Scape ³⁾ on Windows

• Desktop and Start Menu Shortcuts Presentation Video

• Linux
• FreeBSD
• 2009Scape

• Windows 10 ⁴⁾

• World Map

• Feature Complete Progress
• Progress - Quests
• Projects List

• Rune-Server Forums
• Info post (Jul 3, 2024)

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

• Git, Java, NodeJS

• https://www.git-scm.com/download/win
• Last tested: Git-2.47.1-64-bit.exe

• No components required
• Git from the command line and also from 3rd-party software (make sure it's selected)
• Checkout as-is, commit as-is

• https://learn.microsoft.com/en-us/java/openjdk/download
• Last tested: microsoft-jdk-21.0.5-windows-x64.msi ⁵⁾

• Entire feature install of Microsoft Build of OpenJDK

• https://nodejs.org/en/download/prebuilt-installer
• Last tested: node-v23.4.0-x64.msi

• Node.js runtime, npm package manager, Add to PATH (corepack manager and Online documentation not required)
• Tools for Native Modules not required (leave “Automatically install the tools” unchecked)

• 80 TCP
• 43594 TCP
• 43595 TCP

• Allows loading the game applet and connecting to the server from other devices on LAN ⁶⁾
• This is optional if only doing localhost

netsh advfirewall firewall add rule name="2004Scape Server" dir="in" action="allow" protocol="tcp" localport="80,43594,43595" remoteip="localsubnet"

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

git clone --branch "main" --depth "1" --recurse-submodules "https://github.com/2004Scape/Server.git" "%UserProfile%\Projects\2004Scape-Server\src"

explorer "%UserProfile%\Projects\2004Scape-Server\src"

• Upstream Settings
• 2024/11/10: NODE_PORT=44594 seems like an easy fix to simultaneously-host 2009Scape

notepad "%UserProfile%\Projects\2004Scape-Server\src\.env"

WEB_PORT=80
NODE_PORT=44594
NODE_PRODUCTION=false
NODE_ALLOW_CHEATS=false
NODE_DEBUG=false
NODE_STAFF=Test

MKDIR "%UserProfile%\Projects\2004Scape-Server\scripts"

notepad "%UserProfile%\Projects\2004Scape-Server\scripts\localhost-server-start.bat"

@echo off

CD "%UserProfile%\Projects\2004Scape-Server\src"
npm start

:: End

notepad "%UserProfile%\Projects\2004Scape-Server\scripts\localhost-server-update.bat"

@echo off

git -C "%UserProfile%\Projects\2004Scape-Server\src" reset --hard
git -C "%UserProfile%\Projects\2004Scape-Server\src" pull origin "main" --rebase

CD "%UserProfile%\Projects\2004Scape-Server\src"
npm run "clean" && pause

:: End

notepad "%UserProfile%\Projects\2004Scape-Server\scripts\localhost-save-backup.bat"

@echo off

tar -cvzf "%UserProfile%\Downloads\%RANDOM%-2004Scape-Server-localhost-Saves.tar.gz" -C "%UserProfile%\Projects\2004Scape-Server\src\data" "players"

echo 2004Scape Save Data Backed-up Successfully to Downloads

pause

:: End

• Right-click Desktop → New → Shortcut

"%UserProfile%\Projects\2004Scape-Server\scripts\localhost-server-start.bat"

2004Scape Server

http://localhost:80

2004Scape

"%UserProfile%\Projects\2004Scape-Server\src\public\favicon.ico"

MKDIR "%AppData%\Microsoft\Windows\Start Menu\Programs\2004Scape"

• Right-click → New → Shortcut

explorer "%AppData%\Microsoft\Windows\Start Menu\Programs\2004Scape"

"%UserProfile%\Projects\2004Scape-Server\scripts\localhost-server-start.bat"

Server Start

http://localhost:80

2004Scape (Client)

"%UserProfile%\Projects\2004Scape-Server\src\public\favicon.ico"

"%UserProfile%\Projects\2004Scape-Server\scripts\localhost-server-update.bat"

Server Updater

"%UserProfile%\Projects\2004Scape-Server\scripts\localhost-save-backup.bat"

Save Data Back-up

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

Server - Updates Check

https://wiki.realmofespionage.xyz/games:windows:2004scape_localhost

Server - Install Notes

• Add Non-Steam Game → Browse…

"%ProgramFiles(x86)%\Microsoft\Edge\Application\msedge.exe"

• Name

2004Scape (localhost)

• Icon

"%UserProfile%\Projects\2004Scape-Server\src\public\favicon.ico"

• Start In

%SystemRoot%\Temp

• Launch Options

--single-process --proxy-server="localhost:80" --window-size="896,688" --kiosk --new-window "http://localhost:80" --edge-kiosk-type="public-browsing" --no-first-run

CD "%UserProfile%\Projects\2004Scape-Server\src" && npm start --verbose

"%UserProfile%\Projects\2004Scape-Server\scripts\localhost-server-start.bat"

• http://localhost:80

msedge --single-process --proxy-server="localhost:80" --window-size="896,688" --kiosk --new-window "http://localhost:80" --edge-kiosk-type="public-browsing" --no-first-run

• https://github.com/2004Scape/Server/commits/main/
• Running npm run clean requires starting the server once afterwards with an internet connection to download packages to start the server for playing offline

git -C "%UserProfile%\Projects\2004Scape-Server\src" reset --hard && git -C "%UserProfile%\Projects\2004Scape-Server\src" pull origin "main" --rebase && CD "%UserProfile%\Projects\2004Scape-Server\src" && npm run "clean"

"%UserProfile%\Projects\2004Scape-Server\scripts\localhost-server-update.bat"

• The tar command replaces Downloads\2004Scape-Server-localhost-Saves.tar.gz each time without back-up or date codes

explorer "%UserProfile%\Projects\2004Scape-Server\src\data\players"

tar -cvzf "%UserProfile%\Downloads\2004Scape-Server-localhost-Saves.tar.gz" -C "%UserProfile%\Projects\2004Scape-Server\src\data" "players"

"%UserProfile%\Projects\2004Scape-Server\scripts\localhost-save-backup.bat"

• Lists available npm commands

CD "%UserProfile%\Projects\2004Scape-Server\src" && npm run

explorer "%UserProfile%\Projects\2004Scape-Server\src"

explorer "%UserProfile%\Projects\2004Scape-Server\src\data\players"