RoE | Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Information ======

  * 2004Scape Server ((https://github.com/2004Scape/Server))

  * 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/402159840ef48b990b1e8ac2ea20aaec16e9e3f5|4021598]]

===== Media =====

  * [[https://www.youtube.com/watch?v=E21y7rLZaNc|Launcher Presentation Video]]
  * [[https://media.realmofespionage.xyz/index/category/2|Progress Pics]]

===== Prerequisites =====

  * [[linux;distros;opensuse_tumbleweed_gnome|openSUSE Tumbleweed (GNOME)]]

===== Resources =====

  * [[https://lostcity.rs/t/singleplayer-main-branch-scripts-and-desktop-start-launchers-on-windows-linux-freebsd/54|Lost City Forums]]
  * [[https://2004.lostcity.rs/worldmap|World Map]] (interactive)

====== Dependencies ======

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

  sudo zypper install git-core java-21-openjdk-headless nodejs22 npm22

====== Download Source ======

  * 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

====== Initial Build ======

****

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

====== Set-up ======

****

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

====== Scripts ======

===== 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'

<code>
#!/bin/bash

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

# End</code>

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

===== 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'

<code>
#!/bin/bash

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'
npm --prefix ~/'Projects/2004Scape-Server/src' install
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

# End</code>

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

===== 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'

<code>
#!/bin/bash

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

zenity --title '2004Scape Save Backup' --text 'Save Data Backed-up to Downloads' --icon ~/'Projects/2004Scape-Server/ext/favicon.ico' --timeout '2' --info

# End</code>

  ~/'Projects/2004Scape-Server/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/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'

===== Map =====

  * 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'

===== 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''
  * Add symlink above ''zenity'' in [[#server_update|Update script]]

  mkdir -p ~/'Projects/2004Scape-Server/ext' && sha384sum ~/'Downloads/SC55_zzdenis_v0.5.sf2' | grep 'f386f638777072fc220e39afbd7efcd227ca2bfcf13403bf47fbb2e2b8f4d151239710cc36c8530a75c3b4c3f55066b7' > '/dev/null' && mv -f ~/'Downloads/SC55_zzdenis_v0.5.sf2' ~/'Projects/2004Scape-Server/ext'

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

  ln -s -f ~/'Projects/2004Scape-Server/ext/SC55_zzdenis_v0.5.sf2' ~/'Projects/2004Scape-Server/src/public/client/SCC1_Florestan.sf2'

  ls -la ~/'Projects/2004Scape-Server/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>
# 2004Scape-localhost.desktop

[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;Commits;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 Commits]
StartupNotify=false
Exec='/bin/bash' -c "gio open 'https://github.com/2004Scape/Server/commits/main/'"
Name=Commits Check

[Desktop Action Notes]
StartupNotify=false
Exec='/bin/bash' -c "gio open 'https://wiki.realmofespionage.xyz/games:linux:2004scape_localhost'"
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'

===== 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'