panel — open-source game server manager (public release)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,55 @@
|
||||
# panel-native RuneScape: Dragonwilds runtime image.
|
||||
#
|
||||
# Dragonwilds ships a native-Linux UE5 build — no Wine. Minimal debian:12-slim
|
||||
# + 32-bit runtime libs (steamclient.so dependency) + UE5 dlopen shim libs.
|
||||
# Same scaffolding as the `rust` module; UE5 servers touch the same set of X/
|
||||
# GL libs at boot even in headless mode.
|
||||
#
|
||||
# Expected runtime layout inside the container:
|
||||
# /game — SteamCMD install (panel volume)
|
||||
# /game/RSDragonwildsServer.sh — Jagex's launcher wrapper
|
||||
# /game/RSDragonwilds/Binaries/Linux/RSDragonwildsServer-Linux-Shipping — real exe
|
||||
# /game/RSDragonwilds/Saved/Config/LinuxServer/DedicatedServer.ini — operator config
|
||||
# /game-saves — save + logs volume
|
||||
|
||||
FROM debian:12-slim
|
||||
|
||||
ENV DEBIAN_FRONTEND=noninteractive \
|
||||
TZ=Etc/UTC \
|
||||
LANG=en_US.UTF-8 \
|
||||
LC_ALL=en_US.UTF-8
|
||||
|
||||
RUN dpkg --add-architecture i386 \
|
||||
&& apt-get update \
|
||||
&& apt-get install -y --no-install-recommends \
|
||||
ca-certificates \
|
||||
locales \
|
||||
tini \
|
||||
curl \
|
||||
lib32gcc-s1 \
|
||||
lib32stdc++6 \
|
||||
libc6:i386 \
|
||||
libgl1 \
|
||||
libx11-6 \
|
||||
libxcursor1 \
|
||||
libxext6 \
|
||||
libxi6 \
|
||||
libxrandr2 \
|
||||
libxrender1 \
|
||||
procps \
|
||||
&& sed -i -e 's/# en_US.UTF-8 UTF-8/en_US.UTF-8 UTF-8/' /etc/locale.gen \
|
||||
&& locale-gen \
|
||||
&& apt-get clean \
|
||||
&& rm -rf /var/lib/apt/lists/*
|
||||
|
||||
RUN groupadd -g 1000 panel \
|
||||
&& useradd -u 1000 -g 1000 -m -s /bin/bash panel \
|
||||
&& mkdir -p /game /game-saves \
|
||||
&& chown -R panel:panel /game /game-saves
|
||||
|
||||
COPY entrypoint.sh /entrypoint.sh
|
||||
RUN chmod +x /entrypoint.sh
|
||||
|
||||
EXPOSE 7777/udp
|
||||
|
||||
ENTRYPOINT ["/usr/bin/tini", "--", "/entrypoint.sh"]
|
||||
@@ -0,0 +1,48 @@
|
||||
# RuneScape: Dragonwilds — panel-native module
|
||||
|
||||
Panel-native Dragonwilds dedicated server, native-Linux (no Wine), debian:12-slim base.
|
||||
|
||||
- **Image:** `panel-dragonwilds:latest` — built from `./Dockerfile`.
|
||||
- **Game files:** downloaded by the panel's SteamCMD updater sidecar (app 4019830) into the `panel-<id>-game` named volume. Dragonwilds is a multi-depot app (Windows 4019831 + Linux 3501791) — module declares `platform: linux` so SteamCMD's auto-detect doesn't mis-fire on Docker Desktop WSL2. Linux depot is ~1.6 GB compressed, ~5.8 GB on disk.
|
||||
- **Saves:** `panel-<id>-saves` at `/game-saves`. Entrypoint migrates `RSDragonwilds/Saved/` into the save volume on first discovery and symlinks back, so SteamCMD validate can't wipe worlds or config.
|
||||
- **RCON:** **None.** Jagex has not documented or implemented a remote admin protocol. The Players tab will stay empty until we wire log-tail join/leave regex from observing real player traffic.
|
||||
|
||||
## Ports
|
||||
|
||||
| Port | Proto | Purpose |
|
||||
|------|-------|---------|
|
||||
| 7777 | UDP | Game traffic |
|
||||
|
||||
Additional instances on the same host should use 7778, 7779, etc.
|
||||
|
||||
## Required configuration
|
||||
|
||||
Jagex requires 4 mandatory values in `RSDragonwilds/Saved/Config/LinuxServer/DedicatedServer.ini`:
|
||||
|
||||
- `ServerName`
|
||||
- `DefaultWorldName`
|
||||
- `OwnerID` — the Steam ID (or Jagex account ID?) of the server owner
|
||||
- `AdminPassword`
|
||||
|
||||
The entrypoint seeds `DedicatedServer.ini` on first boot from env vars (`SERVER_NAME`, `DEFAULT_WORLD_NAME`, `OWNER_ID`, `ADMIN_PASSWORD`). Operators should set `OWNER_ID` and `ADMIN_PASSWORD` before the first launch or the server will reject client logins. Hand-edit via the Files tab after the first boot is also fine — the entrypoint only seeds when the file is missing.
|
||||
|
||||
## Environment vars
|
||||
|
||||
| Var | Default | Notes |
|
||||
|-----|---------|-------|
|
||||
| `SERVER_NAME` | `panel Dragonwilds` | Shown in the server browser |
|
||||
| `SERVER_PORT` | `7777` | |
|
||||
| `DEFAULT_WORLD_NAME` | `Gielinor` | World loaded on start |
|
||||
| `OWNER_ID` | *(empty)* | Operator must set |
|
||||
| `ADMIN_PASSWORD` | *(empty)* | Operator must set |
|
||||
|
||||
## Known gotchas
|
||||
|
||||
- Multi-depot SteamCMD install — without `platform: linux` in the manifest, SteamCMD exits 8 "Missing configuration" on Docker Desktop WSL2 (same class as Palworld).
|
||||
- Linux launcher at `/game/RSDragonwildsServer.sh` is a shell wrapper around the real UE5 shipping binary under `RSDragonwilds/Binaries/Linux/`. The entrypoint probes for both and prefers the wrapper when available.
|
||||
- No RCON → no admin/broadcast/kick from the panel. Use in-game commands via the server operator.
|
||||
|
||||
## Reference
|
||||
|
||||
- [Jagex dedicated server guide](https://dragonwilds.runescape.com/news/how-to-dedicated-servers)
|
||||
- [RuneScape: Dragonwilds Wiki — Dedicated Servers / Linux](https://dragonwilds.runescape.wiki/w/Dedicated_Servers/Linux)
|
||||
@@ -0,0 +1,109 @@
|
||||
#!/bin/bash
|
||||
# panel-native RuneScape: Dragonwilds entrypoint.
|
||||
#
|
||||
# Contract:
|
||||
# /game — SteamCMD-installed Linux build of Dragonwilds Dedicated
|
||||
# Server (app 4019830). Populated by the panel's SteamCMD
|
||||
# updater sidecar.
|
||||
# /game-saves — RSDragonwilds/Saved/ config + save tree + logs.
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
log() { printf '[panel-dragonwilds] %s\n' "$*"; }
|
||||
|
||||
# ----- stage 1: root-only bootstrap -----
|
||||
if [[ "$(id -u)" = "0" ]]; then
|
||||
chown -R panel:panel /game /game-saves /home/panel 2>/dev/null || true
|
||||
log "dropping privileges to panel (UID 1000)"
|
||||
exec setpriv --reuid=panel --regid=panel --clear-groups \
|
||||
--inh-caps=-all --bounding-set=-all \
|
||||
env \
|
||||
HOME=/home/panel \
|
||||
SERVER_NAME="${SERVER_NAME:-panel Dragonwilds}" \
|
||||
SERVER_PORT="${SERVER_PORT:-7777}" \
|
||||
OWNER_ID="${OWNER_ID:-}" \
|
||||
ADMIN_PASSWORD="${ADMIN_PASSWORD:-}" \
|
||||
DEFAULT_WORLD_NAME="${DEFAULT_WORLD_NAME:-Gielinor}" \
|
||||
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin \
|
||||
/entrypoint.sh "$@"
|
||||
fi
|
||||
|
||||
GAME_DIR=/game
|
||||
SAVE_DIR=/game-saves
|
||||
|
||||
# --- locate the launcher wrapper ---
|
||||
# Jagex ships RSDragonwildsServer.sh at the install root; it execs the
|
||||
# UE5 shipping binary under RSDragonwilds/Binaries/Linux/.
|
||||
LAUNCHER="${GAME_DIR}/RSDragonwildsServer.sh"
|
||||
FALLBACK="${GAME_DIR}/RSDragonwilds/Binaries/Linux/RSDragonwildsServer-Linux-Shipping"
|
||||
if [[ ! -x "${LAUNCHER}" && ! -x "${FALLBACK}" ]]; then
|
||||
log "ERROR: ${LAUNCHER} not found or not executable."
|
||||
log " Run 'Update' on this server in the panel — that launches a"
|
||||
log " SteamCMD sidecar which installs Dragonwilds (app 4019830)"
|
||||
log " for Linux into this volume via +@sSteamCmdForcePlatformType linux."
|
||||
exit 78 # EX_CONFIG
|
||||
fi
|
||||
|
||||
# --- persist RSDragonwilds/Saved into /game-saves ---
|
||||
# UE5 writes config + save data under <game>/RSDragonwilds/Saved/. Move
|
||||
# it into the save volume on first discovery and symlink back so SteamCMD
|
||||
# validate can't wipe world data. Idempotent on re-boot.
|
||||
mkdir -p "${SAVE_DIR}/RSDragonwilds" "${GAME_DIR}/RSDragonwilds"
|
||||
if [[ -d "${GAME_DIR}/RSDragonwilds/Saved" && ! -L "${GAME_DIR}/RSDragonwilds/Saved" ]]; then
|
||||
if [[ ! -d "${SAVE_DIR}/RSDragonwilds/Saved" ]]; then
|
||||
mv "${GAME_DIR}/RSDragonwilds/Saved" "${SAVE_DIR}/RSDragonwilds/Saved"
|
||||
else
|
||||
rm -rf "${GAME_DIR}/RSDragonwilds/Saved"
|
||||
fi
|
||||
fi
|
||||
mkdir -p "${SAVE_DIR}/RSDragonwilds/Saved/Config/LinuxServer"
|
||||
ln -sfn "${SAVE_DIR}/RSDragonwilds/Saved" "${GAME_DIR}/RSDragonwilds/Saved"
|
||||
|
||||
# --- seed DedicatedServer.ini from env on first boot ---
|
||||
# Jagex requires OwnerId + Server Name + Default World Name + Admin Password
|
||||
# to be set. Observed behavior on 0.11: Dragonwilds overwrites an absent
|
||||
# DedicatedServer.ini on first boot with its OWN random-generated values
|
||||
# under the `[/Script/Dominion.DedicatedServerSettings]` section ("Dominion"
|
||||
# is the internal UE5 project name). So the best we can do for first-boot
|
||||
# seeding is to pre-write the file — if it exists the server reads it and
|
||||
# leaves it. We only touch the file when it doesn't already exist.
|
||||
INI="${SAVE_DIR}/RSDragonwilds/Saved/Config/LinuxServer/DedicatedServer.ini"
|
||||
if [[ ! -s "${INI}" ]]; then
|
||||
log "seeding DedicatedServer.ini (first boot)"
|
||||
cat > "${INI}" <<EOF
|
||||
;METADATA=(Diff=true, UseCommands=true)
|
||||
[SectionsToSave]
|
||||
bCanSaveAllSections=true
|
||||
|
||||
[/Script/Dominion.DedicatedServerSettings]
|
||||
ServerName=${SERVER_NAME}
|
||||
DefaultWorldName=${DEFAULT_WORLD_NAME}
|
||||
OwnerId=${OWNER_ID}
|
||||
AdminPassword=${ADMIN_PASSWORD}
|
||||
WorldPassword=
|
||||
EOF
|
||||
fi
|
||||
|
||||
# Mirror logs to the bind-mounted logs dir for external access.
|
||||
mkdir -p "${SAVE_DIR}/logs"
|
||||
|
||||
cd "${GAME_DIR}"
|
||||
log "starting RuneScape: Dragonwilds dedicated server"
|
||||
log " name: ${SERVER_NAME}"
|
||||
log " default world: ${DEFAULT_WORLD_NAME}"
|
||||
log " owner id: ${OWNER_ID:-(unset — server will refuse logins)}"
|
||||
log " admin pw: ${ADMIN_PASSWORD:+<set>}"
|
||||
log " port: ${SERVER_PORT}/udp"
|
||||
|
||||
trap 'log "SIGTERM received; stopping server"; kill -TERM "${SRV_PID:-0}" 2>/dev/null || true; wait "${SRV_PID:-0}" 2>/dev/null || true; exit 0' TERM INT
|
||||
|
||||
# Use the Jagex-shipped launcher when present; otherwise exec the shipping
|
||||
# binary directly. `-log` routes UE5 output to stdout. Drop `-NewConsole`
|
||||
# (Windows-only; harmless but noisy on Linux).
|
||||
if [[ -x "${LAUNCHER}" ]]; then
|
||||
exec stdbuf -oL -eL "${LAUNCHER}" -log "-Port=${SERVER_PORT}" &
|
||||
else
|
||||
exec stdbuf -oL -eL "${FALLBACK}" -log "-Port=${SERVER_PORT}" &
|
||||
fi
|
||||
SRV_PID=$!
|
||||
wait "${SRV_PID}"
|
||||
@@ -0,0 +1,99 @@
|
||||
# RuneScape: Dragonwilds dedicated server module.
|
||||
#
|
||||
# Native-Linux UE5 binary via SteamCMD app 4019830 (free-to-download tool;
|
||||
# Jagex made the dedicated server public on Steam in 2026 with Update 0.11).
|
||||
# Multi-depot app (Windows 4019831 + Linux 3501791) — so `platform: linux`
|
||||
# is required, same class of issue as Palworld on Docker Desktop WSL2.
|
||||
#
|
||||
# No native RCON protocol — Jagex hasn't documented one. The admin console
|
||||
# is in-process only. Panel surfaces the UE log in the Console tab; Players
|
||||
# tab stays empty until Jagex ships an admin protocol (or we wire a log-tail
|
||||
# based join/leave regex when we observe real player traffic).
|
||||
#
|
||||
# References:
|
||||
# https://dragonwilds.runescape.com/news/how-to-dedicated-servers
|
||||
# https://dragonwilds.runescape.wiki/w/Dedicated_Servers/Linux
|
||||
|
||||
id: dragonwilds
|
||||
name: "RuneScape: Dragonwilds"
|
||||
version: 0.1.0
|
||||
authors:
|
||||
- panel contributors
|
||||
|
||||
supported_modes:
|
||||
- docker
|
||||
|
||||
runtime:
|
||||
docker:
|
||||
image: panel-dragonwilds:latest
|
||||
# Host networking -- container shares the host net namespace, so
|
||||
# any port the game/mod binds is directly on the LAN. AMP-like
|
||||
# model. Multi-instance safety comes from env-driven per-instance
|
||||
# ports (panel allocator + env: mapping on each ports entry).
|
||||
network_mode: host
|
||||
browseable_root: /game-saves
|
||||
browseable_roots:
|
||||
- name: "Saves & Configs"
|
||||
path: /game-saves
|
||||
hint: "RSDragonwilds/Saved/Config/LinuxServer/DedicatedServer.ini + world saves"
|
||||
- name: "Game Files"
|
||||
path: /game
|
||||
hint: "RSDragonwildsServer.sh, RSDragonwilds/Binaries/Linux/"
|
||||
env:
|
||||
SERVER_NAME: "panel Dragonwilds"
|
||||
SERVER_PORT: "7777"
|
||||
# Operators MUST supply these before the server will accept clients.
|
||||
# First boot generates a stub DedicatedServer.ini if these are empty;
|
||||
# the server still launches but refuses logins until populated.
|
||||
OWNER_ID: ""
|
||||
ADMIN_PASSWORD: ""
|
||||
DEFAULT_WORLD_NAME: "Gielinor"
|
||||
volumes:
|
||||
- { type: volume, name: "panel-$INSTANCE_ID-saves", container: "/game-saves" }
|
||||
- { type: volume, name: "panel-$INSTANCE_ID-game", container: "/game" }
|
||||
- { target: "$DATA_PATH/logs", container: "/game-saves/logs" }
|
||||
|
||||
# Dragonwilds only documents one port: 7777/udp (game). No Steam query
|
||||
# or RCON ports in the public docs. Additional server instances on the
|
||||
# same host are expected to increment the port (7778, 7779, ...).
|
||||
ports:
|
||||
- { name: game, proto: udp, default: 7777, required: true, env: SERVER_PORT }
|
||||
|
||||
resources:
|
||||
min_ram_mb: 4096
|
||||
recommended_ram_mb: 8192
|
||||
# Log-derived player events. Regexes converted from CubeCoders'
|
||||
# AMPTemplates (runescape-dragonwilds.kvp) — .NET (?<n>) syntax -> Go (?P<n>).
|
||||
# Sourced-from-template; not yet exercised against a live client.
|
||||
events:
|
||||
join:
|
||||
pattern: 'LogDomMatcherSession:\s+Player\s+ADDED\s+to\s+session\s+\[[^\]]+\]-\[(?P<name>[^\]]+)\]$'
|
||||
kind: join
|
||||
leave:
|
||||
pattern: 'LogDomMatcherSession:\s+Player\s+Removed\s+from\s+session\s+\[[^\]]+\]-\[(?P<name>[^\]]+)\]$'
|
||||
kind: leave
|
||||
chat:
|
||||
pattern: '^\[[\d\.]+-[\d\.:]+\]\[[\d ]+\]LogChat: (?P<name>.+?): (?P<msg>.*)$'
|
||||
kind: chat
|
||||
|
||||
|
||||
update_providers:
|
||||
- id: stable
|
||||
kind: steamcmd
|
||||
app_id: "4019830"
|
||||
# Multi-depot — explicit platform required or SteamCMD auto-detect
|
||||
# mis-fires on Docker Desktop WSL2 with "Missing configuration".
|
||||
platform: linux
|
||||
install_path: /game
|
||||
|
||||
# --- Manifest-driven UI metadata (WI-07) --------------------------
|
||||
# Consumed by the CONTROLLER/dashboard only (the controller loads its
|
||||
# own ./modules copy at startup); the agent ignores these at runtime.
|
||||
# ready_pattern is a JavaScript regex (slash-delimited when it needs
|
||||
# flags) moved verbatim from the dashboard's READY_PATTERNS map.
|
||||
ready_pattern: '/LogInit: Display: Engine is initialized|LogGlobalStatus:\s*UEngine::LoadMap\s+Load\s+map\s+complete|LogLoad: Game Engine Initialized|LogNet: GameNetDriver/i'
|
||||
appearance:
|
||||
emoji: "🐉"
|
||||
grad: "linear-gradient(135deg,#4c1d95,#f59e0b)"
|
||||
art: "/game-art/dragonwilds.jpg"
|
||||
steam: "1374490"
|
||||
Reference in New Issue
Block a user