| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| games:linux:2004scape_localhost [2025/04/25 02:07] – [Standalone Test] Sean Rhone | games:linux:2004scape_localhost [2025/10/21 04:58] (current) – xfce4-terminal -> kgx (GNOME) Sean Rhone |
|---|
| ====== Information ====== | ====== Information ====== |
| |
| * 2004Scape Server ((https://github.com/2004Scape/Server)) | * Lost City ''245'' Server + Client |
| | * [[https://lostcity.rs/t/singleplayer-main-branch-scripts-and-desktop-start-launchers-on-windows-linux-freebsd/54|Lost City Forums]] |
| * These notes provide a local single-player server for 2004Scape ((RSPS/RuneScape Private Server based on cache ''225'' from May 18th, 2004)) | |
| * Last tested commit: [[https://github.com/2004Scape/Server/commit/a82c2f5adcad2d61c8f4488efcb4b95c3b019105|a82c2f5]] | |
| |
| ===== Media ===== | ===== Media ===== |
| |
| * [[https://www.youtube.com/watch?v=E21y7rLZaNc|Launcher Presentation Video]] | |
| * [[https://media.realmofespionage.xyz/index/category/2|Progress Pics]] | * [[https://media.realmofespionage.xyz/index/category/2|Progress Pics]] |
| |
| ===== Prerequisites ===== | ===== Prerequisites ===== |
| |
| * [[linux;distros;opensuse_tumbleweed_gnome|openSUSE Tumbleweed (GNOME)]] | * [[linux:distros:opensuse_tumbleweed_xfce|openSUSE Tumbleweed (Xfce)]] |
| |
| ===== Resources ===== | ====== Dependencies ====== |
| |
| * [[https://lostcity.rs/t/singleplayer-main-branch-scripts-and-desktop-start-launchers-on-windows-linux-freebsd/54|Lost City Forums]] | * https://github.com/LostCityRS/Engine-TS/tree/245.2?tab=readme-ov-file#dependencies |
| * [[https://2004.lostcity.rs/worldmap|World Map]] (interactive) | |
| |
| ====== Dependencies ====== | sudo zypper install git-core java-21-openjdk-headless |
| | |
| | ===== Java Priority ===== |
| | |
| | * ''jre-21-openjdk'' |
| |
| * https://github.com/2004Scape/Server?tab=readme-ov-file#dependencies | sudo update-alternatives --config 'java' |
| |
| sudo zypper install git-core java-21-openjdk-headless nodejs22 npm22 | ===== bun ===== |
| | |
| | * [[https://github.com/oven-sh/bun/releases|oven-sh/bun]] |
| | |
| | rm -Rf '/tmp/bun-linux-x64'* && mkdir -p ~/'Projects/LostCity-245-EngineTS/ext' && wget -O '/tmp/bun-linux-x64.zip' 'https://github.com/oven-sh/bun/releases/latest/download/bun-linux-x64.zip' && unzip '/tmp/bun-linux-x64.zip' -d '/tmp' && mv -f '/tmp/bun-linux-x64/bun' ~/'Projects/LostCity-245-EngineTS/ext' && ~/'Projects/LostCity-245-EngineTS/ext/bun' --version && rm -Rf '/tmp/bun-linux-x64'* |
| |
| ====== Download Source ====== | ====== Download Source ====== |
| |
| * https://github.com/2004Scape/Server/commits/main/ | ===== Engine-TS ===== |
| | |
| | * https://github.com/LostCityRS/Engine-TS/commits/245.2/ |
| | |
| | cd ~ && mkdir -p ~/'Projects' && rm -Rf ~/'Projects/LostCity-245-EngineTS/src' && git clone --branch '245.2' --depth '1' --recurse-submodules 'https://github.com/LostCityRS/Engine-TS.git' ~/'Projects/LostCity-245-EngineTS/src' |
| | |
| | ===== Content ===== |
| | |
| | * https://github.com/LostCityRS/Content/commits/245.2/ |
| |
| 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 ~ && mkdir -p ~/'Projects' && rm -Rf ~/'Projects/LostCity-245-EngineTS/content' && git clone --branch '245.2' --depth '1' --recurse-submodules 'https://github.com/LostCityRS/Content.git' ~/'Projects/LostCity-245-EngineTS/content' |
| |
| ====== Initial Build ====== | ====== Initial Build ====== |
| **** | **** |
| |
| cd ~/'Projects/2004Scape-Server/src' && npm install --verbose | ~/'Projects/LostCity-245-EngineTS/ext/bun' --cwd=$HOME/'Projects/LostCity-245-EngineTS/src' install |
| |
| ====== Set-up ====== | ====== Set-up ====== |
| |
| **** | * Set up as a development world |
| |
| npm --prefix ~/'Projects/2004Scape-Server/src' run 'setup' | ~/'Projects/LostCity-245-EngineTS/ext/bun' --cwd=$HOME/'Projects/LostCity-245-EngineTS/src' run 'setup' |
| | |
| | ====== Settings ====== |
| | |
| | * Last commit: [[https://github.com/LostCityRS/Engine-TS/commit/de5fa4db73add4e7277f0a9045d6eeb3a0800f59|Jun 25, 2025]] ''de5fa4d'' |
| | * [[https://github.com/LostCityRS/Engine-TS/commits/245.2/.env.example|New commits check]] |
| | * [[https://github.com/LostCityRS/Engine-TS/blob/245.2/.env.example|Upstream Settings]] ([[https://raw.githubusercontent.com/LostCityRS/Engine-TS/refs/heads/245.2/.env.example|raw]]) |
| | |
| | mkdir -p ~/'Projects/LostCity-245-EngineTS/conf' && nano ~/'Projects/LostCity-245-EngineTS/conf/localhost.env' |
| | |
| | <code> |
| | NODE_XPRATE=1 |
| | NODE_PROFILE=localhost |
| | NODE_STAFF=Test |
| | NODE_DEBUGPROC_CHAR=: |
| | NODE_CLIENT_ROUTEFINDER=false |
| | |
| | # End</code> |
| |
| ====== Scripts ====== | ====== Scripts ====== |
| ===== Server Start ===== | ===== Server Start ===== |
| |
| 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' | mkdir -p ~/'Projects/LostCity-245-EngineTS/scripts' && nano ~/'Projects/LostCity-245-EngineTS/scripts/localhost-server-start.sh' && chmod +x ~/'Projects/LostCity-245-EngineTS/scripts/localhost-server-start.sh' |
| |
| <code> | <code> |
| #!/bin/bash | #!/bin/bash |
| |
| npm --prefix ~/'Projects/2004Scape-Server/src' run 'quickstart' | ~/'Projects/LostCity-245-EngineTS/ext/bun' --env-file=$HOME/'Projects/LostCity-245-EngineTS/conf/localhost.env' --cwd=$HOME/'Projects/LostCity-245-EngineTS/src' run 'quickstart' |
| |
| # End</code> | # End</code> |
| |
| ~/'Projects/2004Scape-Server/scripts/localhost-server-start.sh' | ~/'Projects/LostCity-245-EngineTS/scripts/localhost-server-start.sh' |
| |
| ===== Server Update ===== | ===== Server Update ===== |
| |
| 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' | mkdir -p ~/'Projects/LostCity-245-EngineTS/scripts' && nano ~/'Projects/LostCity-245-EngineTS/scripts/localhost-server-update.sh' && chmod +x ~/'Projects/LostCity-245-EngineTS/scripts/localhost-server-update.sh' |
| |
| <code> | <code> |
| #!/bin/bash | #!/bin/bash |
| |
| git -C ~/'Projects/2004Scape-Server/src' reset --hard | git -C ~/'Projects/LostCity-245-EngineTS/src' reset --hard |
| git -C ~/'Projects/2004Scape-Server/src' pull origin 'main' --rebase | git -C ~/'Projects/LostCity-245-EngineTS/src' pull origin '245.2' --rebase |
| |
| npm --prefix ~/'Projects/2004Scape-Server/src' run 'clean' | git -C ~/'Projects/LostCity-245-EngineTS/content' reset --hard |
| npm --prefix ~/'Projects/2004Scape-Server/src' install | git -C ~/'Projects/LostCity-245-EngineTS/content' pull origin '245.2' --rebase |
| npm --prefix ~/'Projects/2004Scape-Server/src' run 'setup' | |
| |
| zenity --title '2004Scape Updater' --text 'localhost server update complete' --icon ~/'Projects/2004Scape-Server/ext/favicon.ico' --timeout '2' --info | ~/'Projects/LostCity-245-EngineTS/ext/bun' --cwd=$HOME/'Projects/LostCity-245-EngineTS/src' run 'clean' |
| | ~/'Projects/LostCity-245-EngineTS/ext/bun' --cwd=$HOME/'Projects/LostCity-245-EngineTS/src' 'install' |
| | ~/'Projects/LostCity-245-EngineTS/ext/bun' --cwd=$HOME/'Projects/LostCity-245-EngineTS/src' run 'setup' |
| | |
| | zenity --title '2004Scape Updater' --text 'localhost server update complete' --icon ~/'Projects/LostCity-245-EngineTS/ext/favicon.ico' --timeout '1' --info |
| |
| # End</code> | # End</code> |
| |
| ~/'Projects/2004Scape-Server/scripts/localhost-server-update.sh' | ~/'Projects/LostCity-245-EngineTS/scripts/localhost-server-update.sh' |
| |
| ===== Save Data Back-up ===== | ===== Save Data Back-up ===== |
| |
| 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' | mkdir -p ~/'Projects/LostCity-245-EngineTS/scripts' && nano ~/'Projects/LostCity-245-EngineTS/scripts/localhost-save-backup.sh' && chmod +x ~/'Projects/LostCity-245-EngineTS/scripts/localhost-save-backup.sh' |
| |
| <code> | <code> |
| #!/bin/bash | #!/bin/bash |
| |
| tar -czf ~/'Downloads/'$(date +%Y-%m-%d-%s)'-2004Scape-Server-localhost-Saves.tar.gz' -C ~/'Projects/2004Scape-Server/src/data/players' 'main' | tar -czf ~/'Downloads/'$(date +%Y-%m-%d-%s)'-2004Scape-localhost-Saves.tar.gz' -C ~/'Projects/LostCity-245-EngineTS/src/data/players' 'localhost' |
| |
| zenity --title '2004Scape Save Backup' --text 'Save Data Backed-up to Downloads' --icon ~/'Projects/2004Scape-Server/ext/favicon.ico' --timeout '2' --info | zenity --title '2004Scape Save Backup' --text 'Save Data Backed-up to Downloads' --icon ~/'Projects/LostCity-245-EngineTS/ext/favicon.ico' --timeout '1' --info |
| |
| # End</code> | # End</code> |
| |
| ~/'Projects/2004Scape-Server/scripts/localhost-save-backup.sh' | ~/'Projects/LostCity-245-EngineTS/scripts/localhost-save-backup.sh' |
| |
| ====== Extras ====== | ====== Extras ====== |
| * https://raw.githubusercontent.com/2004Scape/Server/7b0f1ec303dc1f76c7b29a2fff83b5797dafa01b/public/favicon.ico | * 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' | rm -f '/tmp/2004Scape-favicon.ico' && mkdir -p ~/'Projects/LostCity-245-EngineTS/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/LostCity-245-EngineTS/ext/favicon.ico' && ls ~/'Projects/LostCity-245-EngineTS/ext/favicon.ico' |
| |
| ===== Map ===== | ===== Map ===== |
| * https://runescape.wiki/w/World_map#/media/File:June_2004_Map.jpg | * 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' | rm -f '/tmp/June_2004_Map.jpg' && mkdir -p ~/'Projects/LostCity-245-EngineTS/ext' && wget -O '/tmp/June_2004_Map.jpg' 'https://runescape.wiki/images/June_2004_Map.jpg?35d17' --user-agent='script' && sha384sum '/tmp/June_2004_Map.jpg' | grep 'abfdfe4597975addbb9d79d2cce2e56f0054f2742f351bd9dc700f55e91157e6c2142749f113927b027ed42efb8ad833' > '/dev/null' && mv -f '/tmp/June_2004_Map.jpg' ~/'Projects/LostCity-245-EngineTS/ext/June_2004_Map.jpg' && ls ~/'Projects/LostCity-245-EngineTS/ext/June_2004_Map.jpg' |
| |
| ===== Fluid GM SoundFont ====== | ===== SC55_zzdenis SoundFont ===== |
| |
| * ''FluidR3_GM.sf2'' | * https://www.doomworld.com/forum/topic/129928-new-sc55-soundfont-266mb-all-new-441k-samples/ |
| * Add symlink above ''zenity'' in [[#server_update|update script]] | * https://drive.google.com/file/d/1wdYpwoCka8r7ZuIzPn1CHy13_4aP9oSq/view?usp=sharing |
| | * ''SC55_zzdenis_v0.5.sf2'' |
| | * Symlink above ''zenity'' line |
| |
| sudo zypper install 'fluid-soundfont-gm' | mkdir -p ~/'Projects/LostCity-245-EngineTS/ext' && sha384sum ~/'Downloads/SC55_zzdenis_v0.5.sf2' | grep 'f386f638777072fc220e39afbd7efcd227ca2bfcf13403bf47fbb2e2b8f4d151239710cc36c8530a75c3b4c3f55066b7' > '/dev/null' && mv -f ~/'Downloads/SC55_zzdenis_v0.5.sf2' ~/'Projects/LostCity-245-EngineTS/ext' |
| |
| nano ~/'Projects/2004Scape-Server/scripts/localhost-server-update.sh' | nano ~/'Projects/LostCity-245-EngineTS/scripts/localhost-server-update.sh' |
| |
| ln -s -f '/usr/share/sounds/sf2/FluidR3_GM.sf2' ~/'Projects/2004Scape-Server/src/public/client/SCC1_Florestan.sf2' | ln -s -f ~/'Projects/LostCity-245-EngineTS/ext/SC55_zzdenis_v0.5.sf2' ~/'Projects/LostCity-245-EngineTS/src/public/client/SCC1_Florestan.sf2' |
| |
| ls -la ~/'Projects/2004Scape-Server/src/public/client/SCC1_Florestan.sf2' | ===== Login Autofill ===== |
| | |
| | * [[https://github.com/2004Scape/Server/issues/1498|#1498]] |
| | * ''sed'' above ''zenity'' line |
| | |
| | nano ~/'Projects/LostCity-245-EngineTS/scripts/localhost-server-update.sh' |
| | |
| | sed -i -e 's/username="";password=""/username="Espionage724";password="1"/g' ~/'Projects/LostCity-245-EngineTS/src/public/client/client.js' |
| |
| ====== Desktop Launcher ====== | ====== Desktop Launcher ====== |
| Type=Application | Type=Application |
| StartupNotify=false | StartupNotify=false |
| Icon=/home/CHANGEME/Projects/2004Scape-Server/ext/favicon.ico | Icon=/home/CHANGEME/Projects/LostCity-245-EngineTS/ext/favicon.ico |
| Actions=Map;Server;Update;Saves-Backup;Saves-Folder;Commits;Notes; | Actions=Map;Server;Update;Saves;Notes; |
| |
| [Desktop Action Map] | [Desktop Action Map] |
| StartupNotify=false | Exec='/bin/bash' -c "gio open ~/'Projects/LostCity-245-EngineTS/ext/June_2004_Map.jpg'" |
| Exec='/bin/bash' -c "gio open ~/'Projects/2004Scape-Server/ext/June_2004_Map.jpg'" | |
| Name=World Map | Name=World Map |
| |
| [Desktop Action Server] | [Desktop Action Server] |
| Exec='/bin/bash' -c "kgx -T '2004Scape Server' -e ~/'Projects/2004Scape-Server/scripts/localhost-server-start.sh'" | Exec='/bin/bash' -c "kgx -T '2004Scape - Server' -e ~/'Projects/LostCity-245-EngineTS/scripts/localhost-server-start.sh'" |
| Name=Server - Start | Name=Server - Start |
| |
| [Desktop Action Update] | [Desktop Action Update] |
| Exec='/bin/bash' -c "kgx -T '2004Scape Updater' -e ~/'Projects/2004Scape-Server/scripts/localhost-server-update.sh'" | Exec='/bin/bash' -c "kgx -T '2004Scape Updater' -e ~/'Projects/LostCity-245-EngineTS/scripts/localhost-server-update.sh'" |
| Name=Server - Update | Name=Server Update |
| |
| [Desktop Action Saves-Backup] | [Desktop Action Saves] |
| StartupNotify=false | Exec='/bin/bash' -c "~/'Projects/LostCity-245-EngineTS/scripts/localhost-save-backup.sh'" |
| Exec='/bin/bash' -c "~/'Projects/2004Scape-Server/scripts/localhost-save-backup.sh'" | |
| Name=Save Data Back-up | Name=Save Data Back-up |
| |
| [Desktop Action Saves-Folder] | |
| StartupNotify=false | |
| Exec='/bin/bash' -c "gio open ~/'Projects/2004Scape-Server/src/data/players'" | |
| Name=Save Folder | |
| |
| [Desktop Action Commits] | |
| StartupNotify=false | |
| Exec='/bin/bash' -c "gio open 'https://github.com/2004Scape/Server/commits/main/'" | |
| Name=Updates Check | |
| |
| [Desktop Action Notes] | [Desktop Action Notes] |
| StartupNotify=false | |
| Exec='/bin/bash' -c "gio open 'https://wiki.realmofespionage.xyz/games:linux:2004scape_localhost'" | Exec='/bin/bash' -c "gio open 'https://wiki.realmofespionage.xyz/games:linux:2004scape_localhost'" |
| Name=Install Notes | Name=Install Notes |
| ====== Quick Commands ====== | ====== Quick Commands ====== |
| |
| ===== Execute ===== | ===== Save Restore ===== |
| | |
| * http://localhost:8888/rs2.cgi | |
| | |
| cd ~/'Projects/2004Scape-Server/src' && npm run 'quickstart' --verbose | |
| | |
| ===== Update ===== | |
| | |
| * 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 && npm --prefix ~/'Projects/2004Scape-Server/src' run 'clean' --verbose && npm --prefix ~/'Projects/2004Scape-Server/src' install --verbose && npm --prefix ~/'Projects/2004Scape-Server/src' run 'setup' --verbose | |
| | |
| ===== Save Data Back-up ===== | |
| | |
| **** | |
| | |
| tar -cvzf ~/'Downloads/'$(date +%Y-%m-%d-%s)'-2004Scape-Server-localhost-Saves.tar.gz' -C ~/'Projects/2004Scape-Server/src/data/players' 'main' | |
| | |
| ===== File Manager ===== | |
| | |
| ==== Save Data ==== | |
| | |
| * :?: 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' | |
| | |
| ===== Other Terminals ===== | |
| | |
| '/bin/bash' -c "gnome-terminal --window -t '2004Scape — Server' -- bash -c ~/'Projects/2004Scape-Server/scripts/localhost-server-start.sh'" | |
| | |
| '/bin/bash' -c "konsole -p tabtitle='2004Scape localhost Server' -e ~/'Projects/2004Scape-Server/scripts/localhost-server-start.sh'" | |
| | |
| '/bin/bash' -c "ptyxis --standalone --title='2004Scape Server — ' -- ~/'Projects/2004Scape-Server/scripts/localhost-server-start.sh'" | |
| | |
| '/bin/bash' -c "xfce4-terminal -T '2004Scape — Updater' -I ~/'Projects/2004Scape-Server/ext/favicon.ico' -e ~/'Projects/2004Scape-Server/scripts/localhost-server-update.sh'" | |
| | |
| ====== Troubleshooting ====== | |
| | |
| ===== Specific Commit Rebase ===== | |
| | |
| * 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' | |
| | |
| ====== Standalone Test ====== | |
| |
| sudo zypper install 'webkit2gtk4-minibrowser' | * ''src/data/players/localhost/espionage724.sav'' |
| |
| '/usr/libexec/libwebkitgtk-6_0-0/MiniBrowser' --autoplay-policy 'allow' --private 'http://localhost:8888/rs2.cgi' | mkdir -p ~/'Projects/LostCity-245-EngineTS/src/data/players/localhost' && gio open ~/'Projects/LostCity-245-EngineTS/src/data/players/localhost' |
| |