| |
servers:windows:games:2009scape_localhost [2025/06/09 20:39] – [Save Data Back-up] Sean Rhone | servers:windows:games:2009scape_localhost [2025/09/11 06:43] (current) – external edit 127.0.0.1 |
---|
| |
* 2009Scape Server ((https://gitlab.com/2009scape/2009scape)) | * 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 ===== | ===== Media ===== |
===== Prerequisites ===== | ===== Prerequisites ===== |
| |
* [[windows:10|Windows 10 (21H2)]] | * [[windows;11_ltsc|Windows 11 (24H2)]] |
* [[programs;windows;git|Git]] (LFS component required) | * [[programs;windows;git|Git]] (LFS component required) |
| * [[games:windows:rt4_client_runescape_530|RT4 Client]] |
===== Notes ===== | |
| |
* For a game client, see [[games:windows:rt4_client_runescape_530|RT4 Client]] | |
| |
====== Dependencies ====== | ====== Dependencies ====== |
| |
===== Java ===== | ===== Java ===== |
| |
| ==== 21 ==== |
| |
* https://learn.microsoft.com/en-us/java/openjdk/download#openjdk-21 | * https://learn.microsoft.com/en-us/java/openjdk/download#openjdk-21 |
* Last tested: ''microsoft-jdk-21.0.7-windows-x64.msi'' | * Last tested: ''microsoft-jdk-21.0.8-windows-x64.msi'' |
| |
* Entire feature install of ''Microsoft Build of OpenJDK'' | * Entire feature install of ''Microsoft Build of OpenJDK'' |
====== Settings ====== | ====== Settings ====== |
| |
* Last commit: [[https://gitlab.com/2009scape/2009scape/-/commit/317b4e9b5c330c6492663631d3edca9794dfc2f9|August 10, 2024]] ''317b4e9b'' | * Last commit: [[https://gitlab.com/2009scape/2009scape/-/commit/bef103e25934ab2ba465e157fe776d947aa4a49b|July 15, 2025]] ''bef103e2'' |
* [[https://gitlab.com/2009scape/2009scape/-/commits/master/Server/worldprops/default.conf?ref_type=heads|New commits check]] | * [[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/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]]) |
| |
MKDIR "%UserProfile%\Projects\2009Scape-Server\conf" | MKDIR "%UserProfile%\Projects\2009Scape-Server\conf" & "notepad.exe" "%UserProfile%\Projects\2009Scape-Server\conf\localhost.conf" |
| |
"notepad.exe" "%UserProfile%\Projects\2009Scape-Server\conf\localhost.conf" | |
| |
<code> | <code> |
| |
# Server | # Server |
log_level = "detailed" | log_level = "verbose" |
write_logs = false | write_logs = false |
msip = "127.0.0.1" | msip = "localhost" |
secret_key = "2009scape_development" | secret_key = "2009scape_development" |
preload_map = false | preload_map = false |
| |
# MySQL | # MySQL |
database_address = "127.0.0.1" | database_address = "localhost" |
database_port = "3306" | database_port = "3306" |
database_name = "2009scape" | database_name = "2009scape" |
skillcape_perks = false | skillcape_perks = false |
jad_practice_enabled = false | jad_practice_enabled = false |
| inauthentic_candlelight_random = false |
| |
# Holiday (only enable one "force" or none) | # Holiday (only enable one "force" or none) |
| |
====== Scripts ====== | ====== Scripts ====== |
| |
**** | |
| |
MKDIR "%UserProfile%\Projects\2009Scape-Server\scripts" | |
| |
===== Server Start ===== | ===== Server Start ===== |
| |
"notepad.exe" "%UserProfile%\Projects\2009Scape-Server\scripts\localhost-server-start.bat" | MKDIR "%UserProfile%\Projects\2009Scape-Server\scripts" & "notepad.exe" "%UserProfile%\Projects\2009Scape-Server\scripts\localhost-server-start.bat" |
| |
<code> | <code> |
@echo off | @echo off |
| |
TITLE 2009Scape - Server | TITLE 2009Scape Server |
| |
CD "%UserProfile%\Projects\2009Scape-Server\src\Server" | CD "%UserProfile%\Projects\2009Scape-Server\src\Server" |
| |
SET "_JAVA_OPTIONS=-Djava.net.preferIPv6Addresses=true" | SET "_JAVA_OPTIONS=-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" | "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" |
===== Server Update ===== | ===== Server Update ===== |
| |
"notepad.exe" "%UserProfile%\Projects\2009Scape-Server\scripts\localhost-server-update.bat" | MKDIR "%UserProfile%\Projects\2009Scape-Server\scripts" & "notepad.exe" "%UserProfile%\Projects\2009Scape-Server\scripts\localhost-server-update.bat" |
| |
<code> | <code> |
===== Save Data Back-up ===== | ===== Save Data Back-up ===== |
| |
"notepad.exe" "%UserProfile%\Projects\2009Scape-Server\scripts\localhost-save-backup.bat" | MKDIR "%UserProfile%\Projects\2009Scape-Server\scripts" & "notepad.exe" "%UserProfile%\Projects\2009Scape-Server\scripts\localhost-save-backup.bat" |
| |
<code> | <code> |
===== Start Menu ===== | ===== Start Menu ===== |
| |
MKDIR "%AppData%\Microsoft\Windows\Start Menu\Programs\2009Scape" | **** |
| |
"explorer.exe" "%AppData%\Microsoft\Windows\Start Menu\Programs\2009Scape" | MKDIR "%AppData%\Microsoft\Windows\Start Menu\Programs\2009Scape" & "explorer.exe" "%AppData%\Microsoft\Windows\Start Menu\Programs\2009Scape" |
| |
==== Server Start ==== | ==== Server Start ==== |
====== Quick Commands ====== | ====== Quick Commands ====== |
| |
===== Execute ===== | ===== Save Restore ===== |
| |
**** | |
| |
CD "%UserProfile%\Projects\2009Scape-Server\src\Server" && "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" | |
| |
===== Update ===== | |
| |
* https://gitlab.com/2009scape/2009scape/-/commits/master?ref_type=HEADS | |
| |
"%ProgramFiles%\Git\bin\git.exe" -C "%UserProfile%\Projects\2009Scape-Server\src" reset --hard && "%ProgramFiles%\Git\bin\git.exe" -C "%UserProfile%\Projects\2009Scape-Server\src" pull origin "master" --rebase && CD "%UserProfile%\Projects\2009Scape-Server\src\Server" && CALL "%UserProfile%\Projects\2009Scape-Server\src\Server\mvnw.cmd" "clean" "package" -DskipTests | |
| |
===== Save Data Back-up ===== | |
| |
**** | |
| |
"tar.exe" -czf "%UserProfile%\Downloads\%RANDOM%-2009Scape-Server-localhost-Saves.tar.gz" -C "%UserProfile%\Projects\2009Scape-Server\src\Server\data" "players" | |
| |
===== Bookmarks ===== | |
| |
* https://gitlab.com/2009scape/2009scape/-/commits/master?ref_type=HEADS | |
| |
===== File Manager ===== | |
| |
==== Root ==== | |
| |
**** | |
| |
"explorer.exe" "%UserProfile%\Projects\2009Scape-Server\src" | |
| |
==== Saves ==== | |
| |
MKDIR "%UserProfile%\Projects\2009Scape-Server\src\Server\data\players" | |
| |
"explorer.exe" "%UserProfile%\Projects\2009Scape-Server\src\Server\data\players" | |
| |
====== Resources/TODOs ====== | * ''Server\data\players\espionage724.json'' |
| |
* https://github.com/2009scape/2009Scape-mobile/issues/13 | MKDIR "%UserProfile%\Projects\2009Scape-Server\src\Server\data\players" & "explorer.exe" "%UserProfile%\Projects\2009Scape-Server\src\Server\data\players" |
* https://gitlab.com/2009scape/singleplayer/windows/-/raw/master/game/worldprops/default.conf | |
* https://gitlab.com/2009scape/2009scape/-/blob/master/Server/src/main/core/game/system/config/ServerConfigParser.kt#L66 | |
* https://gitlab.com/2009scape/2009scape/-/blob/master/Server/src/main/core/game/world/GameSettings.kt#L120 | |
* If stuck on tile/somewhere in-game: [[#settings|conf]] ''noauth_default_admin = true'' | |
* Pest Control and Mining Star bots auto-still appear with bots disabled in conf (bots disabled stops auto-spawn bots at Lumbridge/seemingly general areas) | |
| |