Both sides previous revisionPrevious revisionNext revision | Previous revision |
games:linux:2004scape_localhost_244_wip [2025/07/15 22:21] – Sean Rhone | games:linux:2004scape_localhost_244_wip [2025/08/17 04:01] (current) – Done (no wip) Sean Rhone |
---|
====== Information ====== | |
| |
* Lost City ''244'' Server + Client | |
* [[https://lostcity.rs/t/singleplayer-main-branch-scripts-and-desktop-start-launchers-on-windows-linux-freebsd/54|Lost City Forums]] | |
| |
===== Media ===== | |
| |
* [[https://media.realmofespionage.xyz/index/category/2|Progress Pics]] | |
| |
===== Prerequisites ===== | |
| |
* [[linux;distros;opensuse_tumbleweed_gnome|openSUSE Tumbleweed (GNOME)]] | |
| |
====== Dependencies ====== | |
| |
* https://github.com/LostCityRS/Engine-TS/tree/244?tab=readme-ov-file#dependencies | |
| |
sudo zypper install git-core java-24-openjdk-headless | |
| |
===== bun ===== | |
| |
* [[https://github.com/oven-sh/bun/releases|oven-sh/bun]] | |
| |
rm -Rf '/tmp/bun-linux-x64'* && mkdir -p ~/'Projects/LostCity-244-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-244-EngineTS/ext' && rm -Rf '/tmp/bun-linux-x64'* | |
| |
====== Download Source ====== | |
| |
===== Engine-TS ===== | |
| |
* https://github.com/LostCityRS/Engine-TS/commits/244/ | |
| |
cd ~ && mkdir -p ~/'Projects' && rm -Rf ~/'Projects/LostCity-244-EngineTS/src' && git clone --branch '244' --depth '1' --recurse-submodules 'https://github.com/LostCityRS/Engine-TS.git' ~/'Projects/LostCity-244-EngineTS/src' | |
| |
===== Content ===== | |
| |
* https://github.com/LostCityRS/Content/commits/244/ | |
| |
cd ~ && mkdir -p ~/'Projects' && rm -Rf ~/'Projects/LostCity-244-EngineTS/content' && git clone --branch '244' --depth '1' --recurse-submodules 'https://github.com/LostCityRS/Content.git' ~/'Projects/LostCity-244-EngineTS/content' | |
| |
====== Initial Build ====== | |
| |
**** | |
| |
~/'Projects/LostCity-244-EngineTS/ext/bun' --cwd=$HOME/'Projects/LostCity-244-EngineTS/src' install | |
| |
====== Set-up ====== | |
| |
* Set up as a development world | |
| |
~/'Projects/LostCity-244-EngineTS/ext/bun' --cwd=$HOME/'Projects/LostCity-244-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/244/.env.example|New commits check]] | |
* [[https://github.com/LostCityRS/Engine-TS/blob/244/.env.example|Upstream Settings]] ([[https://raw.githubusercontent.com/LostCityRS/Engine-TS/refs/heads/244/.env.example|raw]]) | |
| |
mkdir -p ~/'Projects/LostCity-244-EngineTS/conf' && nano ~/'Projects/LostCity-244-EngineTS/conf/localhost.env' | |
| |
<code> | |
NODE_XPRATE=1 | |
NODE_PROFILE=localhost | |
NODE_STAFF=Test | |
NODE_DEBUGPROC_CHAR=: | |
NODE_CLIENT_ROUTEFINDER=false | |
| |
# End</code> | |
| |
====== Scripts ====== | |
| |
===== Server Start ===== | |
| |
mkdir -p ~/'Projects/LostCity-244-EngineTS/scripts' && nano ~/'Projects/LostCity-244-EngineTS/scripts/localhost-server-start.sh' && chmod +x ~/'Projects/LostCity-244-EngineTS/scripts/localhost-server-start.sh' | |
| |
<code> | |
#!/bin/bash | |
| |
~/'Projects/LostCity-244-EngineTS/ext/bun' --env-file=$HOME/'Projects/LostCity-244-EngineTS/conf/localhost.env' --cwd=$HOME/'Projects/LostCity-244-EngineTS/src' run 'quickstart' | |
| |
# End</code> | |
| |
~/'Projects/LostCity-244-EngineTS/scripts/localhost-server-start.sh' | |
| |
===== Server Update ===== | |
| |
mkdir -p ~/'Projects/LostCity-244-EngineTS/scripts' && nano ~/'Projects/LostCity-244-EngineTS/scripts/localhost-server-update.sh' && chmod +x ~/'Projects/LostCity-244-EngineTS/scripts/localhost-server-update.sh' | |
| |
<code> | |
#!/bin/bash | |
| |
git -C ~/'Projects/LostCity-244-EngineTS/src' reset --hard | |
git -C ~/'Projects/LostCity-244-EngineTS/src' pull origin '244' --rebase | |
| |
git -C ~/'Projects/LostCity-244-EngineTS/content' reset --hard | |
git -C ~/'Projects/LostCity-244-EngineTS/content' pull origin '244' --rebase | |
| |
~/'Projects/LostCity-244-EngineTS/ext/bun' --cwd=$HOME/'Projects/LostCity-244-EngineTS/src' run 'clean' | |
~/'Projects/LostCity-244-EngineTS/ext/bun' --cwd=$HOME/'Projects/LostCity-244-EngineTS/src' 'install' | |
~/'Projects/LostCity-244-EngineTS/ext/bun' --cwd=$HOME/'Projects/LostCity-244-EngineTS/src' run 'setup' | |
| |
zenity --title '2004Scape Updater' --text 'localhost server update complete' --icon ~/'Projects/LostCity-244-EngineTS/ext/favicon.ico' --timeout '2' --info | |
| |
# End</code> | |
| |
~/'Projects/LostCity-244-EngineTS/scripts/localhost-server-update.sh' | |
| |
===== Save Data Back-up ===== | |
| |
mkdir -p ~/'Projects/LostCity-244-EngineTS/scripts' && nano ~/'Projects/LostCity-244-EngineTS/scripts/localhost-save-backup.sh' && chmod +x ~/'Projects/LostCity-244-EngineTS/scripts/localhost-save-backup.sh' | |
| |
<code> | |
#!/bin/bash | |
| |
tar -czf ~/'Downloads/'$(date +%Y-%m-%d-%s)'-2004Scape-Server-localhost-Saves.tar.gz' -C ~/'Projects/LostCity-244-EngineTS/src/data/players' 'localhost' | |
| |
zenity --title '2004Scape Save Backup' --text 'Save Data Backed-up to Downloads' --icon ~/'Projects/LostCity-244-EngineTS/ext/favicon.ico' --timeout '2' --info | |
| |
# End</code> | |
| |
~/'Projects/LostCity-244-EngineTS/scripts/localhost-save-backup.sh' | |
| |
====== Extras ====== | |
| |
===== Icon ===== | |
| |
* https://raw.githubusercontent.com/2004Scape/Server/7b0f1ec303dc1f76c7b29a2fff83b5797dafa01b/public/favicon.ico | |
| |
rm -f '/tmp/2004Scape-favicon.ico' && mkdir -p ~/'Projects/LostCity-244-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-244-EngineTS/ext/favicon.ico' && ls ~/'Projects/LostCity-244-EngineTS/ext/favicon.ico' | |
| |
===== Map ===== | |
| |
* https://runescape.wiki/w/World_map#/media/File:June_2004_Map.jpg | |
* TODO: Check if up-to-date for ''244'' | |
| |
rm -f '/tmp/June_2004_Map.jpg' && mkdir -p ~/'Projects/LostCity-244-EngineTS/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/LostCity-244-EngineTS/ext/June_2004_Map.jpg' && ls ~/'Projects/LostCity-244-EngineTS/ext/June_2004_Map.jpg' | |
| |
===== SC55_zzdenis SoundFont ===== | |
| |
* https://www.doomworld.com/forum/topic/129928-new-sc55-soundfont-266mb-all-new-441k-samples/ | |
* https://drive.google.com/file/d/1wdYpwoCka8r7ZuIzPn1CHy13_4aP9oSq/view?usp=sharing | |
* ''SC55_zzdenis_v0.5.sf2'' | |
* Symlink above ''zenity'' line | |
| |
mkdir -p ~/'Projects/LostCity-244-EngineTS/ext' && sha384sum ~/'Downloads/SC55_zzdenis_v0.5.sf2' | grep 'f386f638777072fc220e39afbd7efcd227ca2bfcf13403bf47fbb2e2b8f4d151239710cc36c8530a75c3b4c3f55066b7' > '/dev/null' && mv -f ~/'Downloads/SC55_zzdenis_v0.5.sf2' ~/'Projects/LostCity-244-EngineTS/ext' | |
| |
nano ~/'Projects/LostCity-244-EngineTS/scripts/localhost-server-update.sh' | |
| |
ln -s -f ~/'Projects/LostCity-244-EngineTS/ext/SC55_zzdenis_v0.5.sf2' ~/'Projects/LostCity-244-EngineTS/src/public/client/SCC1_Florestan.sf2' | |
| |
ls -la ~/'Projects/LostCity-244-EngineTS/src/public/client/SCC1_Florestan.sf2' | |
| |
====== Desktop Launcher ====== | |
| |
===== 2004Scape ===== | |
| |
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' | |
| |
<code> | |
[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-Backup;Saves-Folder;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 "kgx -T '2004Scape Server' -e ~/'Projects/2004Scape-Server/scripts/localhost-server-start.sh'" | |
Name=Server - Start | |
| |
[Desktop Action Update] | |
Exec='/bin/bash' -c "kgx -T '2004Scape Updater' -e ~/'Projects/2004Scape-Server/scripts/localhost-server-update.sh'" | |
Name=Server - Update | |
| |
[Desktop Action Saves-Backup] | |
StartupNotify=false | |
Exec='/bin/bash' -c "~/'Projects/2004Scape-Server/scripts/localhost-save-backup.sh'" | |
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 Notes] | |
StartupNotify=false | |
Exec='/bin/bash' -c "gio open 'https://wiki.realmofespionage.xyz/games:linux:2004scape_localhost_244'" | |
Name=Install Notes | |
| |
# End</code> | |
| |
====== Quick Commands ====== | |
| |
===== Execute ===== | |
| |
* 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' | |
| |