Panel — public source drop (v0.9.0)

Self-hostable game-server control panel: controller + agent + 26 game
modules. One-line install (prebuilt release, no Go required):

  curl -fsSL https://git.pdxtechs.com/dbledeez/panel/raw/branch/main/install.sh | sudo bash

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-14 21:17:39 -07:00
commit a00bd620a1
2160 changed files with 300574 additions and 0 deletions
+34
View File
@@ -0,0 +1,34 @@
# panel-native Satisfactory runtime image.
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 \
lib32gcc-s1 \
lib32stdc++6 \
libc6:i386 \
libatomic1 \
&& 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 15000/udp 7777/tcp
ENTRYPOINT ["/usr/bin/tini", "--", "/entrypoint.sh"]
+43
View File
@@ -0,0 +1,43 @@
#!/bin/bash
# panel-native Satisfactory entrypoint.
set -euo pipefail
log() { printf '[panel-satisfactory] %s\n' "$*"; }
if [[ "$(id -u)" = "0" ]]; then
chown -R panel:panel /game /game-saves /home/panel 2>/dev/null || true
exec setpriv --reuid=panel --regid=panel --clear-groups \
--inh-caps=-all --bounding-set=-all \
env HOME=/game-saves PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin \
GAME_PORT="${GAME_PORT:-7777}" RELIABLE_PORT="${RELIABLE_PORT:-8888}" \
/entrypoint.sh "$@"
fi
GAME_DIR=/game
SAVE_DIR=/game-saves
START_SH="${GAME_DIR}/FactoryServer.sh"
if [[ ! -x "${START_SH}" ]]; then
log "ERROR: ${START_SH} not found. Run 'Update' in the panel to install Satisfactory via SteamCMD."
exit 78
fi
# Satisfactory writes SaveGames / Engine configs to
# $HOME/.config/Epic/FactoryGame. HOME is /game-saves → saves land in the
# save volume without further fiddling.
mkdir -p "${SAVE_DIR}/.config/Epic/FactoryGame/Saved/SaveGames"
GAME_PORT="${GAME_PORT:-7777}"
RELIABLE_PORT="${RELIABLE_PORT:-8888}"
cd "${GAME_DIR}"
log "starting Satisfactory dedicated server (game=${GAME_PORT}/udp+tcp reliable=${RELIABLE_PORT}/tcp)"
# -Port drives both the UDP game socket and the HTTPS API listener (they
# share the number). -ReliablePort is the TCP reliability channel (1.0+).
# -stdout -FullStdOutLogOutput route UE logs to stdout for `docker logs`.
exec stdbuf -oL -eL "${START_SH}" \
-Port="${GAME_PORT}" \
-ReliablePort="${RELIABLE_PORT}" \
-multihome=0.0.0.0 \
-stdout -FullStdOutLogOutput \
-unattended
+92
View File
@@ -0,0 +1,92 @@
# Satisfactory — panel-native dedicated server module.
#
# Native Linux binary from SteamCMD app 1690800. Admin is via Coffee Stain's
# HTTPS API on the game port (7777/tcp — separate from the UDP game traffic).
# No traditional RCON in v1; users admin via the in-game UI + API tokens.
#
# Reference: https://github.com/CubeCoders/AMPTemplates (SatisfactoryLinux.kvp)
id: satisfactory
name: "Satisfactory"
version: 0.1.0
authors:
- panel contributors
supported_modes:
- docker
runtime:
docker:
image: panel-satisfactory: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: "SaveGames/ + Engine/ + Game.ini"
- name: "Game Files"
path: /game
hint: "Server binaries"
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" }
# Port env vars MUST be pre-declared here — the agent's ResolveDocker
# only lets ConfigValues override keys that already exist in this map,
# so the allocator's per-instance ports would otherwise be dropped.
env:
GAME_PORT: "7777"
RELIABLE_PORT: "8888"
# Satisfactory 1.0+ port model: ONE game port (UDP game traffic + the
# HTTPS admin API on the same number over TCP — the server binds both
# itself under host networking) plus a TCP "reliable" messaging port.
# The pre-1.0 beacon/query ports no longer exist.
ports:
- { name: game, proto: udp, default: 7777, required: true, env: GAME_PORT }
- { name: reliable, proto: tcp, default: 8888, required: true, env: RELIABLE_PORT }
resources:
min_ram_mb: 6144
recommended_ram_mb: 12288
# Log-derived player events. Regexes converted from CubeCoders'
# AMPTemplates (satisfactory.kvp) — .NET (?<n>) syntax -> Go (?P<n>).
# Sourced-from-template; not yet exercised against a live client.
events:
join:
pattern: 'LogNet: Login request: \?ClientIdentity=.+\?EntryTicket=.+?EncryptionToken=.+\?Name=(?P<name>.+?) userId: .+\(ForeignId=\[Type=.+ Handle=.+ RepData=\[(?P<id>.+)\]\) platform: '
kind: join
leave:
pattern: 'LogNet: UChannel::Close: Sending CloseBunch\..+\[UNetConnection\] RemoteAddr: .+, Name: .+, Driver: .+, IsServer: YES, PC: .+, Owner: .+, UniqueId: .+\(ForeignId=\[Type=.+ Handle=.+ RepData=\[(?P<id>.+)\]\)'
kind: leave
update_providers:
- id: stable
kind: steamcmd
app_id: "1690800"
install_path: /game
- id: experimental
kind: steamcmd
app_id: "1690800"
beta: experimental
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 against a real boot 2026-07-14 (v1.2.0-CL-495413): the net
# driver line is when the server becomes joinable (~5s after start).
# "Server startup time elapsed" follows at ~30s once level load settles.
ready_pattern: '/IpNetDriver listening on port \d+|Server startup time elapsed/i'
appearance:
emoji: "🏭"
grad: "linear-gradient(135deg,#d97706,#fbbf24)"
art: "/game-art/satisfactory.jpg"
steam: "526870"