panel — open-source game server manager (public release)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-14 19:19:43 -07:00
commit 5232609719
2160 changed files with 300415 additions and 0 deletions
@@ -0,0 +1,120 @@
+# Project Zomboid — panel-native dedicated server module.
+#
+# Native Linux binary from SteamCMD app 380870. Java-heavy; the shipped
+# start-server.sh wraps java with correct -cp and Dpzexe.* system props.
+# Has Source-compatible RCON on port 27015 when enabled in server.ini.
+#
+# Reference: https://github.com/CubeCoders/AMPTemplates (ProjectZomboid.kvp)
+
+id: project-zomboid
+name: "Project Zomboid"
+version: 0.1.0
+authors:
+  - panel contributors
+
+supported_modes:
+  - docker
+
+runtime:
+  docker:
+    image: panel-project-zomboid: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: "Server configs + world saves under ~/Zomboid"
+      - name: "Game Files"
+        path: /game
+        hint: "PZ install, binaries"
+    env:
+      SERVER_NAME: "panel"                   # used as name of server folder under ~/Zomboid/Server
+      ADMIN_PASSWORD: "changeme"
+      RCON_PASSWORD: "panel_rcon"
+      MEMORY: "4096m"                        # JVM heap
+      # Pre-declared so the agent's resolve.go filter lets panel-allocated
+      # ports flow through to the container env. The entrypoint passes
+      # -port/-udpport launch args AND enforces the matching ini keys;
+      # without these the server binds the hardcoded 16261/16262/27015 and
+      # ignores the panel allocation (breaks multi-instance + opnfwd).
+      GAME_PORT: "16261"
+      GAME_PORT_B: "16262"
+      RCON_PORT: "27015"
+    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" }
+
+ports:
+  - { name: game,  proto: udp, default: 16261, required: true, env: GAME_PORT }
+  - { name: gameB, proto: udp, default: 16262, required: true, env: GAME_PORT_B }
+  - { name: rcon,  proto: tcp, default: 27015, internal: true, env: RCON_PORT }
+
+resources:
+  min_ram_mb: 4096
+  recommended_ram_mb: 8192
+
+# Per-instance generated RCON secret. The agent generates a random
+# 24-byte token at create time (pkg/module GenerateSecrets), which
+# overrides the env default for RCON_PASSWORD below — so every instance
+# gets a unique password. The weak env default only applies to
+# containers launched outside the panel.
+secrets:
+  - name: RCON_PASSWORD
+    description: "Project Zomboid RCON password — generated per instance"
+    generated: true
+
+rcon:
+  adapter: source_rcon
+  host_port: rcon
+  auth: source_rcon_login
+  password_secret: RCON_PASSWORD
+  # Legacy fallback only (pre-generated-secret instances). New instances
+  # always get the generated RCON_PASSWORD secret above.
+  password_literal: "panel_rcon"
+  commands:
+    list: "players"
+    save: "save"
+    kick: "kickuser {player}"
+    ban:  "banuser {player}"
+    broadcast: "servermsg \"{msg}\""
+
+state_sources:
+  - type: rcon
+    command: "players"
+    every: 60s
+    parse:
+      kind: regex
+      pattern: 'Players connected \((?P<count>\d+)\)'
+      fields:
+        players_online: count
+
+events:
+  join:
+    pattern: "(?P<name>\\S+) connected with ip"
+    kind: join
+  leave:
+    pattern: "(?P<name>\\S+) disconnected"
+    kind: leave
+
+update_providers:
+  - id: stable
+    kind: steamcmd
+    app_id: "380870"
+    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.
+# Confirmed on smoke boot 2026-07-14: 'LOG  : Network ... > *** SERVER STARTED ****'
+ready_pattern: '/\*+ SERVER STARTED \*+/'
+appearance:
+  emoji: "🧟"
+  grad: "linear-gradient(135deg,#6a4c1e,#b89040)"
+  steam: "108600"