====== Information ======
* 2009Scape Server ((https://gitlab.com/2009scape/2009scape))
===== Media =====
* [[https://media.realmofespionage.xyz/index/category/3|Progress Pics]]
===== Prerequisites =====
* [[windows:10|Windows 10 (21H2)]]
* [[programs;windows;git|Git]] (LFS component required)
* [[games:windows:rt4_client_runescape_530|RT4 Client]]
====== Dependencies ======
* https://gitlab.com/2009scape/2009scape#prerequisites
===== Java =====
==== 25 ====
* https://aka.ms/download-jdk/microsoft-jdk-25-windows-x64.msi
* Last tested: ''microsoft-jdk-25.0.1-windows-x64.msi''
* Entire feature install of ''Microsoft Build of OpenJDK''
==== 17 ====
* https://aka.ms/download-jdk/microsoft-jdk-17-windows-x64.msi
* Last tested: ''microsoft-jdk-17.0.17-windows-x64.msi''
* All secondary features manually-marked unavailable
====== Download Source ======
* https://gitlab.com/2009scape/2009scape/-/commits/master?ref_type=HEADS
"%ProgramFiles%\Git\bin\git.exe" clone --branch "master" --depth "1" --recurse-submodules "https://gitlab.com/2009scape/2009scape.git" "%UserProfile%\Projects\2009Scape-Server\src"
====== Initial Build ======
****
CD "%UserProfile%\Projects\2009Scape-Server\src\Server" && SET "JAVA_HOME=%ProgramFiles%\Microsoft\jdk-17.0.17.10-hotspot" && "%UserProfile%\Projects\2009Scape-Server\src\Server\mvnw.cmd" "clean" "package" -DskipTests && SET "JAVA_HOME="
====== 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 "%UserProfile%\Projects\2009Scape-Server\conf" & "notepad.exe" "%UserProfile%\Projects\2009Scape-Server\conf\localhost.conf"
[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
====== Scripts ======
===== Server Start =====
MKDIR "%UserProfile%\Projects\2009Scape-Server\scripts" & "notepad.exe" "%UserProfile%\Projects\2009Scape-Server\scripts\localhost-server-start.bat"
@echo off
TITLE 2009Scape Server
CD "%UserProfile%\Projects\2009Scape-Server\src\Server"
SET "_JAVA_OPTIONS=--sun-misc-unsafe-memory-access=allow --enable-native-access=ALL-UNNAMED -Djava.net.preferIPv6Addresses=false"
"java.exe" -jar "%UserProfile%\Projects\2009Scape-Server\src\Server\target\server-1.0.0-jar-with-dependencies.jar" "%UserProfile%\Projects\2009Scape-Server\conf\localhost.conf" || exit "1"
SET "_JAVA_OPTIONS="
:: End
"%UserProfile%\Projects\2009Scape-Server\scripts\localhost-server-start.bat"
===== Server Update =====
MKDIR "%UserProfile%\Projects\2009Scape-Server\scripts" & "notepad.exe" "%UserProfile%\Projects\2009Scape-Server\scripts\localhost-server-update.bat"
@echo off
"%ProgramFiles%\Git\bin\git.exe" -C "%UserProfile%\Projects\2009Scape-Server\src" reset --hard "origin/master"
"%ProgramFiles%\Git\bin\git.exe" -C "%UserProfile%\Projects\2009Scape-Server\src" pull origin "master" --rebase
CD "%UserProfile%\Projects\2009Scape-Server\src\Server"
SET "JAVA_HOME=%ProgramFiles%\Microsoft\jdk-17.0.17.10-hotspot"
CALL "%UserProfile%\Projects\2009Scape-Server\src\Server\mvnw.cmd" "clean" "package" -DskipTests
SET "JAVA_HOME="
:: End
"%UserProfile%\Projects\2009Scape-Server\scripts\localhost-server-update.bat"
===== Save Data Back-up =====
MKDIR "%UserProfile%\Projects\2009Scape-Server\scripts" & "notepad.exe" "%UserProfile%\Projects\2009Scape-Server\scripts\localhost-save-backup.bat"
@echo off
"tar.exe" -czf "%UserProfile%\Downloads\%RANDOM%-2009Scape-Server-localhost-Saves.tar.gz" -C "%UserProfile%\Projects\2009Scape-Server\src\Server\data" "players"
:: End
"%UserProfile%\Projects\2009Scape-Server\scripts\localhost-save-backup.bat"
====== Launcher Shortcuts ======
===== Desktop =====
==== Server Start ====
"%UserProfile%\Projects\2009Scape-Server\scripts\localhost-server-start.bat"
2009Scape Server
===== Start Menu =====
****
MKDIR "%AppData%\Microsoft\Windows\Start Menu\Programs\2009Scape" & "explorer.exe" "%AppData%\Microsoft\Windows\Start Menu\Programs\2009Scape"
==== Server Start ====
"%UserProfile%\Projects\2009Scape-Server\scripts\localhost-server-start.bat"
Server Start
==== Update ====
"%UserProfile%\Projects\2009Scape-Server\scripts\localhost-server-update.bat"
Server Updater
==== Save Backup ====
"%UserProfile%\Projects\2009Scape-Server\scripts\localhost-save-backup.bat"
Save Back-up
==== Save Folder ====
MKDIR "%UserProfile%\Projects\2009Scape-Server\src\Server\data\players"
"%UserProfile%\Projects\2009Scape-Server\src\Server\data\players"
Save Folder
==== Install Notes ====
"https://wiki.realmofespionage.xyz/servers;windows;games;2009scape_localhost"
Install Notes (Server)
====== Quick Commands ======
===== Save Restore =====
* ''Server\data\players\espionage724.json''
MKDIR "%UserProfile%\Projects\2009Scape-Server\src\Server\data\players" & "explorer.exe" "%UserProfile%\Projects\2009Scape-Server\src\Server\data\players"