panel v0.9.1 — open-source game server manager

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-14 23:37:25 -07:00
commit 582b5a6b08
2161 changed files with 300950 additions and 0 deletions
@@ -0,0 +1,84 @@
+# Core Keeper — panel-native dedicated server module.
+#
+# Native Linux (Unity headless) from SteamCMD app 1963720. Unity server
+# still touches X so we need Xvfb (same pattern as Empyrion). No RCON —
+# admin is via in-game console when you hold the founders key.
+#
+# Reference: https://github.com/CubeCoders/AMPTemplates (CoreKeeperLinux.kvp)
+
+id: core-keeper
+name: "Core Keeper"
+version: 0.1.0
+authors:
+  - panel contributors
+
+supported_modes:
+  - docker
+
+runtime:
+  docker:
+    image: panel-core-keeper: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: "Worlds + server.json"
+      - name: "Game Files"
+        path: /game
+        hint: "Server binaries"
+    env:
+      GAME_ID: ""                      # leave empty to generate a new world; set to rejoin
+      WORLD_NAME: "panel"
+      WORLD_MODE: "0"                  # 0 = normal, 1 = hardmode, 2 = creative
+      MAX_PLAYERS: "10"
+      # Pre-declared so the agent's env filter lets the panel-allocated
+      # port flow through to the container (same trap as soulmask).
+      # The entrypoint passes it as -port; default matches the port default.
+      GAME_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: 27015, required: true, env: GAME_PORT }
+
+resources:
+  min_ram_mb: 2048
+  recommended_ram_mb: 4096
+# Log-derived player events. Regexes converted from CubeCoders'
+# AMPTemplates (core-keeper.kvp) — .NET (?<n>) syntax -> Go (?P<n>).
+# Sourced-from-template; not yet exercised against a live client.
+events:
+  join:
+    pattern: '\[userid:(?P<id>[^\]]+)\] player (?P<name>.+?) connected'
+    kind: join
+  leave:
+    pattern: 'Disconnected from userid:(?P<id>\S+?) with reason'
+    kind: leave
+
+
+update_providers:
+  - id: stable
+    kind: steamcmd
+    app_id: "1963720"
+    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.
+# Verified on a live first boot 2026-07-14: the last line before the server
+# accepts joins is "Started session with info: <ip>;<port>;<key1>;<key2>".
+ready_pattern: '/Started session with info/i'
+appearance:
+  emoji: "⛏️"
+  grad: "linear-gradient(135deg,#2e1a47,#6b3fa0)"
+  art: "/game-art/core-keeper.jpg"
+  steam: "1621690"