====== Information ======

  * 2009Scape Server ((https://gitlab.com/2009scape/2009scape))

  * These notes provide a local single-player server for 2009Scape ((RSPS/RuneScape Private Server based on cache ''530'' from 2009, [[https://gitlab.com/2009scape/2009scape#history-of-this-codebase|more info]]))

===== Media =====

  * [[https://media.realmofespionage.xyz/index/category/3|Progress Pics]]

===== Prerequisites =====

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

===== Notes =====

  * For a game client, see [[games:linux:rt4_client_runescape_530|RT4 Client]]

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

  * https://gitlab.com/2009scape/2009scape#prerequisites

  sudo zypper install git-core git-lfs java-17-openjdk-headless java-25-openjdk-headless

===== Java Priority =====

  * ''/usr/lib64/jvm/jre-25-openjdk/bin/java''

  sudo update-alternatives --config 'java'

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

  * https://gitlab.com/2009scape/2009scape/-/commits/master?ref_type=HEADS

  cd ~ && mkdir -p ~/'Projects' && rm -Rf ~/'Projects/2009Scape-Server/src' && git clone --branch 'master' --depth '1' --recurse-submodules 'https://gitlab.com/2009scape/2009scape.git' ~/'Projects/2009Scape-Server/src' && sync

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

  * 5 minutes i5-8400H ((2025/10/21: ''04:18 min''))

  cd ~/'Projects/2009Scape-Server/src/Server' && JAVA_HOME='/usr/lib64/jvm/java-17-openjdk-17' ~/'Projects/2009Scape-Server/src/Server/mvnw' 'clean' 'package' -DskipTests

====== Settings ======

  * Last commit: [[https://gitlab.com/2009scape/2009scape/-/commit/dfb53cfa03fff99374e60875e01a16f10d995749|November 25, 2025]] ''dfb53cfa''
  * [[https://gitlab.com/2009scape/2009scape/-/commits/master/Server/worldprops/default.conf?ref_type=heads|New commits check]]
  * [[https://gitlab.com/2009scape/2009scape/-/blob/master/Server/worldprops/default.conf?ref_type=heads|Upstream worldprops/default.conf]] ([[https://gitlab.com/2009scape/2009scape/-/raw/master/Server/worldprops/default.conf?ref_type=heads|raw]])
  * [[https://gitlab.com/2009scape/2009scape/-/blob/master/Server/src/main/core/game/worldevents/holiday/HolidayRandoms.kt|HolidayRandoms.kt]]

  mkdir -p ~/'Projects/2009Scape-Server/conf' && nano ~/'Projects/2009Scape-Server/conf/localhost.conf'

<code>
[server]
log_level = "detailed"
secret_key = "2009scape_development"
write_logs = false
msip = "127.0.0.1"
preload_map = false
use_auth = false
persist_accounts = false
noauth_default_admin = false
daily_accounts_per_ip = 3
watchdog_enabled = false
connectivity_check_url = "localhost"
connectivity_timeout = 500

[database]
database_name = "2009scape"
database_username = "2009scape"
database_password = "x"
database_address = "127.0.0.1"
database_port = "3306"

[integrations]
grafana_logging = false
grafana_log_path = "@data/logs"
grafana_log_ttl_days = 1

[world]
name = "2009Scape (::1)"
name_ge = "2009Scape"
debug = false
dev = false
start_gui = false
daily_restart = false
world_id = "1"
country_id = "0"
members = true
activity = "2009Scape Classic."
pvp = false
enable_default_clan = false
enable_bots = false
motw_identifier = "0"
motw_text = "Welcome to your localhost server!"
new_player_location = "2524,5002,0"
home_location = "3222,3218,0"
autostock_ge = false
allow_token_purchase = false
skillcape_perks = false
increased_door_time = false
enable_botting = false
max_adv_bots = 100
enable_doubling_money_scammers = false
wild_pvp_enabled = false
jad_practice_enabled = false
enable_global_chat = false
ge_announcement_limit = 500
enable_castle_wars = false
personalized_shops = false
bots_influence_ge_price = false
verbose_cutscene = false
show_rules = false
revenant_population = 0
i_want_to_cheat = false
better_agility_pyramid_gp = false
better_dfs = false
new_player_announcement = false
inauthentic_candlelight_random = false
########################################
holiday_event_randoms = true
force_halloween_randoms = false
force_christmas_randoms = true
########################################
runecrafting_formula_revision = 530
enhanced_deep_wilderness = false
wilderness_exclusive_loot = false
xp_rates = false
ironman = false
shooting_star_ring = false
ring_of_wealth_teleport = false
second_bank = false
player_commands = false
boosted_trawler_rewards = false

[paths]
data_path = "data"
cache_path = "@data/cache"
store_path = "@data/serverstore"
save_path = "@data/players"
configs_path = "@data/configs"
logs_path = "@data/logs"
bot_data = "@data/botdata"
eco_data = "@data/eco"
grand_exchange_data_path = "@data/eco"
object_parser_path = "@data/ObjectParser.xml"
rare_drop_table_path = "@data/configs/shared_tables/RDT.xml"
cele_drop_table_path = "@data/configs/shared_tables/CELEDT.xml"
uncommon_seed_drop_table_path = "@data/configs/shared_tables/USDT.xml"
herb_drop_table_path = "@data/configs/shared_tables/HDT.xml"
gem_drop_table_path = "@data/configs/shared_tables/GDT.xml"
rare_seed_drop_table_path = "@data/configs/shared_tables/RSDT.xml"
allotment_seed_drop_table_path = "@data/configs/shared_tables/ASDT.xml"

# End</code>

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

===== Server Start =====

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

<code>
#!/bin/bash

cd ~/'Projects/2009Scape-Server/src/Server'

export _JAVA_OPTIONS='--sun-misc-unsafe-memory-access=allow --enable-native-access=ALL-UNNAMED -Djava.net.preferIPv6Addresses=false'

'/usr/lib64/jvm/java-25-openjdk-25/bin/java' -jar ~/'Projects/2009Scape-Server/src/Server/target/server-'*'-jar-with-dependencies.jar' '../../conf/localhost.conf'

# End</code>

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

===== Server Update =====

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

<code>
#!/bin/bash

git -C ~/'Projects/2009Scape-Server/src' reset --hard 'origin/master'
git -C ~/'Projects/2009Scape-Server/src' pull origin 'master' --rebase

cd ~/'Projects/2009Scape-Server/src/Server'

export JAVA_HOME='/usr/lib64/jvm/java-17-openjdk-17'

~/'Projects/2009Scape-Server/src/Server/mvnw' 'clean' 'package' -DskipTests

unset 'JAVA_HOME'

zenity --title '2009Scape Updater' --text 'localhost server update complete' --icon ~/'Projects/RT4-Client/src/client/src/main/resources/saradomin.png' --timeout '2' --info

# End</code>

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

===== Save Data Back-up =====

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

<code>
#!/bin/bash

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

zenity --title '2009Scape Save Backup' --text 'Save Data Backed-up to Downloads' --icon ~/'Projects/RT4-Client/src/client/src/main/resources/saradomin.png' --timeout '1' --info

# End</code>

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

====== Extras ======

  * https://2009scape.org/site/game_guide/the_commands.html
  * https://2009scape.org/services/m=data/drop-table/

===== Quests =====

==== Tree Gnome Village ====

  * 2025/12/09: Chest after ballista wall jump didn't give 1st orb
  * Temporary ''noauth_default_admin = true''

  ::item 587

====== Quick Commands ======

===== Save Restore =====

  * ''src/Server/data/players/espionage724.json''

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