docs: PHP-8-Hinweis in README, Image-Tag auf 1.4.0

Ich weise in der README auf den Umstieg auf PHP 8.4 hin und bitte darum,
auftretende Fehler als Issue zu melden. docker-compose.yml zeigt jetzt
auf das Image 1.4.0.

.env.example

@@ -69,12 +69,20 @@ FORCE_MOD_SPEED=
 FORCE_MOD_ALPINE=
 FORCE_MOD_RALLY=
 
-# --- MatchSettings ---
+# --- Spieleinstellungen (MatchSettings) ---
 # Steuert, welche MatchSettings-Datei beim Serverstart geladen wird.
 # "auto" = die neueste .txt-Datei in data/gamedata/Tracks/MatchSettings/ wird automatisch erkannt.
 # Alternativ kann ein expliziter Dateiname angegeben werden (z.B. "turnier_settings.txt").
 MATCHSETTINGS_FILE=auto
 
+# Warmup-Dauer für alle Runden (0 = deaktiviert, 1 = eine Runde Warmup)
+ALLWARMUPDURATION=0
+
+# Map-Reihenfolge beim Containerstart zufällig mischen (true = aktiviert, false = deaktiviert)
+# Bei jedem Start werden die Maps in der aktiven MatchSettings-Datei neu durchgemischt,
+# sodass der Server jedes Mal mit einer anderen Map beginnt.
+SHUFFLE_MAPLIST=false
+
 # --- Debugging ---
 # Setze diesen Wert auf true, um PHP-Fehlermeldungen anzuzeigen. Dies kann bei der Fehlersuche hilfreich sein, sollte aber in einer Produktionsumgebung auf false belassen werden.
 PHP_DISPLAY_ERRORS=false
@@ -109,3 +117,15 @@ XASECO_DB_PASSWORD="4KpL8mWnR3xYvBq"
 # Dedimania-Nation (3-Zeichen IOC-Code, z.B. DEU, AUT, CHE)
 # Server-Login und -Passwort werden automatisch aus SERVER_LOGIN / SERVER_LOGIN_PASSWORD übernommen.
 XASECO_DEDIMANIA_NATION=DEU
+
+# XAseco-Healthcheck: Überwacht XAseco und startet es automatisch neu bei Absturz oder Verbindungsverlust.
+XASECO_HEALTHCHECK=true
+
+# Prüfintervall des Healthchecks in Sekunden (Standard: 60)
+XASECO_HEALTHCHECK_INTERVAL=60
+
+# --- IP-Watcher ---
+# Der IP-Watcher überwacht die ausgehende öffentliche IP des Containers und startet tmserver
+# automatisch neu, wenn sich die IP ändert – damit er sich beim Masterserver neu registriert.
+# Intervall in Sekunden, in dem die IP geprüft wird (Standard: 300 = 5 Minuten).
+IP_WATCHER_INTERVAL=300

.gitea/workflows/docker-publish.yml

@@ -0,0 +1,41 @@
+name: Build & Push Docker Image
+
+# Wird ausgeloest, wenn ein Tag wie "v1.3.0" gepusht wird
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      # "v1.3.0" -> "1.3.0" (fuehrendes "v" entfernen)
+      - name: Version aus Tag extrahieren
+        id: version
+        run: |
+          VERSION=$(echo "${{ gitea.ref_name }}" | sed 's/^v//')
+          echo "VERSION=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Bei Gitea Registry einloggen
+        run: |
+          echo "${{ secrets.REGISTRY_TOKEN }}" | \
+            docker login git.techniverse.net \
+              --username "${{ secrets.REGISTRY_USER }}" \
+              --password-stdin
+
+      - name: Docker Image bauen
+        run: |
+          docker build \
+            -t git.techniverse.net/scriptos/trackmania-server:${{ steps.version.outputs.VERSION }} \
+            -t git.techniverse.net/scriptos/trackmania-server:latest \
+            .
+
+      - name: Docker Image pushen
+        run: |
+          docker push git.techniverse.net/scriptos/trackmania-server:${{ steps.version.outputs.VERSION }}
+          docker push git.techniverse.net/scriptos/trackmania-server:latest

.gitignore

@@ -5,3 +5,6 @@
 data/
 
 .ki-workspace/
+backups/
+dockernet-inspector.v1.sh
+script.sh

Dockerfile

@@ -1,4 +1,5 @@
-FROM debian:bullseye-slim
+# Debian 13 Trixie liefert PHP 8.4 mit regulaeren Security-Updates
+FROM debian:trixie-slim
 
 RUN mkdir /opt/tmserver
 
@@ -15,6 +16,7 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
     php-mysql \
     php-curl \
     default-mysql-client \
+    logrotate \
     && rm -rf /var/lib/apt/lists/*
 
 # Apache mod_rewrite aktivieren und AllowOverride fuer .htaccess (RemoteCP-Sicherheit)
@@ -47,12 +49,20 @@ COPY assets/bin/RunTrackmaniaServer.sh /opt/tmserver/
 RUN sed -i 's/\r$//' /opt/tmserver/RunTrackmaniaServer.sh \
     && chmod +x /opt/tmserver/RunTrackmaniaServer.sh
 
+# PHP-8-Kompatibilitaet: ergaenzt __construct() fuer PHP-4-Konstruktoren
+# (wird bei jedem Start auf die Volumes angewendet)
+COPY assets/bin/Php8Compat.php /opt/tmserver/
+
+COPY assets/bin/XAsecoHealthcheck.sh /opt/tmserver/
+RUN sed -i 's/\r$//' /opt/tmserver/XAsecoHealthcheck.sh \
+    && chmod +x /opt/tmserver/XAsecoHealthcheck.sh
+
 COPY assets/bin/AdminServ_v2.1.1.zip /var/www/html
 RUN unzip /var/www/html/AdminServ_v2.1.1.zip -d /var/www/html \
     && rm -f /var/www/html/AdminServ_v2.1.1.zip \
     && rm -f /var/www/html/index.html \
     && mkdir -p /var/www/html/logs \
-    && chmod -R 777 /var/www/html/logs \
+    && chmod 755 /var/www/html/logs \
     && chmod 666 /var/www/html/config/adminlevel.cfg.php \
     && chmod 666 /var/www/html/config/servers.cfg.php \
     && chmod 666 /var/www/html/config/adminserv.cfg.php \
@@ -144,6 +154,11 @@ RUN cp -a /opt/tmserver/xaseco /opt/tmserver/default-xaseco
 # PHP-Debug-Konfiguration: wird zur Laufzeit vom Startup-Script gesetzt
 # (kein Rebuild noetig – nur Container neustarten)
 
+# Log-Rotation: logrotate-Konfiguration ins Image kopieren
+# Wird zur Laufzeit stuendlich per Background-Loop ausgefuehrt (kein cron noetig).
+COPY assets/config/logrotate.conf /etc/logrotate.d/tmserver
+RUN chmod 644 /etc/logrotate.d/tmserver
+
 # --- Umgebungsvariablen ---
 # Sensible Werte (Passwoerter, Keys) werden NICHT im Image hinterlegt,
 # sondern muessen zur Laufzeit uebergeben werden (z.B. via .env-Datei).
@@ -169,6 +184,7 @@ ENV FORCE_CONFIG_UPDATE=false
 
 # Spieleinstellungen (MatchSettings)
 ENV ALLWARMUPDURATION=0
+ENV SHUFFLE_MAPLIST=false
 
 # Forced Mods (Skins) - URL zu ZIP-Dateien, die beim Start forciert werden
 ENV FORCE_MOD_STADIUM=""
@@ -191,6 +207,8 @@ ENV XASECO_DB_HOST=mariadb
 ENV XASECO_DB_NAME=xaseco
 ENV XASECO_DB_USER=xaseco
 ENV XASECO_DEDIMANIA_NATION=DEU
+ENV XASECO_HEALTHCHECK=true
+ENV XASECO_HEALTHCHECK_INTERVAL=60
 
 # Debugging
 ENV PHP_DISPLAY_ERRORS=false
@@ -206,4 +224,8 @@ EXPOSE 2350/udp
 EXPOSE 3450/tcp
 EXPOSE 80/tcp
 
+# Graceful Shutdown: SIGTERM wird vom Signal-Handler im Startscript abgefangen
+# und alle Dienste (XAseco, TM-Server, Apache) sauber heruntergefahren.
+STOPSIGNAL SIGTERM
+
 CMD ["/opt/tmserver/RunTrackmaniaServer.sh"]

README.md

@@ -1,12 +1,32 @@
-# tmserver-docker
+<p align="center">
+  <a href="https://techniverse.net">
+    <img src="https://assets.techniverse.net/f1/git/graphics/repo-techniverse-logo.png" alt="Techniverse Community" height="70" />
+  </a>
+</p>
 
-Ein vollständiges Docker-Setup für einen **TrackMania Nations Forever**-Server – inklusive Web-Verwaltung und Server-Controller:
+<h1 align="center">TM-Server Docker</h1>
+
+<h4 align="center">
+  Ein vollständiges Docker-Setup für einen TrackMania Nations Forever-Server – inklusive Web-Verwaltung und Server-Controller
+</h4>
+
+<h6 align="center">
+  <a href="https://www.cleveradmin.de">🏰 Website</a>
+  ·
+  <a href="https://techniverse.net">📰 Community</a>
+  ·
+  <a href="https://social.techniverse.net/@donnerwolke">🐘 Mastodon</a>
+  ·
+  <a href="https://matrix.to/#/#support:techniverse.net">💬 Support</a>
+</h6>
+<br><br>
+
+## ✨ Übersicht
 
 - **TrackMania Dedicated Server** – der eigentliche Spielserver für Internet- oder LAN-Betrieb
 - **[XAseco](docs/xaseco.md)** – Server-Controller, der lokale Rekorde, Dedimania-Weltrekorde, Karma/Votes und eine Track-Jukebox direkt im Spielchat verwaltet
 - **[AdminServ](docs/adminserv.md)** – Web-Oberfläche zur komfortablen Verwaltung und Konfiguration des Servers
 - **[RemoteCP](docs/remotecp.md)** – alternative Web-Verwaltungsoberfläche mit eigenem Login- und Benutzersystem
-- **[Mods / Skins](docs/remotecp.md#mods--skins)** – über 50 vorkonfigurierte Stadium-Skins (gehostet auf [assets.techniverse.net](https://assets.techniverse.net/tm/skins/)), automatisch beim Start forcierbar
 
 Alle Komponenten laufen in einem einzigen Container und werden über Umgebungsvariablen konfiguriert.
 
@@ -14,7 +34,20 @@ Alle Komponenten laufen in einem einzigen Container und werden über Umgebungsva
 
 Der Server unterstützt sowohl den **Internet-Dedicated-Modus** (Standard) als auch den **LAN-Dedicated-Modus**.
 
-## Schnellstart
+## ⚠️ PHP 8 – bitte lesen (ab v1.4.0)
+
+Seit **v1.4.0** basiert das Image auf **Debian 13 (Trixie) mit PHP 8.4**. PHP 7.4 ist seit 2022 ohne Sicherheitsupdates und von kritischen Lücken wie *PHP2Shell* (CVE-2026-109618, CVE-2026-109619) betroffen – deshalb habe ich den Umstieg vorgenommen.
+
+AdminServ, RemoteCP und XAseco stammen allerdings aus PHP-5-Zeiten. Damit sie unter PHP 8 laufen, patcht der Container sie beim Start automatisch (PHP-4-Konstruktoren, veraltete Syntax, statische Aufrufe und einige bekannte Laufzeitfehler). Die Anpassungen sind idempotent und greifen auch bei bestehenden Volumes.
+
+Ich habe die gängigen Funktionen getestet, aber **es kann durchaus noch zu Fehlern kommen** – vor allem in selten genutzten Plugins oder Menüs. Wenn dir etwas auffällt (weiße Seite, HTTP 500, XAseco-Absturz, Funktion ohne Wirkung), eröffne bitte ein [Issue](https://git.techniverse.net/scriptos/tmserver-docker/issues) und gib möglichst an:
+
+- was du gemacht hast (Seite/Plugin/Chat-Befehl) und ungefähr wann,
+- die passende Meldung aus `docker logs tmserver`, dem Apache-Log (`docker exec tmserver tail -n 50 /var/log/apache2/error.log`), `data/xaseco/aseco.log` oder `data/controlpanel/remotecp/cache/errors.log`.
+
+Ich schaue mir das dann an. Wer PHP 7.4 behalten möchte, bleibt vorerst beim Image-Tag `1.3.3`.
+
+## 🚀 Schnellstart
 
 ### 1. Umgebungsvariablen einrichten
 
@@ -49,7 +82,7 @@ git.techniverse.net/scriptos/trackmania-server:latest
 
 > **Hinweis:** Für den Internet-Modus müssen `SERVER_LOGIN` und `SERVER_VALIDATION_KEY` in der `.env`-Datei gesetzt sein. Einen Server-Account kannst du auf [players.trackmaniaforever.com](https://players.trackmaniaforever.com) erstellen. Für den LAN-Modus setze `SERVER_MODE=lan`.
 
-## Dokumentation
+## 📚 Dokumentation
 
 Die vollständige Dokumentation befindet sich im Ordner [`docs/`](docs/README.md):
 
@@ -60,29 +93,29 @@ Die vollständige Dokumentation befindet sich im Ordner [`docs/`](docs/README.md
 - [AdminServ](docs/adminserv.md) – Einrichtung der Server-Verwaltungsoberfläche
 - [RemoteCP](docs/remotecp.md) – Alternative Server-Verwaltungsoberfläche
 - [XAseco](docs/xaseco.md) – Server-Controller für Rekorde, Karma und Jukebox
+- [IP-Watcher](docs/ip-watcher.md) – Automatischer Neustart bei IP-Wechsel
 - [Ports](docs/ports.md) – Freigegebene Ports und deren Verwendung
+- [Update](docs/update.md) – Bestehende Installation aktualisieren
 
-## Danksagung
+## 🙏 Danksagung
 
-Danke an **Thomas** ([retronerd.at](https://retronerd.at)), dass er mir sein Wissen zur Verfügung gestellt hat und dass er hier im Projekt mitgewirkt hat.
+Ein herzliches Dankeschön an **[Thomas](https://retronerd.at)** – für seine tatkräftige Unterstützung, sein wertvolles Wissen und seine Mitwirkung an diesem Projekt. Ohne ihn wäre dieses Projekt nicht das, was es heute ist!
 
-## Spiegelung
+## 🔄 Spiegelung
 
 Dieses Repository wird von **Gitea** auf **GitHub** gespiegelt. Das Master-Repository befindet sich auf Gitea:
 
 - **Gitea (Master):** [git.techniverse.net/scriptos/tmserver-docker](https://git.techniverse.net/scriptos/tmserver-docker.git)
 - **GitHub (Spiegel):** [github.com/pscriptos/tmserver-docker](https://github.com/pscriptos/tmserver-docker.git)
 
----
-
-📝 **Blog:** [www.cleveradmin.de](https://www.cleveradmin.de)  
-🌐 **Webseite:** [www.patrick-asmus.de](https://www.patrick-asmus.de)  
-📧 **E-Mail:** [support@techniverse.net](mailto:support@techniverse.net)  
 
+<br><br>
 <p align="center">
   <img src="https://assets.techniverse.net/f1/git/graphics/gray0-catonline.svg" alt="">
 </p>
 
 <p align="center">
-<img src="https://assets.techniverse.net/f1/logos/small/license.png" alt="License" width="15" height="15"> <a href="./LICENSE">License</a> | <img src="https://assets.techniverse.net/f1/logos/small/matrix2.svg" alt="Matrix" width="15" height="15"> <a href="https://matrix.to/#/#community:techniverse.net">Matrix</a> | <img src="https://assets.techniverse.net/f1/logos/small/mastodon2.svg" alt="Mastodon" width="15" height="15"> <a href="https://social.techniverse.net/@donnerwolke">Mastodon</a>
+  <sub>
-</p>
+     © Patrick Asmus · Techniverse Network · <a href="./LICENSE">Lizenz</a>
+  </sub>
+</p>

assets/bin/Php8Compat.php

@@ -0,0 +1,325 @@
+<?php
+/**
+ * Php8Compat.php - PHP-8-Kompatibilitaet fuer AdminServ, RemoteCP und XAseco
+ *
+ * Aufruf: php Php8Compat.php <verzeichnis> [<verzeichnis> ...]
+ *
+ * PHP 8 behandelt Methoden mit dem Namen der Klasse (PHP-4-Konstruktoren)
+ * nicht mehr als Konstruktor. Die alten Tools nutzen das an vielen Stellen,
+ * Objekte blieben dadurch uninitialisiert.
+ *
+ * Fuer jede Klasse mit PHP-4-Konstruktor und ohne __construct() wird direkt
+ * nach der oeffnenden Klammer ein __construct() eingefuegt, der die alte
+ * Methode aufruft. Die alte Methode bleibt erhalten, damit Aufrufe wie
+ * parent::IXR_Client(...) weiter funktionieren.
+ *
+ * Ausserdem werden String-Offsets mit geschweiften Klammern ($str{0}) auf
+ * eckige Klammern umgestellt (unter PHP 8 ein Parse-Error).
+ *
+ * Nicht-statische Methoden, die statisch aufgerufen werden (Core::getObject()),
+ * sind unter PHP 8 ein Fatal Error. Solche Methoden werden als static markiert,
+ * sofern sie $this nicht verwenden und keine Unterklasse sie nicht-statisch
+ * ueberschreibt.
+ *
+ * Idempotent: Klassen mit vorhandenem __construct() werden uebersprungen.
+ * Dateien werden in-place geschrieben (Besitzer und Rechte bleiben erhalten).
+ */
+
+if ($argc < 2) {
+    fwrite(STDERR, "Aufruf: php {$argv[0]} <verzeichnis> [...]\n");
+    exit(1);
+}
+
+$files = array();
+for ($i = 1; $i < $argc; $i++) {
+    if (!is_dir($argv[$i])) continue;
+    $it = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($argv[$i], FilesystemIterator::SKIP_DOTS));
+    foreach ($it as $file) {
+        if (strtolower($file->getExtension()) === 'php') $files[] = $file->getPathname();
+    }
+}
+
+$changed = array();
+$totalClasses = 0;
+$totalCurly = 0;
+$totalStatic = 0;
+
+// Durchlauf 1: Konstruktoren und String-Offsets (pro Datei)
+foreach ($files as $path) {
+    $src = file_get_contents($path);
+    if ($src === false) continue;
+    list($new, $count) = patchConstructors($src);
+    list($new, $curly) = patchCurlyOffsets($new);
+    if ($new !== $src) {
+        file_put_contents($path, $new);
+        $changed[$path] = true;
+        $totalClasses += $count;
+        $totalCurly += $curly;
+    }
+}
+
+// Durchlauf 2: statisch aufgerufene Methoden (dateiuebergreifend)
+foreach (patchStaticCalls($files) as $path => $count) {
+    $changed[$path] = true;
+    $totalStatic += $count;
+}
+
+echo "    PHP-8-Kompatibilitaet: $totalClasses Konstruktor(en), $totalCurly Offset(s), $totalStatic static-Methode(n) in " . count($changed) . " Datei(en) angepasst.\n";
+
+/**
+ * Markiert nicht-statische Methoden als static, wenn sie irgendwo als
+ * Klasse::methode() aufgerufen werden, $this nicht verwenden und von keiner
+ * Unterklasse nicht-statisch ueberschrieben werden.
+ *
+ * Liefert [Pfad => Anzahl geaenderter Methoden].
+ */
+function patchStaticCalls($files)
+{
+    $methods = array(); // "klasse::methode" => [pfad, token-index, static, usesThis]
+    $parents = array(); // "klasse" => "elternklasse"
+    $calls = array();   // "klasse::methode" => true
+    $tokensByFile = array();
+
+    foreach ($files as $path) {
+        $src = file_get_contents($path);
+        if ($src === false || strpos($src, '::') === false && stripos($src, 'class') === false) continue;
+        $t = @token_get_all($src);
+        $tokensByFile[$path] = $t;
+        $n = count($t);
+        $depth = 0;
+        $cls = null;
+        $clsDepth = -1;
+        for ($i = 0; $i < $n; $i++) {
+            $x = $t[$i];
+            if ($x === '{' || (is_array($x) && in_array($x[0], array(T_CURLY_OPEN, T_DOLLAR_OPEN_CURLY_BRACES), true))) {
+                $depth++;
+            } elseif ($x === '}') {
+                $depth--;
+                if ($depth === $clsDepth) { $cls = null; $clsDepth = -1; }
+            } elseif (is_array($x) && $x[0] === T_CLASS) {
+                $prev = prevSignificant($t, $i);
+                if ($prev !== null && is_array($t[$prev]) && in_array($t[$prev][0], array(T_DOUBLE_COLON, T_NEW), true)) continue;
+                $j = nextSignificant($t, $i);
+                if ($j !== null && is_array($t[$j]) && $t[$j][0] === T_STRING) {
+                    $cls = strtolower($t[$j][1]);
+                    $clsDepth = $depth;
+                    $e = nextSignificant($t, $j);
+                    if ($e !== null && is_array($t[$e]) && $t[$e][0] === T_EXTENDS) {
+                        $pc = nextSignificant($t, $e);
+                        if ($pc !== null && is_array($t[$pc])) $parents[$cls] = strtolower(ltrim($t[$pc][1], '\\'));
+                    }
+                }
+            } elseif ($cls !== null && is_array($x) && $x[0] === T_FUNCTION && $depth === $clsDepth + 1) {
+                $static = false;
+                for ($k = $i - 1; $k >= 0; $k--) {
+                    if (is_array($t[$k]) && $t[$k][0] === T_STATIC) $static = true;
+                    if ($t[$k] === ';' || $t[$k] === '{' || $t[$k] === '}') break;
+                }
+                $j = nextSignificant($t, $i);
+                if ($j !== null && $t[$j] === '&') $j = nextSignificant($t, $j);
+                if ($j === null || !is_array($t[$j])) continue;
+                $m = strtolower($t[$j][1]);
+                $usesThis = false;
+                $k = $j;
+                while ($k < $n && $t[$k] !== '{' && $t[$k] !== ';') $k++;
+                if ($k < $n && $t[$k] === '{') {
+                    $d = 0;
+                    for ($q = $k; $q < $n; $q++) {
+                        $y = $t[$q];
+                        if ($y === '{' || (is_array($y) && in_array($y[0], array(T_CURLY_OPEN, T_DOLLAR_OPEN_CURLY_BRACES), true))) $d++;
+                        elseif ($y === '}') { $d--; if ($d === 0) break; }
+                        elseif (is_array($y) && $y[0] === T_VARIABLE && $y[1] === '$this') $usesThis = true;
+                    }
+                }
+                $methods["$cls::$m"] = array($path, $i, $static, $usesThis);
+            } elseif (is_array($x) && $x[0] === T_DOUBLE_COLON && $i > 0 && isset($t[$i + 1])) {
+                $p = $t[$i - 1];
+                $nx = $t[$i + 1];
+                if (is_array($p) && $p[0] === T_STRING && is_array($nx) && $nx[0] === T_STRING) {
+                    $j = nextSignificant($t, $i + 1);
+                    $c = strtolower($p[1]);
+                    if ($j !== null && $t[$j] === '(' && !in_array($c, array('parent', 'self', 'static'), true)) {
+                        $calls[$c . '::' . strtolower($nx[1])] = true;
+                    }
+                }
+            }
+        }
+    }
+
+    // Kandidaten je Datei sammeln (Token-Index der function-Deklaration)
+    $todo = array();
+    foreach ($calls as $key => $_) {
+        if (!isset($methods[$key])) continue;
+        list($path, $idx, $static, $usesThis) = $methods[$key];
+        if ($static || $usesThis) continue;
+        // Nicht anfassen, wenn eine Unterklasse die Methode nicht-statisch ueberschreibt
+        list($target, $m) = explode('::', $key);
+        $overridden = false;
+        foreach ($methods as $other => $info) {
+            list($oc, $om) = explode('::', $other);
+            if ($om !== $m || $oc === $target || $info[2]) continue;
+            for ($a = $oc, $guard = 0; isset($parents[$a]) && $guard < 20; $a = $parents[$a], $guard++) {
+                if ($parents[$a] === $target) { $overridden = true; break 2; }
+            }
+        }
+        if ($overridden) continue;
+        $todo[$path][] = $idx;
+    }
+
+    $result = array();
+    foreach ($todo as $path => $indexes) {
+        $t = $tokensByFile[$path];
+        foreach ($indexes as $idx) {
+            $t[$idx] = array(T_FUNCTION, 'static ' . $t[$idx][1], 0);
+        }
+        $out = '';
+        foreach ($t as $tok) $out .= is_array($tok) ? $tok[1] : $tok;
+        file_put_contents($path, $out);
+        $result[$path] = count($indexes);
+    }
+    return $result;
+}
+
+/**
+ * Ersetzt String-Offsets mit geschweiften Klammern ($str{0}) durch eckige
+ * Klammern ($str[0]); unter PHP 8 ist die alte Syntax ein Parse-Error.
+ * Erfasst wird nur "{" direkt nach einer Variablen oder "]" (ohne
+ * Leerzeichen), dort hat "{" keine andere Bedeutung.
+ *
+ * Liefert [neuer Quelltext, Anzahl ersetzter Offsets].
+ */
+function patchCurlyOffsets($src)
+{
+    if (strpos($src, '{') === false) return array($src, 0);
+    $tokens = @token_get_all($src);
+    $n = count($tokens);
+    $count = 0;
+    for ($i = 1; $i < $n; $i++) {
+        if ($tokens[$i] !== '{') continue;
+        $prev = $tokens[$i - 1];
+        if (!($prev === ']' || (is_array($prev) && $prev[0] === T_VARIABLE))) continue;
+        // Passende schliessende Klammer suchen
+        $depth = 0;
+        for ($j = $i; $j < $n; $j++) {
+            $t = $tokens[$j];
+            if ($t === '{' || (is_array($t) && in_array($t[0], array(T_CURLY_OPEN, T_DOLLAR_OPEN_CURLY_BRACES), true))) $depth++;
+            elseif ($t === '}') { $depth--; if ($depth === 0) break; }
+        }
+        if ($j >= $n) continue;
+        $tokens[$i] = '[';
+        $tokens[$j] = ']';
+        $count++;
+    }
+    if ($count === 0) return array($src, 0);
+    $out = '';
+    foreach ($tokens as $t) $out .= is_array($t) ? $t[1] : $t;
+    return array($out, $count);
+}
+
+/**
+ * Liefert [neuer Quelltext, Anzahl eingefuegter Konstruktoren].
+ */
+function patchConstructors($src)
+{
+    if (stripos($src, 'class') === false) return array($src, 0);
+    $eol = (strpos($src, "\r\n") !== false) ? "\r\n" : "\n";
+    $tokens = @token_get_all($src);
+    $n = count($tokens);
+    $inserts = array(); // Byte-Offset => einzufuegender Text
+
+    // Byte-Offsets aller Tokens berechnen
+    $offsets = array();
+    $pos = 0;
+    for ($i = 0; $i < $n; $i++) {
+        $offsets[$i] = $pos;
+        $pos += strlen(is_array($tokens[$i]) ? $tokens[$i][1] : $tokens[$i]);
+    }
+
+    for ($i = 0; $i < $n; $i++) {
+        if (!is_array($tokens[$i]) || $tokens[$i][0] !== T_CLASS) continue;
+
+        // "Foo::class" und anonyme Klassen ("new class") ignorieren
+        $prev = prevSignificant($tokens, $i);
+        if ($prev !== null && is_array($tokens[$prev]) && in_array($tokens[$prev][0], array(T_DOUBLE_COLON, T_NEW), true)) continue;
+
+        $nameIdx = nextSignificant($tokens, $i);
+        if ($nameIdx === null || !is_array($tokens[$nameIdx]) || $tokens[$nameIdx][0] !== T_STRING) continue;
+        $className = $tokens[$nameIdx][1];
+
+        // Oeffnende Klammer des Klassenkoerpers suchen
+        $open = $nameIdx;
+        while ($open < $n && $tokens[$open] !== '{') $open++;
+        if ($open >= $n) continue;
+
+        // Methoden auf Klassenebene einsammeln
+        $depth = 0;
+        $hasConstruct = false;
+        $oldCtor = null;
+        for ($j = $open; $j < $n; $j++) {
+            $t = $tokens[$j];
+            if ($t === '{' || (is_array($t) && in_array($t[0], array(T_CURLY_OPEN, T_DOLLAR_OPEN_CURLY_BRACES), true))) {
+                $depth++;
+            } elseif ($t === '}') {
+                $depth--;
+                if ($depth === 0) break;
+            } elseif ($depth === 1 && is_array($t) && $t[0] === T_FUNCTION) {
+                $k = nextSignificant($tokens, $j);
+                if ($k !== null && $tokens[$k] === '&') $k = nextSignificant($tokens, $k);
+                if ($k === null || !is_array($tokens[$k])) continue;
+                $method = $tokens[$k][1];
+                if (strcasecmp($method, '__construct') === 0) $hasConstruct = true;
+                if (strcasecmp($method, $className) === 0) $oldCtor = $k;
+            }
+        }
+        if ($hasConstruct || $oldCtor === null) continue;
+
+        // Parameterliste der alten Methode uebernehmen
+        $p = $oldCtor;
+        while ($p < $n && $tokens[$p] !== '(') $p++;
+        $params = '';
+        $vars = array();
+        $byRef = false;
+        $pd = 0;
+        for ($q = $p; $q < $n; $q++) {
+            $t = $tokens[$q];
+            if ($t === '(') { $pd++; if ($pd === 1) continue; }
+            if ($t === ')') { $pd--; if ($pd === 0) break; }
+            $txt = is_array($t) ? $t[1] : $t;
+            $params .= $txt;
+            if ($pd === 1 && is_array($t) && $t[0] === T_VARIABLE) $vars[] = $t[1];
+            if ($pd === 1 && $t === '&') $byRef = true;
+        }
+
+        // Ohne Referenzparameter func_get_args() nutzen (gleiche Semantik bei
+        // optionalen Parametern), sonst die Variablen direkt durchreichen.
+        $call = $byRef ? implode(', ', $vars) : '...func_get_args()';
+        $shim = "{$eol}\t// tmserver-docker: Php8Compat{$eol}"
+              . "\tfunction __construct(" . trim($params) . ") { \$this->{$tokens[$oldCtor][1]}($call); }";
+        $inserts[$offsets[$open] + 1] = $shim;
+    }
+
+    if (empty($inserts)) return array($src, 0);
+    krsort($inserts);
+    foreach ($inserts as $off => $txt) {
+        $src = substr($src, 0, $off) . $txt . substr($src, $off);
+    }
+    return array($src, count($inserts));
+}
+
+function nextSignificant($tokens, $i)
+{
+    for ($j = $i + 1, $n = count($tokens); $j < $n; $j++) {
+        if (is_array($tokens[$j]) && in_array($tokens[$j][0], array(T_WHITESPACE, T_COMMENT, T_DOC_COMMENT), true)) continue;
+        return $j;
+    }
+    return null;
+}
+
+function prevSignificant($tokens, $i)
+{
+    for ($j = $i - 1; $j >= 0; $j--) {
+        if (is_array($tokens[$j]) && in_array($tokens[$j][0], array(T_WHITESPACE, T_COMMENT, T_DOC_COMMENT), true)) continue;
+        return $j;
+    }
+    return null;
+}

assets/bin/RunTrackmaniaServer.sh

@@ -39,7 +39,7 @@ DEFAULT_CONTROLPANEL="/opt/tmserver/default-controlpanel"
 if [ ! -f "$ADMINSERV_DIR/index.php" ]; then
     echo "==> Erster Start erkannt: Kopiere AdminServ-Dateien ins Volume..."
     cp -a "$DEFAULT_CONTROLPANEL"/* "$ADMINSERV_DIR/"
-    chmod -R 777 "$ADMINSERV_DIR/logs/"
+    chmod 777 "$ADMINSERV_DIR/logs/"
     chmod 666 "$ADMINSERV_DIR/config/adminlevel.cfg.php"
     chmod 666 "$ADMINSERV_DIR/config/servers.cfg.php"
     chmod 666 "$ADMINSERV_DIR/config/adminserv.cfg.php"
@@ -71,6 +71,18 @@ EOPHP
     chown www-data:www-data "$ADMINSERV_DIR/config/servers.cfg.php"
     echo "    AdminServ-Server-Eintrag automatisch konfiguriert (Port: ${XMLRPC_PORT})."
 
+    # AdminServ-Konfigurationspasswort automatisch sichern
+    # OnlineConfig::PASSWORD in adminserv.cfg.php schuetzt die /config-Seite
+    # (Server hinzufuegen/aendern/loeschen). Da der Server-Eintrag bereits
+    # automatisch konfiguriert wird, ist kein manueller Zugriff noetig.
+    # Der Standard-Hash aus dem ZIP wird durch einen zufaelligen ersetzt.
+    ADMINSERV_CFG="$ADMINSERV_DIR/config/adminserv.cfg.php"
+    if [ -f "$ADMINSERV_CFG" ]; then
+        RANDOM_HASH=$(head -c 32 /dev/urandom | md5sum | cut -d' ' -f1)
+        sed -i "s|const PASSWORD = '[^']*';|const PASSWORD = '${RANDOM_HASH}';|" "$ADMINSERV_CFG"
+        echo "    AdminServ-Konfigurationspasswort automatisch gesichert."
+    fi
+
     echo "    AdminServ-Dateien erfolgreich kopiert."
 
     # ============================================================
@@ -232,6 +244,54 @@ else
     echo "==> Vorhandene AdminServ-Daten gefunden. Keine Aenderungen."
 fi
 
+# ============================================================
+# RemoteCP: PHP-7.4-Kompatibilitaet & Fehleranzeige (bei jedem Start)
+# ============================================================
+# RemoteCP 4.0.3.5 nutzt veraltete Syntax ($str{0}, PHP4-Konstruktor), die
+# unter PHP 7.4 Deprecation-Meldungen im Browser erzeugt (unter PHP 8 fatal).
+# Ausserdem erzwingt core.functions.php display_errors=1 per ini_set() und
+# ignoriert damit PHP_DISPLAY_ERRORS. Die Patches sind idempotent und greifen
+# auch bei bestehenden Volumes.
+RCP_INC="$ADMINSERV_DIR/remotecp/includes"
+if [ -d "$RCP_INC" ]; then
+    echo "==> Patche RemoteCP fuer PHP 7.4..."
+
+    # Geschweifte Klammern fuer String-Offsets -> eckige Klammern
+    [ -f "$RCP_INC/core/rcp_textparser.class.php" ] && sed -i -E \
+        -e 's/\$hex\{([0-9])\}/$hex[\1]/g' \
+        -e 's/function TMFColorParser\(/function __construct(/' \
+        "$RCP_INC/core/rcp_textparser.class.php"
+    [ -f "$RCP_INC/core/GbxRemote.inc.php" ] && sed -i -E \
+        -e 's/\$f_v\{([0-9])\}/$f_v[\1]/g' \
+        "$RCP_INC/core/GbxRemote.inc.php"
+
+    # display_errors an PHP_DISPLAY_ERRORS koppeln
+    if [ -f "$RCP_INC/core.functions.php" ]; then
+        sed -i -E \
+            -e "s/^ini_set\('display_errors', 1\);/ini_set('display_errors', getenv('PHP_DISPLAY_ERRORS') === 'true' ? 1 : 0);/" \
+            -e "s/^ini_set\('display_startup_errors', 1\);/ini_set('display_startup_errors', getenv('PHP_DISPLAY_ERRORS') === 'true' ? 1 : 0);/" \
+            "$RCP_INC/core.functions.php"
+        # PHP-Warnings ohne Debug-Modus nur loggen, nicht im Browser anzeigen.
+        # v2: Unter PHP 8 sind viele fruehere Notices (Undefined array key, ...)
+        # Warnings; die werden wie unter PHP 7 ignoriert, sonst waechst das Log
+        # um mehrere MB pro Tag. Alte v1-Variante wird ersetzt.
+        if ! grep -q 'tmserver-docker: PHP_DISPLAY_ERRORS v2' "$RCP_INC/core.functions.php"; then
+            sed -i '/tmserver-docker: PHP_DISPLAY_ERRORS - /,/^\t}$/d' "$RCP_INC/core.functions.php"
+            sed -i "/if(error_reporting() == 0) return;/a\\
+\\t//tmserver-docker: PHP_DISPLAY_ERRORS v2 - PHP-Warnings ohne Debug-Modus nur loggen\\
+\\tif(\$errno == E_WARNING \&\& !ini_get('display_errors')) {\\
+\\t\\tif(preg_match('/^(Undefined (array key|variable|property|offset)|Attempt to read property|Trying to access array offset|Constant .* already defined|Array to string conversion)/', \$errstr)) return true;\\
+\\t\\twriteLog('errors', \"[PHP Warning] \$errstr on line \$errline in file \$errfile\");\\
+\\t\\treturn true;\\
+\\t}" "$RCP_INC/core.functions.php"
+        fi
+    fi
+
+    # sed -i legt neue Dateien als root an -> Besitzer wiederherstellen
+    chown www-data:www-data "$RCP_INC/core.functions.php" \
+        "$RCP_INC/core/rcp_textparser.class.php" "$RCP_INC/core/GbxRemote.inc.php" 2>/dev/null
+fi
+
 # ============================================================
 # XAseco: First-Run-Logik
 # ============================================================
@@ -353,13 +413,75 @@ if [ "$XASECO_ENABLED" = "true" ]; then
     fi
 fi
 
+# ============================================================
+# PHP-8-Kompatibilitaet (bei jedem Start, auch fuer bestehende Volumes)
+# ============================================================
+# AdminServ, RemoteCP und XAseco stammen aus PHP-5-Zeiten. Php8Compat.php
+# ergaenzt __construct() fuer PHP-4-Konstruktoren und stellt String-Offsets
+# mit geschweiften Klammern ($str{0}) auf eckige Klammern um. Idempotent.
+echo "==> Pruefe PHP-8-Kompatibilitaet..."
+php /opt/tmserver/Php8Compat.php "$ADMINSERV_DIR" /opt/tmserver/xaseco | tail -n 1
+
+# XAseco: mysql_*-Shim (modernizer.inc.php) erwartet false bei SQL-Fehlern.
+# Seit PHP 8.1 wirft mysqli standardmaessig Exceptions -> abschalten.
+XASECO_MODERNIZER="/opt/tmserver/xaseco/includes/modernizer.inc.php"
+if [ -f "$XASECO_MODERNIZER" ] && ! grep -q 'mysqli_report' "$XASECO_MODERNIZER"; then
+    sed -i '0,/^<?php/s//<?php\nmysqli_report(MYSQLI_REPORT_OFF); \/\/ tmserver-docker: PHP 8.1+/' "$XASECO_MODERNIZER"
+    echo "    modernizer.inc.php: mysqli_report(MYSQLI_REPORT_OFF) ergaenzt."
+fi
+
+# XAseco: Webaccess initialisiert Antworten als '' statt array(). Schreib- und
+# Lesezugriffe wie $response['Code'] waren unter PHP 7 nur Warnings
+# ("Illegal string offset"), unter PHP 8 beenden sie XAseco (TypeError).
+XASECO_WEBACCESS="/opt/tmserver/xaseco/includes/web_access.inc.php"
+if [ -f "$XASECO_WEBACCESS" ] && grep -q "\['Response'\] = '';" "$XASECO_WEBACCESS"; then
+    sed -i "s/\['Response'\] = '';/['Response'] = array();/" "$XASECO_WEBACCESS"
+    echo "    web_access.inc.php: Response als array() initialisiert."
+fi
+
+# XAseco TeamSpeak3-Plugin: count() auf null ist unter PHP 8 ein TypeError
+XASECO_TS3="/opt/tmserver/xaseco/plugins/plugin.teamspeak3.php"
+if [ -f "$XASECO_TS3" ] && grep -qF "if ( count(\$info['players']) > 0 ) {" "$XASECO_TS3"; then
+    sed -i "s/if ( count(\$info\['players'\]) > 0 ) {/if ( !empty(\$info['players']) \&\& is_array(\$info['players']) ) {/" "$XASECO_TS3"
+    echo "    plugin.teamspeak3.php: count()-Pruefung entschaerft."
+fi
+
+# XAseco TeamSpeak3-Plugin: Antwortet der TS3-Query-Port nicht korrekt, wirft
+# tsstatus.php eine Exception, die niemand faengt -> XAseco stirbt (auch unter
+# PHP 7). Wie bei den uebrigen, bereits auskommentierten throws: leer zurueck.
+XASECO_TSSTATUS="/opt/tmserver/xaseco/includes/tsstatus.php"
+if [ -f "$XASECO_TSSTATUS" ] && grep -qF 'if(!$isTs3) throw new Exception("Not a Teamspeak 3 server/bad query port");' "$XASECO_TSSTATUS"; then
+    sed -i 's|if(!\$isTs3) throw new Exception("Not a Teamspeak 3 server/bad query port");|if(!$isTs3) { $this->disconnect(); return ""; } // tmserver-docker: kein Absturz|' "$XASECO_TSSTATUS"
+    echo "    tsstatus.php: Exception bei fehlerhaftem TS3-Query entschaerft."
+fi
+
+# AdminServ: stat() liefert bei Dateinamen mit Sonderzeichen false (AdminServ
+# wandelt sie vorher per utf8_encode um). @array_slice(false) war unter PHP 7
+# still, unter PHP 8 ein TypeError -> "MatchSettings erstellen" brach ab.
+ADMINSERV_FOLDER="$ADMINSERV_DIR/resources/class/folder.class.php"
+if [ -f "$ADMINSERV_FOLDER" ] && grep -qF '@array_slice(@stat($pathToEntry), 20, 3)' "$ADMINSERV_FOLDER"; then
+    sed -i 's/@array_slice(@stat(\$pathToEntry), 20, 3)/((\$st = @stat(\$pathToEntry)) ? array_slice(\$st, 20, 3) : array())/' "$ADMINSERV_FOLDER"
+    echo "    folder.class.php: stat()-Fehler abgefangen."
+fi
+
+# AdminServ: Felder wie LapsTimeLimit werden in ms angezeigt, beim Speichern
+# aber nochmals mit 1000 multipliziert. Beim Maximalwert 2147483647 lehnt der
+# Server den Aufruf ab (Numerical result out of range) -> auf int32 begrenzen.
+ADMINSERV_TIMEDATE="$ADMINSERV_DIR/resources/class/timedate.class.php"
+if [ -f "$ADMINSERV_TIMEDATE" ] && grep -qF 'if($millisec > 0){ return $millisec; }' "$ADMINSERV_TIMEDATE"; then
+    sed -i 's/if(\$millisec > 0){ return \$millisec; }/if($millisec > 0){ return min($millisec, 2147483647); }/' "$ADMINSERV_TIMEDATE"
+    echo "    timedate.class.php: secToMillisec() auf int32 begrenzt."
+fi
+
 # ============================================================
 # XAseco: TeamSpeak3-Plugin Gateway aktualisieren (fuer bestehende Volumes)
 # ============================================================
-# Das Original-TS3-Gateway ist nicht mehr verfuegbar. Die eigene
+# Das Original-TS3-Gateway ist nicht mehr verfuegbar. Falls die
-# teamspeak3.xml mit dem Ersatz-Gateway wird in das Volume kopiert,
+# teamspeak3.xml fehlt, wird sie aus dem Template kopiert. Falls sie
-# falls sie fehlt oder noch das alte (nicht mehr erreichbare) Gateway
+# bereits existiert (= Nutzer hat eigene TS3-Daten konfiguriert),
-# referenziert. Gleichzeitig wird das Plugin reaktiviert, falls es
+# werden NUR die Gateway-URLs (helperURL/logoURL) gezielt aktualisiert.
+# Alle anderen Einstellungen (Server, Port, Channel etc.) bleiben
+# erhalten. Gleichzeitig wird das Plugin reaktiviert, falls es
 # in einer frueheren Version auskommentiert wurde.
 # ============================================================
 XASECO_DIR_TS3="/opt/tmserver/xaseco"
@@ -367,16 +489,30 @@ TS3_XML="$XASECO_DIR_TS3/teamspeak3.xml"
 TS3_DEFAULT="/opt/tmserver/default-xaseco/teamspeak3.xml"
 TS3_PLUGINS_XML="$XASECO_DIR_TS3/plugins.xml"
 
-# teamspeak3.xml aktualisieren: Kopieren wenn fehlend oder veraltet
+# teamspeak3.xml aktualisieren: Kopieren wenn fehlend, Gateway-URLs gezielt patchen
+# WICHTIG: Bei bestehender Datei wird NICHT die gesamte Datei ueberschrieben,
+# damit benutzerdefinierte Einstellungen (Server, Port, Channel) erhalten bleiben.
+# Nur die Gateway-URLs (helperURL/logoURL) werden aktualisiert, falls sie noch
+# auf ein altes, nicht mehr erreichbares Gateway zeigen.
 if [ -f "$TS3_DEFAULT" ]; then
     if [ ! -f "$TS3_XML" ]; then
         echo "==> TeamSpeak3-Gateway: teamspeak3.xml fehlt, kopiere aus Template..."
         cp "$TS3_DEFAULT" "$TS3_XML"
         echo "    teamspeak3.xml erfolgreich kopiert."
-    elif ! diff -q "$TS3_DEFAULT" "$TS3_XML" > /dev/null 2>&1; then
+    else
-        echo "==> TeamSpeak3-Gateway: teamspeak3.xml wird aktualisiert..."
+        # Gateway-URLs aus dem Template auslesen
-        cp "$TS3_DEFAULT" "$TS3_XML"
+        NEW_HELPER_URL=$(grep -oP '(?<=<helperURL>).*?(?=</helperURL>)' "$TS3_DEFAULT")
-        echo "    teamspeak3.xml erfolgreich aktualisiert."
+        NEW_LOGO_URL=$(grep -oP '(?<=<logoURL>).*?(?=</logoURL>)' "$TS3_DEFAULT")
+        # Aktuelle URLs aus der bestehenden Datei auslesen
+        CUR_HELPER_URL=$(grep -oP '(?<=<helperURL>).*?(?=</helperURL>)' "$TS3_XML")
+        CUR_LOGO_URL=$(grep -oP '(?<=<logoURL>).*?(?=</logoURL>)' "$TS3_XML")
+        # Nur patchen, wenn sich die Gateway-URLs unterscheiden
+        if [ "$CUR_HELPER_URL" != "$NEW_HELPER_URL" ] || [ "$CUR_LOGO_URL" != "$NEW_LOGO_URL" ]; then
+            echo "==> TeamSpeak3-Gateway: Aktualisiere Gateway-URLs (Server-Einstellungen bleiben erhalten)..."
+            [ -n "$NEW_HELPER_URL" ] && sed -i "s|<helperURL>.*</helperURL>|<helperURL>${NEW_HELPER_URL}</helperURL>|" "$TS3_XML"
+            [ -n "$NEW_LOGO_URL" ] && sed -i "s|<logoURL>.*</logoURL>|<logoURL>${NEW_LOGO_URL}</logoURL>|" "$TS3_XML"
+            echo "    Gateway-URLs erfolgreich aktualisiert."
+        fi
     fi
 fi
 
@@ -447,6 +583,41 @@ if [ -f "$MODS_SETTINGS_FILE" ] && grep -q 'blacksunonline.com' "$MODS_SETTINGS_
     echo "    Mods/settings.xml erfolgreich aktualisiert."
 fi
 
+# ============================================================
+# AdminServ: Konfigurationspasswort absichern (fuer bestehende Volumes)
+# ============================================================
+# AdminServ wird mit einem oeffentlich bekannten Standard-Hash
+# ausgeliefert (0b28a5799a32c687dad2c5183718ceac, aus dem
+# AdminServ-GitHub-Repo). Dieser wird durch einen zufaelligen
+# MD5-Hash ersetzt, damit die /config-Seite abgesichert ist.
+# ============================================================
+ADMINSERV_CFG_VOL="/var/www/html/config/adminserv.cfg.php"
+if [ -f "$ADMINSERV_CFG_VOL" ] && grep -q "0b28a5799a32c687dad2c5183718ceac" "$ADMINSERV_CFG_VOL"; then
+    echo "==> SICHERHEIT: AdminServ-Konfigurationspasswort wird ersetzt (Standard-Hash erkannt)..."
+    RANDOM_HASH=$(head -c 32 /dev/urandom | md5sum | cut -d' ' -f1)
+    sed -i "s|const PASSWORD = '0b28a5799a32c687dad2c5183718ceac';|const PASSWORD = '${RANDOM_HASH}';|" "$ADMINSERV_CFG_VOL"
+    echo "    Standard-Hash durch zufaelligen Hash ersetzt."
+    echo "    Die /config-Seite ist jetzt abgesichert."
+fi
+
+# ============================================================
+# AdminServ: Berechtigungen fuer Logs und Configs sicherstellen
+# ============================================================
+# AdminServ verlangt Schreibrechte (777 fuer ./logs/ und 666 fuer Configs).
+# Beim Containerstart stellen wir sicher, dass das Verzeichnis existiert,
+# www-data gehoert und die noetigen Berechtigungen gesetzt sind.
+# ============================================================
+ADMINSERV_LOGS_DIR="/var/www/html/logs"
+mkdir -p "$ADMINSERV_LOGS_DIR"
+chmod 777 "$ADMINSERV_LOGS_DIR"
+chown -R www-data:www-data "$ADMINSERV_LOGS_DIR" 2>/dev/null || true
+
+ADMINSERV_CONFIG_DIR="/var/www/html/config"
+if [ -d "$ADMINSERV_CONFIG_DIR" ]; then
+    chmod 666 "$ADMINSERV_CONFIG_DIR"/*.cfg.php 2>/dev/null || true
+    chown -R www-data:www-data "$ADMINSERV_CONFIG_DIR" 2>/dev/null || true
+fi
+
 echo "Starting apache server"
 service apache2 start
 
@@ -698,6 +869,83 @@ fi
 
 echo "    Aktive MatchSettings: ${GAME_SETTINGS_PATH}"
 
+# ============================================================
+# MatchSettings: Map-Reihenfolge zufaellig mischen
+# ============================================================
+# Ueber die Umgebungsvariable SHUFFLE_MAPLIST kann gesteuert werden,
+# ob die Reihenfolge der Maps in der aktiven MatchSettings-Datei
+# beim Containerstart zufaellig durchgemischt wird:
+#   - "false" (Standard): Reihenfolge bleibt unveraendert.
+#   - "true":  Alle <challenge>-Eintraege werden zufaellig gemischt
+#              und <startindex> wird auf 0 gesetzt.
+# Die originale Datei wird dabei ueberschrieben.
+# ============================================================
+
+SHUFFLE_MAPLIST="${SHUFFLE_MAPLIST:-false}"
+
+if [ "$SHUFFLE_MAPLIST" = "true" ]; then
+    # Vollstaendigen Pfad zur aktiven MatchSettings-Datei bestimmen
+    ACTIVE_MS_FILE="$GAMEDATA_DIR/Tracks/${GAME_SETTINGS_PATH}"
+    if [ -f "$ACTIVE_MS_FILE" ]; then
+        echo "==> Map-Shuffle: Mische Maps in ${GAME_SETTINGS_PATH}..."
+        php -r '
+            $file = $argv[1];
+            $xml = file_get_contents($file);
+            if ($xml === false) {
+                echo "    FEHLER: Konnte MatchSettings-Datei nicht lesen.\n";
+                exit(1);
+            }
+
+            // Alle <challenge>...</challenge>-Bloecke extrahieren
+            if (!preg_match_all("/<challenge>.*?<\/challenge>/s", $xml, $matches)) {
+                echo "    Keine <challenge>-Eintraege gefunden. Shuffle uebersprungen.\n";
+                exit(0);
+            }
+
+            $challenges = $matches[0];
+            $count = count($challenges);
+            echo "    $count Maps gefunden. Mische Reihenfolge...\n";
+
+            // Zufaellig mischen
+            shuffle($challenges);
+
+            // Alle bestehenden <challenge>-Bloecke aus dem XML entfernen
+            $xmlClean = preg_replace("/(\s*<challenge>.*?<\/challenge>)+/s", "", $xml, 1);
+
+            // Gemischte Challenges vor </playlist> wieder einfuegen
+            $challengeBlock = "";
+            foreach ($challenges as $ch) {
+                $challengeBlock .= "\t" . $ch . "\n";
+            }
+            $xmlNew = str_replace("</playlist>", $challengeBlock . "</playlist>", $xmlClean);
+
+            // <startindex> auf 0 setzen (damit ab der ersten gemischten Map gestartet wird)
+            $xmlNew = preg_replace("/<startindex>[^<]*<\/startindex>/", "<startindex>0</startindex>", $xmlNew);
+
+            // Datei zurueckschreiben
+            if (file_put_contents($file, $xmlNew) === false) {
+                echo "    FEHLER: Konnte MatchSettings-Datei nicht schreiben.\n";
+                exit(1);
+            }
+
+            // Erste 3 Maps anzeigen
+            echo "    Reihenfolge erfolgreich gemischt.\n";
+            echo "    Neue Startreihenfolge (erste 3 Maps):\n";
+            for ($i = 0; $i < min(3, $count); $i++) {
+                if (preg_match("/<file>(.*?)<\/file>/", $challenges[$i], $m)) {
+                    echo "      " . ($i + 1) . ". " . $m[1] . "\n";
+                }
+            }
+            if ($count > 3) echo "      ... und " . ($count - 3) . " weitere Maps\n";
+        ' "$ACTIVE_MS_FILE"
+    else
+        echo "==> Map-Shuffle: MatchSettings-Datei nicht gefunden: ${ACTIVE_MS_FILE}"
+        echo "    Shuffle uebersprungen."
+    fi
+else
+    echo "==> Map-Shuffle: Deaktiviert (SHUFFLE_MAPLIST=false)."
+fi
+
 # Bestimme Server-Modus (Standard: internet)
 SERVER_MODE="${SERVER_MODE:-internet}"
 
@@ -778,10 +1026,22 @@ if [ "$XMLRPC_READY" = "true" ]; then
         cd /opt/tmserver/xaseco
         php aseco.php TMN </dev/null >>aseco.log 2>&1 &
         XASECO_PID=$!
+        echo "$XASECO_PID" > /tmp/xaseco.pid
         echo "    XAseco gestartet (PID: ${XASECO_PID})"
         cd /opt/tmserver
+
+        # XAseco Healthcheck / Watchdog starten
+        XASECO_HEALTHCHECK="${XASECO_HEALTHCHECK:-true}"
+        if [ "$XASECO_HEALTHCHECK" = "true" ] && [ -f "/opt/tmserver/XAsecoHealthcheck.sh" ]; then
+            echo "==> Starte XAseco-Healthcheck (Watchdog)..."
+            /opt/tmserver/XAsecoHealthcheck.sh &
+            HEALTHCHECK_PID=$!
+            echo "    XAseco-Healthcheck gestartet (PID: ${HEALTHCHECK_PID})"
+        elif [ "$XASECO_HEALTHCHECK" != "true" ]; then
+            echo "==> XAseco-Healthcheck ist deaktiviert (XASECO_HEALTHCHECK=${XASECO_HEALTHCHECK})."
+        fi
     elif [ "${XASECO_ENABLED:-true}" != "true" ]; then
-        echo "==> XAseco ist deaktiviert (XASECO_ENABLED=${XASECO_ENABLED})."
+        echo "==> XAseco ist deaktiviert (XASECO_ENABLED=${XASECO_ENABLED})." 
     fi
 else
     echo "    WARNUNG: XMLRPC nicht erreichbar - XAseco und Forced Mods wurden NICHT gestartet."
@@ -967,5 +1227,293 @@ elif [ "$XMLRPC_READY" = "true" ]; then
     echo "==> Forced Mods: Keine FORCE_MOD_*-Variablen gesetzt. Ueberspringe."
 fi
 
+# ============================================================
+# Log-Rotation: Hintergrundprozess starten
+# ============================================================
+# logrotate wird stuendlich ausgefuehrt, um Apache-, PHP- und
+# XAseco-Logs groessenbasiert zu rotieren (max. 10 MB pro Datei,
+# 5 rotierte Dateien). Da im Container kein cron laeuft, wird
+# ein einfacher Background-Loop verwendet.
+# ============================================================
+echo "==> Starte Log-Rotation (stuendlich, groessenbasiert 10 MB)..."
+(
+    while true; do
+        sleep 3600
+        /usr/sbin/logrotate /etc/logrotate.d/tmserver --state /tmp/logrotate.state
+    done
+) &
+LOGROTATE_PID=$!
+echo "    Log-Rotation gestartet (PID: ${LOGROTATE_PID})"
+
+# ============================================================
+# Graceful Shutdown: Signal-Handler
+# ============================================================
+# Faengt TERM/INT ab und beendet alle Dienste sauber in
+# der richtigen Reihenfolge:
+#   1. XAseco-Healthcheck (verhindert Neustart waehrend Shutdown)
+#   2. XAseco (schliesst DB-Connections ordentlich)
+#   3. TrackmaniaServer
+#   4. Apache (AdminServ/RemoteCP)
+#   5. Log-Rotation
+# Verhindert Datenbank-Korruption beim Container-Stop.
+# ============================================================
+graceful_shutdown() {
+    echo ""
+    echo "============================================================"
+    echo "==> Graceful Shutdown eingeleitet (Signal empfangen)..."
+    echo "============================================================"
+
+    # 1. XAseco-Healthcheck beenden (verhindert Neustart waehrend Shutdown)
+    if [ -n "${HEALTHCHECK_PID:-}" ] && kill -0 "$HEALTHCHECK_PID" 2>/dev/null; then
+        echo "    Beende XAseco-Healthcheck (PID: ${HEALTHCHECK_PID})..."
+        kill "$HEALTHCHECK_PID" 2>/dev/null
+        wait "$HEALTHCHECK_PID" 2>/dev/null
+        echo "    XAseco-Healthcheck beendet."
+    fi
+
+    # 2. XAseco beenden (schliesst DB-Connections ordentlich)
+    XASECO_PID_CURRENT=""
+    if [ -f "/tmp/xaseco.pid" ]; then
+        XASECO_PID_CURRENT=$(cat /tmp/xaseco.pid 2>/dev/null)
+    fi
+    if [ -n "$XASECO_PID_CURRENT" ] && kill -0 "$XASECO_PID_CURRENT" 2>/dev/null; then
+        echo "    Beende XAseco (PID: ${XASECO_PID_CURRENT})..."
+        kill "$XASECO_PID_CURRENT" 2>/dev/null
+        # Warte max. 10 Sekunden auf sauberes Beenden
+        WAIT_COUNT=0
+        while kill -0 "$XASECO_PID_CURRENT" 2>/dev/null && [ $WAIT_COUNT -lt 10 ]; do
+            sleep 1
+            WAIT_COUNT=$((WAIT_COUNT + 1))
+        done
+        if kill -0 "$XASECO_PID_CURRENT" 2>/dev/null; then
+            echo "    XAseco reagiert nicht, sende SIGKILL..."
+            kill -9 "$XASECO_PID_CURRENT" 2>/dev/null
+        fi
+        echo "    XAseco beendet."
+        rm -f /tmp/xaseco.pid
+    fi
+
+    # 3. TrackmaniaServer beenden
+    if [ -n "${TM_PID:-}" ] && kill -0 "$TM_PID" 2>/dev/null; then
+        echo "    Beende TrackmaniaServer (PID: ${TM_PID})..."
+        kill "$TM_PID" 2>/dev/null
+        # Warte max. 10 Sekunden auf sauberes Beenden
+        WAIT_COUNT=0
+        while kill -0 "$TM_PID" 2>/dev/null && [ $WAIT_COUNT -lt 10 ]; do
+            sleep 1
+            WAIT_COUNT=$((WAIT_COUNT + 1))
+        done
+        if kill -0 "$TM_PID" 2>/dev/null; then
+            echo "    TrackmaniaServer reagiert nicht, sende SIGKILL..."
+            kill -9 "$TM_PID" 2>/dev/null
+        fi
+        echo "    TrackmaniaServer beendet."
+    fi
+
+    # 4. Apache beenden (AdminServ/RemoteCP)
+    echo "    Beende Apache..."
+    service apache2 stop 2>/dev/null
+    echo "    Apache beendet."
+
+    # 5. Log-Rotation beenden
+    if [ -n "${LOGROTATE_PID:-}" ] && kill -0 "$LOGROTATE_PID" 2>/dev/null; then
+        echo "    Beende Log-Rotation (PID: ${LOGROTATE_PID})..."
+        kill "$LOGROTATE_PID" 2>/dev/null
+        wait "$LOGROTATE_PID" 2>/dev/null
+        echo "    Log-Rotation beendet."
+    fi
+
+    echo "============================================================"
+    echo "==> Graceful Shutdown abgeschlossen."
+    echo "============================================================"
+    exit 0
+}
+
+trap graceful_shutdown TERM INT
+echo "==> Signal-Handler registriert (TERM/INT -> Graceful Shutdown)"
+
+# ============================================================
+# Startup-Zusammenfassung
+# ============================================================
+# Gibt am Ende des Startprozesses eine uebersichtliche Box mit
+# allen wichtigen Server-Informationen aus. Die Box-Breite passt
+# sich automatisch an den laengsten Inhalt an.
+# Bei bestehenden Installationen ist dieses Feature nach einem
+# Image-Update automatisch aktiv (keine manuellen Schritte noetig).
+# ============================================================
+print_startup_summary() {
+    _SUMMARY_TMP=$(mktemp /tmp/startup_summary.XXXXXX)
+
+    # Map-Anzahl aus aktiver MatchSettings-Datei zaehlen
+    _ACTIVE_MS_FULL="$GAMEDATA_DIR/Tracks/${GAME_SETTINGS_PATH}"
+    _MAP_COUNT="0"
+    if [ -f "$_ACTIVE_MS_FULL" ]; then
+        _MAP_COUNT=$(grep -c '<challenge>' "$_ACTIVE_MS_FULL" 2>/dev/null)
+        _MAP_COUNT=${_MAP_COUNT:-0}
+    fi
+
+    # MatchSettings-Dateiname extrahieren
+    _MS_FILENAME=$(basename "$GAME_SETTINGS_PATH")
+
+    # XAseco-Status ermitteln
+    if [ "${XASECO_ENABLED:-true}" != "true" ]; then
+        _XASECO_STATUS="Deaktiviert"
+    elif [ -n "${XASECO_PID:-}" ] && kill -0 "$XASECO_PID" 2>/dev/null; then
+        _XASECO_STATUS="Aktiv (PID ${XASECO_PID})"
+    else
+        _XASECO_STATUS="Nicht gestartet"
+    fi
+
+    # Healthcheck-Status ermitteln
+    if [ "${XASECO_ENABLED:-true}" != "true" ]; then
+        _HC_STATUS="—"
+    elif [ "${XASECO_HEALTHCHECK:-true}" = "true" ] && [ -n "${HEALTHCHECK_PID:-}" ]; then
+        _HC_STATUS="Aktiv (PID ${HEALTHCHECK_PID})"
+    elif [ "${XASECO_HEALTHCHECK:-true}" != "true" ]; then
+        _HC_STATUS="Deaktiviert"
+    else
+        _HC_STATUS="Nicht gestartet"
+    fi
+
+    # Forced Mods zaehlen
+    _MOD_COUNT=0
+    for _ENV_NAME in FORCE_MOD_STADIUM FORCE_MOD_ISLAND FORCE_MOD_BAY FORCE_MOD_COAST FORCE_MOD_SPEED FORCE_MOD_ALPINE FORCE_MOD_RALLY; do
+        eval "_MOD_VAL=\${$_ENV_NAME:-}"
+        [ -n "$_MOD_VAL" ] && _MOD_COUNT=$((_MOD_COUNT + 1))
+    done
+    if [ "$_MOD_COUNT" -gt 0 ]; then
+        _MODS_STATUS="${_MOD_COUNT} Mod(s) aktiv"
+    else
+        _MODS_STATUS="Keine"
+    fi
+
+    # Shuffle-Status
+    if [ "${SHUFFLE_MAPLIST:-false}" = "true" ]; then
+        _SHUFFLE_STATUS="Aktiviert"
+    else
+        _SHUFFLE_STATUS="Deaktiviert"
+    fi
+
+    # Server-Modus-Anzeige
+    case "${SERVER_MODE:-internet}" in
+        internet) _MODE_DISPLAY="Internet" ;;
+        lan)      _MODE_DISPLAY="LAN" ;;
+        *)        _MODE_DISPLAY="${SERVER_MODE}" ;;
+    esac
+
+    # PHP-Debug-Status
+    if [ "${PHP_DISPLAY_ERRORS:-false}" = "true" ]; then
+        _PHP_DEBUG="Aktiviert"
+    else
+        _PHP_DEBUG="Deaktiviert"
+    fi
+
+    # Servername aus dedicated_cfg.txt lesen (nicht aus Env-Variable, da diese
+    # nach AdminServ-Aenderungen oder manuellen Edits veraltet sein kann)
+    _SERVER_NAME=""
+    if [ -f "$CONFIG" ]; then
+        # Nur <name> innerhalb von <server_options> lesen (nicht aus <authorization_levels>)
+        _SERVER_NAME=$(php -r '
+            $cfg = file_get_contents($argv[1]);
+            if (preg_match("/<server_options>.*?<name>([^<]*)<\/name>/s", $cfg, $m)) {
+                echo trim($m[1]);
+            }
+        ' "$CONFIG" 2>/dev/null)
+    fi
+    _SERVER_NAME=${_SERVER_NAME:-${SERVER_NAME:-Trackmania Server}}
+
+    # Ladder-Modus aus dedicated_cfg.txt lesen
+    _LADDER_MODE=""
+    if [ -f "$CONFIG" ]; then
+        _LADDER_MODE=$(grep -oP '(?<=<ladder_mode>)[^<]+' "$CONFIG" 2>/dev/null | head -1)
+    fi
+    _LADDER_MODE=${_LADDER_MODE:-${SERVER_LADDER_MODE:-forced}}
+
+    # Max-Players und Max-Spectators aus Config lesen (falls verfuegbar)
+    _MAX_PLAYERS=""
+    _MAX_SPECS=""
+    if [ -f "$CONFIG" ]; then
+        _MAX_PLAYERS=$(grep -oP '(?<=<max_players>)[^<]+' "$CONFIG" 2>/dev/null | head -1)
+        _MAX_SPECS=$(grep -oP '(?<=<max_spectators>)[^<]+' "$CONFIG" 2>/dev/null | head -1)
+    fi
+    _MAX_PLAYERS=${_MAX_PLAYERS:-${SERVER_MAX_PLAYERS:-32}}
+    _MAX_SPECS=${_MAX_SPECS:-${SERVER_MAX_SPECTATORS:-32}}
+
+    # --- Zeilen in Temp-Datei schreiben ('---' = Trennlinie) ---
+    cat > "$_SUMMARY_TMP" <<EOSUMMARY
+TrackMania Nations Forever - Server gestartet
+---
+Servername:     ${_SERVER_NAME}
+Modus:          ${_MODE_DISPLAY} (Ladder: ${_LADDER_MODE})
+Spieler:        max. ${_MAX_PLAYERS} Spieler / ${_MAX_SPECS} Zuschauer
+Server-Port:    ${SERVER_PORT:-2350} (TCP/UDP) | P2P: ${SERVER_P2P_PORT:-3450} (TCP)
+XMLRPC-Port:    ${SERVER_XMLRPC_PORT:-5000}
+---
+MatchSettings:  ${_MS_FILENAME}
+Maps:           ${_MAP_COUNT} Maps geladen
+Map-Shuffle:    ${_SHUFFLE_STATUS}
+---
+XAseco:         ${_XASECO_STATUS}
+Healthcheck:    ${_HC_STATUS}
+Forced Mods:    ${_MODS_STATUS}
+---
+AdminServ:      http://<host-ip>/
+RemoteCP:       http://<host-ip>/remotecp/
+---
+Log-Rotation:   Aktiv (stuendlich, max. 10 MB)
+PHP-Debug:      ${_PHP_DEBUG}
+TM-Server:      PID ${TM_PID}
+EOSUMMARY
+
+    # --- Maximale Zeilenlaenge ermitteln ---
+    _MAX_LEN=0
+    while IFS= read -r _line; do
+        if [ "$_line" != "---" ]; then
+            _cur_len=${#_line}
+            [ "$_cur_len" -gt "$_MAX_LEN" ] && _MAX_LEN=$_cur_len
+        fi
+    done < "$_SUMMARY_TMP"
+
+    # Box-Breite: Inhalt + je 2 Zeichen Padding (links/rechts)
+    _BOX_INNER=$((_MAX_LEN + 4))
+
+    # --- Horizontale Linie erzeugen ---
+    _HLINE=""
+    _i=0
+    while [ "$_i" -lt "$_BOX_INNER" ]; do
+        _HLINE="${_HLINE}═"
+        _i=$((_i + 1))
+    done
+
+    # --- Box ausgeben ---
+    echo ""
+    printf '╔%s╗\n' "$_HLINE"
+
+    _is_title=true
+    while IFS= read -r _line; do
+        if [ "$_line" = "---" ]; then
+            printf '╠%s╣\n' "$_HLINE"
+        elif [ "$_is_title" = "true" ]; then
+            # Titelzeile zentriert ausgeben
+            _title_len=${#_line}
+            _pad_total=$((_MAX_LEN - _title_len))
+            _pad_left=$((_pad_total / 2))
+            _pad_right=$((_pad_total - _pad_left))
+            printf '║  %*s%s%*s  ║\n' "$_pad_left" "" "$_line" "$_pad_right" ""
+            _is_title=false
+        else
+            printf '║  %-*s  ║\n' "$_MAX_LEN" "$_line"
+        fi
+    done < "$_SUMMARY_TMP"
+
+    printf '╚%s╝\n' "$_HLINE"
+    echo ""
+
+    # Aufraeumen
+    rm -f "$_SUMMARY_TMP"
+}
+
+print_startup_summary
+
 # Auf TrackmaniaServer warten (Hauptprozess)
 wait $TM_PID

assets/bin/WatchPublicIP.sh

@@ -0,0 +1,33 @@
+#!/bin/sh
+# Überwacht die ausgehende öffentliche IP des Containers und startet tmserver neu,
+# wenn sich die IP ändert, damit er sich mit der neuen IP beim Masterserver registriert.
+
+set -e
+apk add --no-cache curl docker-cli > /dev/null 2>&1
+set +e
+
+INTERVAL="${IP_WATCHER_INTERVAL:-300}"
+LAST_IP=""
+
+echo "[ip-watcher] Gestartet. Prüfintervall: ${INTERVAL}s"
+
+while true; do
+    CURRENT_IP=$(curl -s --max-time 10 https://api.ipify.org 2>/dev/null)
+
+    if [ -z "$CURRENT_IP" ]; then
+        echo "[ip-watcher] Öffentliche IP konnte nicht ermittelt werden. Neuer Versuch in ${INTERVAL}s."
+    elif [ "$CURRENT_IP" != "$LAST_IP" ]; then
+        if [ -n "$LAST_IP" ]; then
+            echo "[ip-watcher] IP geändert: ${LAST_IP} -> ${CURRENT_IP}. Starte tmserver neu..."
+            docker restart tmserver
+            echo "[ip-watcher] tmserver erfolgreich neu gestartet."
+        else
+            echo "[ip-watcher] Initiale öffentliche IP: ${CURRENT_IP}"
+        fi
+        LAST_IP="$CURRENT_IP"
+    else
+        echo "[ip-watcher] IP-Prüfung OK: ${CURRENT_IP} (unverändert). Nächste Prüfung in ${INTERVAL}s."
+    fi
+
+    sleep "$INTERVAL"
+done

assets/bin/XAsecoHealthcheck.sh

@@ -0,0 +1,186 @@
+#!/bin/sh
+
+# ============================================================
+# XAseco Healthcheck / Watchdog
+# ============================================================
+# Ueberwacht den XAseco-Prozess und startet ihn automatisch
+# neu, wenn er abgestuerzt ist oder die Verbindung zum
+# TrackmaniaServer verloren hat (kein Overlay mehr sichtbar).
+#
+# Pruefungen:
+#   1) PID-Check: Ist der XAseco-PHP-Prozess noch aktiv?
+#   2) XMLRPC-Check: Kann XAseco den TM-Server noch erreichen?
+#      (Erkennt haengende Prozesse, die das Overlay verloren haben)
+#
+# Umgebungsvariablen:
+#   XASECO_HEALTHCHECK          - true/false (Standard: true)
+#   XASECO_HEALTHCHECK_INTERVAL - Pruefintervall in Sekunden (Standard: 60)
+#   SERVER_XMLRPC_PORT          - XMLRPC-Port des TM-Servers (Standard: 5000)
+# ============================================================
+
+XASECO_DIR="/opt/tmserver/xaseco"
+HEALTHCHECK_INTERVAL="${XASECO_HEALTHCHECK_INTERVAL:-60}"
+XMLRPC_PORT="${SERVER_XMLRPC_PORT:-5000}"
+XASECO_PID_FILE="/tmp/xaseco.pid"
+RESTART_COUNT=0
+MAX_CONSECUTIVE_FAILURES=3
+FAILURE_COUNT=0
+
+log() {
+    echo "[XAseco-Healthcheck] $(date '+%Y-%m-%d %H:%M:%S') $1"
+}
+
+# ============================================================
+# XAseco starten und PID speichern
+# ============================================================
+start_xaseco() {
+    cd "$XASECO_DIR"
+    php aseco.php TMN </dev/null >>aseco.log 2>&1 &
+    NEW_PID=$!
+    echo "$NEW_PID" > "$XASECO_PID_FILE"
+    cd /opt/tmserver
+    RESTART_COUNT=$((RESTART_COUNT + 1))
+    FAILURE_COUNT=0
+    log "XAseco gestartet (PID: ${NEW_PID}, Neustart #${RESTART_COUNT})"
+}
+
+# ============================================================
+# Pruefen, ob der XAseco-Prozess noch laeuft
+# ============================================================
+check_pid() {
+    if [ ! -f "$XASECO_PID_FILE" ]; then
+        return 1
+    fi
+    CURRENT_PID=$(cat "$XASECO_PID_FILE")
+    if [ -z "$CURRENT_PID" ]; then
+        return 1
+    fi
+    # Pruefen ob der Prozess existiert und ein PHP-Prozess ist
+    if kill -0 "$CURRENT_PID" 2>/dev/null; then
+        return 0
+    fi
+    return 1
+}
+
+# ============================================================
+# XMLRPC-Verbindungscheck: Pruefen, ob der TM-Server noch
+# erreichbar ist (erkennt verlorene Verbindungen)
+# ============================================================
+check_xmlrpc_connection() {
+    php -r '
+        $port = (int)$argv[1];
+        // Testen ob der XMLRPC-Port noch erreichbar ist
+        $fp = @fsockopen("127.0.0.1", $port, $errno, $errstr, 5);
+        if (!$fp) { exit(1); }
+
+        // Handshake lesen
+        $data = @fread($fp, 4);
+        if (strlen($data) < 4) { fclose($fp); exit(1); }
+        $info = unpack("Vsize", $data);
+        $handshake = @fread($fp, $info["size"]);
+        if (strpos($handshake, "GBXRemote") === false) { fclose($fp); exit(1); }
+
+        fclose($fp);
+        exit(0);
+    ' "$XMLRPC_PORT" 2>/dev/null
+    return $?
+}
+
+# ============================================================
+# XAseco-Log auf aktuelle Fehler pruefen
+# ============================================================
+check_xaseco_log() {
+    LOG_FILE="$XASECO_DIR/aseco.log"
+    if [ ! -f "$LOG_FILE" ]; then
+        return 0
+    fi
+    # Letzte 20 Zeilen auf fatale Fehler / Verbindungsabbrueche pruefen.
+    # Fehlschlaege externer Webdienste (Dedimania, ManiaKarma, ...) laufen ueber
+    # Webaccess/fsockopen und betreffen nicht die Verbindung zum TM-Server.
+    # Ohne Filter loeste das nicht erreichbare dedimania.net alle ~30 Minuten
+    # einen XAseco-Neustart aus.
+    LAST_LINES=$(tail -20 "$LOG_FILE" 2>/dev/null | grep -v -i "webaccess\|fsockopen\|dedimania")
+    # Typische Fehlermeldungen bei XAseco-Verbindungsverlust
+    if echo "$LAST_LINES" | grep -qi "connection refused\|broken pipe\|server not responding\|transport error\|socket error\|fatal error"; then
+        return 1
+    fi
+    return 0
+}
+
+# ============================================================
+# Hauptschleife: Regelmaeige Ueberwachung
+# ============================================================
+log "Watchdog gestartet (Intervall: ${HEALTHCHECK_INTERVAL}s, XMLRPC-Port: ${XMLRPC_PORT})"
+
+while true; do
+    sleep "$HEALTHCHECK_INTERVAL"
+
+    # Pruefen ob der TM-Server selbst noch laeuft
+    if ! check_xmlrpc_connection; then
+        log "XMLRPC-Port ${XMLRPC_PORT} nicht erreichbar - TM-Server vermutlich beendet. Watchdog stoppt."
+        break
+    fi
+
+    NEED_RESTART=false
+    REASON=""
+
+    # 1) PID-Check: Prozess noch aktiv?
+    if ! check_pid; then
+        NEED_RESTART=true
+        REASON="Prozess nicht mehr aktiv (PID: $(cat "$XASECO_PID_FILE" 2>/dev/null || echo 'unbekannt'))"
+    fi
+
+    # 2) Log-Check: Fatale Fehler erkannt?
+    if [ "$NEED_RESTART" = "false" ] && ! check_xaseco_log; then
+        FAILURE_COUNT=$((FAILURE_COUNT + 1))
+        log "WARNUNG: Fehler im XAseco-Log erkannt (${FAILURE_COUNT}/${MAX_CONSECUTIVE_FAILURES})"
+        if [ "$FAILURE_COUNT" -ge "$MAX_CONSECUTIVE_FAILURES" ]; then
+            NEED_RESTART=true
+            REASON="Wiederholte Fehler im Log (${FAILURE_COUNT}x)"
+        fi
+    else
+        # Kein Fehler -> Zaehler zuruecksetzen (nur wenn PID OK)
+        if [ "$NEED_RESTART" = "false" ]; then
+            FAILURE_COUNT=0
+        fi
+    fi
+
+    # Neustart durchfuehren
+    if [ "$NEED_RESTART" = "true" ]; then
+        log "NEUSTART ERFORDERLICH: ${REASON}"
+
+        # Alten Prozess sicherheitshalber beenden
+        OLD_PID=$(cat "$XASECO_PID_FILE" 2>/dev/null)
+        if [ -n "$OLD_PID" ] && kill -0 "$OLD_PID" 2>/dev/null; then
+            log "Beende haengenden Prozess (PID: ${OLD_PID})..."
+            kill "$OLD_PID" 2>/dev/null
+            sleep 3
+            # Falls noch aktiv: SIGKILL
+            if kill -0 "$OLD_PID" 2>/dev/null; then
+                kill -9 "$OLD_PID" 2>/dev/null
+                sleep 1
+            fi
+        fi
+
+        # Log rotieren (altes Log sichern fuer Debugging)
+        if [ -f "$XASECO_DIR/aseco.log" ]; then
+            TIMESTAMP=$(date '+%Y%m%d_%H%M%S')
+            cp "$XASECO_DIR/aseco.log" "$XASECO_DIR/aseco_crash_${TIMESTAMP}.log"
+            log "Crash-Log gesichert: aseco_crash_${TIMESTAMP}.log"
+            # Maximal 5 Crash-Logs aufbewahren
+            ls -t "$XASECO_DIR"/aseco_crash_*.log 2>/dev/null | tail -n +6 | xargs rm -f 2>/dev/null
+        fi
+
+        # Kurz warten, damit evtl. Ressourcen freigegeben werden
+        sleep 2
+
+        # XAseco neu starten
+        start_xaseco
+        log "XAseco erfolgreich neugestartet."
+
+        # Nach Neustart etwas laenger warten, damit XAseco sich initialisieren kann
+        sleep 10
+    fi
+done
+
+log "Watchdog beendet."

assets/config/logrotate.conf

@@ -0,0 +1,69 @@
+# ============================================================
+# Log-Rotation fuer tmserver-docker
+# ============================================================
+# Wird stuendlich per Background-Loop ausgefuehrt.
+# Rotation: groessenbasiert (10 MB), max. 5 rotierte Dateien.
+# ============================================================
+
+# Apache Access- und Error-Log
+/var/log/apache2/access.log
+/var/log/apache2/error.log
+{
+    size 10M
+    rotate 5
+    missingok
+    notifempty
+    compress
+    delaycompress
+    copytruncate
+}
+
+# PHP Error-Log
+/var/log/php_errors.log
+{
+    size 10M
+    rotate 5
+    missingok
+    notifempty
+    compress
+    delaycompress
+    copytruncate
+}
+
+# XAseco-Log (liegt im persistenten Volume)
+/opt/tmserver/xaseco/aseco.log
+{
+    size 10M
+    rotate 5
+    missingok
+    notifempty
+    compress
+    delaycompress
+    copytruncate
+}
+
+# RemoteCP-Logs (liegen im persistenten Volume)
+/var/www/html/remotecp/cache/*.log
+{
+    su www-data www-data
+    size 10M
+    rotate 5
+    missingok
+    notifempty
+    compress
+    delaycompress
+    copytruncate
+}
+
+# AdminServ-Logs (liegen im persistenten Volume)
+/var/www/html/logs/*.log
+{
+    su www-data www-data
+    size 10M
+    rotate 5
+    missingok
+    notifempty
+    compress
+    delaycompress
+    copytruncate
+}

docker-compose.yml

@@ -1,10 +1,11 @@
 services:
   tmserver:
-    image: git.techniverse.net/scriptos/trackmania-server:1.2.1
+    image: git.techniverse.net/scriptos/trackmania-server:1.4.0
     build:
       context: .
     container_name: tmserver
     restart: unless-stopped
+    stop_grace_period: 30s
     depends_on:
       mariadb:
         condition: service_healthy
@@ -12,16 +13,19 @@ services:
       - "${SERVER_PORT:-2350}:${SERVER_PORT:-2350}/tcp"
       - "${SERVER_PORT:-2350}:${SERVER_PORT:-2350}/udp"
       - "${SERVER_P2P_PORT:-3450}:${SERVER_P2P_PORT:-3450}/tcp"
-      - "80:80/tcp"
+      - "16080:80/tcp"
+      - "3450:3450/udp"
     env_file:
       - .env
+    dns:
+      - 1.1.1.1
     volumes:
       - ./data/gamedata:/opt/tmserver/GameData
       - ./data/controlpanel:/var/www/html
       - ./data/xaseco:/opt/tmserver/xaseco
     networks:
       tmserver_net:
-        ipv4_address: 172.20.60.10
+        ipv4_address: 172.20.72.10
 
   mariadb:
     image: mariadb:11.4
@@ -50,7 +54,23 @@ services:
       start_period: 30s
     networks:
       tmserver_net:
-        ipv4_address: 172.20.60.11
+        ipv4_address: 172.20.72.11
+
+  ip-watcher:
+    image: alpine:3.24
+    container_name: tmserver-ip-watcher
+    restart: unless-stopped
+    depends_on:
+      - tmserver
+    command: ["/bin/sh", "/opt/WatchPublicIP.sh"]
+    env_file:
+      - .env
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock
+      - ./assets/bin/WatchPublicIP.sh:/opt/WatchPublicIP.sh:ro
+    networks:
+      tmserver_net:
+        ipv4_address: 172.20.72.12
 
 networks:
   tmserver_net:
@@ -58,6 +78,6 @@ networks:
     driver: bridge
     ipam:
       config:
-        - subnet: 172.20.60.0/25
+        - subnet: 172.20.72.0/25
-          gateway: 172.20.60.1
+          gateway: 172.20.72.1
-          ip_range: 172.20.60.64/26
+          ip_range: 172.20.72.64/26

docs/README.md

@@ -9,40 +9,57 @@
 | Dokument | Beschreibung |
 |----------|-------------|
 | [Schnellstart](schnellstart.md) | Erste Schritte und minimale Konfiguration |
-| [Konfiguration](konfiguration.md) | Persistente Serverkonfiguration (dedicated_cfg.txt) |
+| [Konfiguration](konfiguration.md) | Persistente Serverkonfiguration (dedicated_cfg.txt), Graceful Shutdown |
 | [Umgebungsvariablen](umgebungsvariablen.md) | Alle verfügbaren Umgebungsvariablen |
 | [Server-Modi](server-modi.md) | LAN- und Internet-Dedicated-Modus |
 | [AdminServ](adminserv.md) | Einrichtung der Server-Verwaltungsoberfläche |
 | [RemoteCP](remotecp.md) | Alternative Server-Verwaltungsoberfläche (inkl. Mods/Skins) |
 | [XAseco](xaseco.md) | Server-Controller für Rekorde, Karma und Jukebox |
+| [IP-Watcher](ip-watcher.md) | Automatischer Neustart bei IP-Wechsel |
 | [Ports](ports.md) | Freigegebene Ports und deren Verwendung |
+| [Update](update.md) | Bestehende Installation aktualisieren |
 
 ## Projektstruktur
 
 ```
 ├── assets/
 │   ├── bin/                                     # Binaries und Startscript
-│   │   ├── AdminServ_v2.1.1.zip                # AdminServ Web-UI
+│   │   ├── AdminServ_v2.1.1.zip                 # AdminServ Web-UI
-│   │   ├── remoteCP_v4.0.3.5.zip               # RemoteCP Web-UI
+│   │   ├── remoteCP_v4.0.3.5.zip                # RemoteCP Web-UI
-│   │   ├── xaseco_v1.16.zip                     # XAseco Server-Controller
 │   │   ├── RunTrackmaniaServer.sh               # Container-Startscript
-│   │   └── TrackmaniaServer_*.zip               # Trackmania Server Binary
+│   │   ├── TrackmaniaServer_2011-02-21.zip      # Trackmania Server Binary
+│   │   ├── WatchPublicIP.sh                     # IP-Watcher-Script
+│   │   └── xaseco_v1.16.zip                     # XAseco Server-Controller
 │   ├── config/
+│   │   ├── adminserv/                           # AdminServ-Konfiguration
+│   │   │   ├── get_matchset_mapimport.php       # MatchSet Map-Import Script
+│   │   │   └── maps-creatematchset.php          # MatchSet-Erstellung Script
 │   │   ├── custom_game_settings.txt             # MatchSettings (Spielmodus, Map-Rotation)
 │   │   ├── dedicated_cfg.txt                    # Server-Config-Template (mit Platzhaltern)
-│   │   └── remotecp/
+│   │   ├── logrotate.conf                       # Log-Rotation-Konfiguration (groessenbasiert)
-│   │       └── plugins/
+│   │   ├── remotecp/
-│   │           ├── CustomPoints/
+│   │   │   └── plugins/
-│   │           │   └── index.php                # CustomPoints-Plugin fuer RemoteCP
+│   │   │       ├── CustomPoints/
-│   │           └── Mods/
+│   │   │       │   └── index.php                # CustomPoints-Plugin fuer RemoteCP
-│   │               └── settings.xml             # Skin-Bibliothek (techniverse.net)
+│   │   │       └── Mods/
+│   │   │           ├── index.php                # Mods-Plugin fuer RemoteCP
+│   │   │           └── settings.xml             # Skin-Bibliothek (techniverse.net)
+│   │   └── xaseco/
+│   │       └── teamspeak3.xml                   # TeamSpeak3-Konfiguration fuer XAseco
 │   └── db/
 │       └── init-xaseco-db.sh                    # MariaDB Init-Script fuer XAseco-DB
-├── docs/                                        # Dokumentation
+├── .gitea/
+│   └── workflows/
+│       └── docker-publish.yml                  # CI/CD: Docker Image Build & Push bei neuem Release-Tag
+├── docs/                                        # Dokumentation (siehe Tabelle oben)
+│   └── update.md                                    # Update-Anleitung
 ├── docker-compose.yml                           # Docker Compose Konfiguration
 ├── Dockerfile                                   # Docker Build-Definition
+├── .dockerignore                                # Docker-Ignore-Regeln
 ├── .env.example                                 # Vorlage fuer Umgebungsvariablen
 ├── .env                                         # Lokale Umgebungsvariablen (nicht im Git!)
+├── .gitattributes                               # Git-Attribut-Konfiguration
+├── .gitignore                                   # Git-Ignore-Regeln
 ├── LICENSE                                      # Lizenz
 ├── README.md                                    # Projektbeschreibung
 └── data/                                        # Persistente Daten (zur Laufzeit)

docs/adminserv.md

@@ -4,17 +4,19 @@ Die Server-Verwaltungsoberfläche basiert auf [AdminServ](https://github.com/Chr
 
 ## Einrichtung
 
-1. `http://<host-server-des-containers>` im Browser aufrufen
+AdminServ wird beim ersten Container-Start **vollständig automatisch konfiguriert**:
-2. Ein Passwort festlegen – dieses wird als AdminServ-Passwort verwendet
+
-3. TM-Server-Informationen eintragen (Standardwerte können beibehalten werden)
+- Serververbindung (Adresse `127.0.0.1`, XML-RPC-Port)
-4. `Address` auf `localhost` setzen, um den eingebetteten Server zu verwalten
+- Server-Eintrag (Name, DisplayServ-Passwort)
-5. Speichern
+- Konfigurationspasswort (siehe [Konfigurationsseite (`/config`)](#konfigurationsseite-config))
+
+Es ist kein manuelles Setup nötig.
 
 ## Verbindung zum Server
 
-1. Über den Button „Servers" zur Serverliste navigieren
+1. `http://<host-server-des-containers>` im Browser aufrufen
-2. Den gewünschten Server auswählen
+2. Den Server aus der Liste auswählen
-3. Admin-Stufe wählen und zugehöriges Passwort eingeben
+3. Admin-Stufe wählen (SuperAdmin, Admin oder User) und das zugehörige Passwort eingeben
 
 ## Standard-Passwörter
 
@@ -24,9 +26,11 @@ Die Server-Verwaltungsoberfläche basiert auf [AdminServ](https://github.com/Chr
 | Admin | `Admin` |
 | User | `User` |
 
+Diese Passwörter werden über die `.env`-Datei gesetzt (`SERVER_SA_PASSWORD`, `SERVER_ADM_PASSWORD`, `SERVER_USER_PASSWORD`) und beim ersten Start in die `dedicated_cfg.txt` geschrieben. AdminServ liest die Passwörter über die XML-RPC-Verbindung direkt vom TM-Server.
+
 Die Admin-Stufen können unter `http://<host-server-des-containers>/config` geändert werden.
 
-> **Hinweis:** Es wird empfohlen, die Standard-Passwörter über die `.env`-Datei (`SERVER_SA_PASSWORD`, `SERVER_ADM_PASSWORD`) zu ändern. Siehe [Umgebungsvariablen](umgebungsvariablen.md).
+> **Hinweis:** Die Standard-Passwörter in der `.env.example` sind öffentlich einsehbar. Ändere sie unbedingt, bevor du den Server produktiv einsetzt. Siehe [Umgebungsvariablen](umgebungsvariablen.md).
 
 ## Persistente Speicherung
 
@@ -55,6 +59,8 @@ Alternativ können die PHP-Logs eingesehen werden:
 docker exec tmserver cat /var/log/php_errors.log
 ```
 
+> **Hinweis:** Alle Logs (Apache, PHP, AdminServ) werden automatisch per logrotate rotiert (max. 10 MB pro Datei, 5 rotierte Dateien). Siehe [Konfiguration – Log-Rotation](konfiguration.md#log-rotation).
+
 ### AdminServ komplett zurücksetzen
 
 Falls AdminServ in einen inkonsistenten Zustand geraten ist:
@@ -67,6 +73,16 @@ rm -rf ./data/controlpanel/*
 docker compose up -d
 ```
 
+## Konfigurationsseite (`/config`)
+
+AdminServ bringt unter `http://<host-ip>/config` eine eigene Konfigurationsseite mit, über die Server-Einträge hinzugefügt, geändert oder gelöscht werden können. Diese Seite ist durch ein separates Passwort geschützt (`OnlineConfig::PASSWORD` in `adminserv.cfg.php`, MD5-gehasht).
+
+Da dieser Container als **Standalone-Setup** läuft und ausschließlich den einen lokalen TrackMania-Server bedient, wird die `/config`-Seite **nicht benötigt** – der Server-Eintrag wird beim ersten Start automatisch angelegt (Adresse, XML-RPC-Port, Passwörter).
+
+Zur Absicherung wird das Konfigurationspasswort beim ersten Container-Start automatisch durch einen **zufällig generierten MD5-Hash** ersetzt. Damit ist die `/config`-Seite vor unbefugtem Zugriff geschützt, ohne dass ein Benutzer ein Passwort vergeben oder sich merken muss.
+
+> **Hinweis:** Falls du dennoch Zugriff auf die `/config`-Seite benötigst (z.B. für Debugging), kannst du den MD5-Hash in `data/controlpanel/config/adminserv.cfg.php` manuell auf ein bekanntes Passwort setzen. Beispiel: `const PASSWORD = '5f4dcc3b5aa765d61d8327deb882cf99';` entspricht dem Passwort `password`.
+
 ## Gepatchte AdminServ-Bugs (TmForever)
 
 AdminServ (v2.1.1) enthält zwei Bugs, die speziell im Zusammenspiel mit TmForever auftreten. Diese werden beim Container-Start automatisch gepatcht – auch bei bestehenden Volumes.

docs/ip-watcher.md

@@ -0,0 +1,36 @@
+# IP-Watcher
+
+Der IP-Watcher ist ein Service (`tmserver-ip-watcher`), der automatisch die öffentliche IP des Hosts überwacht und den `tmserver`-Container neu startet, sobald sich die IP ändert.
+
+## Hintergrund
+
+Trackmania-Server registrieren sich beim Start mit ihrer aktuellen öffentlichen IP beim Nadeo-Masterserver. Bei dynamischen IP-Adressen kann sich diese IP jederzeit ändern – der Server bleibt dann unter der veralteten IP registriert und ist für Spieler nicht mehr erreichbar.
+
+Der IP-Watcher erkennt solche IP-Wechsel automatisch und startet `tmserver` neu, sodass er sich mit der neuen IP beim Masterserver neu registriert.
+
+## Funktion
+
+Der Watcher läuft als eigener Docker-Container und:
+
+1. Prüft regelmäßig die ausgehende öffentliche IP (identisch mit der IP, die auch `tmserver` nach außen verwendet)
+2. Erkennt Abweichungen zur zuletzt bekannten IP
+3. Startet `tmserver` über den Docker-Socket automatisch neu
+
+## Konfiguration
+
+| Variable | Beschreibung | Standard |
+|----------|-------------|----------|
+| `IP_WATCHER_INTERVAL` | Prüfintervall in Sekunden | `300` (5 Minuten) |
+
+## Deaktivieren
+
+Um den IP-Watcher zu deaktivieren, kommentiere den `ip-watcher`-Service in der `docker-compose.yml` aus:
+
+```yaml
+# ip-watcher:
+#   ...
+```
+
+## Sicherheitshinweis
+
+Der IP-Watcher benötigt Zugriff auf den Docker-Socket (`/var/run/docker.sock`), um den `tmserver`-Container neu starten zu können. Dieser Zugriff ermöglicht volle Kontrolle über alle Docker-Container und -Images auf dem Host. Stelle sicher, dass der Host ausreichend abgesichert ist und der Zugriff auf den Docker-Socket auf vertrauenswürdige Dienste beschränkt bleibt.

docs/konfiguration.md

@@ -18,6 +18,7 @@ Das gesamte **GameData-Verzeichnis** wird über ein Bind-Mount (`./data/gamedata
 |-----------|----------------|-------------|
 | `./data/gamedata` | `/opt/tmserver/GameData` | Gesamtes GameData-Verzeichnis |
 | `./data/controlpanel` | `/var/www/html` | AdminServ- und RemoteCP-Daten |
+| `./data/xaseco` | `/opt/tmserver/xaseco` | XAseco-Konfiguration und Logs |
 | `./data/mariadb` | `/var/lib/mysql` | MariaDB-Datenbankdateien |
 
 ### Enthaltene Unterordner
@@ -105,6 +106,105 @@ Der Ordner `GameData/Config/` enthält:
 | `Default.SystemConfig.Gbx` | System-Konfiguration |
 | `AdminServ/ServerOptions/` | Von AdminServ exportierte Server-Einstellungen |
 
+## Graceful Shutdown
+
+Beim Stoppen des Containers (`docker compose stop`, `docker compose down` oder `docker stop`) werden alle Dienste **sauber und in der richtigen Reihenfolge** heruntergefahren:
+
+1. **XAseco-Healthcheck** – wird zuerst beendet, damit XAseco nicht während des Shutdowns neu gestartet wird
+2. **XAseco** – beendet sich ordentlich und schließt alle Datenbank-Connections (verhindert DB-Korruption)
+3. **TrackmaniaServer** – der Spielserver wird sauber gestoppt
+4. **Apache** – AdminServ und RemoteCP werden beendet
+5. **Log-Rotation** – Hintergrundprozess wird gestoppt
+
+Jeder Dienst hat maximal 10 Sekunden Zeit, sich sauber zu beenden. Falls ein Prozess nicht reagiert, wird er zwangsweise beendet (SIGKILL). Die `stop_grace_period` in der `docker-compose.yml` ist auf 30 Sekunden gesetzt, um genügend Zeit für den gesamten Shutdown-Prozess zu geben.
+
+Der Shutdown-Fortschritt wird in der Konsole protokolliert und kann mit `docker logs tmserver` nachvollzogen werden.
+
+> **Hinweis:** Der Graceful Shutdown ist nach einem Image-Update automatisch aktiv – auch bei bestehenden Installationen. Es sind keine manuellen Schritte nötig.
+
+## Log-Rotation
+
+Alle Log-Dateien im Container werden automatisch per `logrotate` rotiert, damit sie nicht unbegrenzt wachsen. Die Rotation läuft **größenbasiert** als Hintergrundprozess (stündliche Prüfung, kein Cron nötig).
+
+### Einstellungen
+
+| Parameter | Wert |
+|-----------|------|
+| Maximale Dateigröße | 10 MB |
+| Rotierte Dateien behalten | 5 |
+| Komprimierung | Ja (gzip, verzögert) |
+| Leere Logs überspringen | Ja |
+
+### Rotierte Log-Dateien
+
+| Log | Pfad im Container | Persistenz |
+|-----|--------------------|------------|
+| Apache Access | `/var/log/apache2/access.log` | Nur im Container |
+| Apache Error | `/var/log/apache2/error.log` | Nur im Container |
+| PHP Errors | `/var/log/php_errors.log` | Nur im Container |
+| XAseco | `/opt/tmserver/xaseco/aseco.log` | Volume (`./data/xaseco/`) |
+| AdminServ | `/var/www/html/logs/*.log` | Volume (`./data/controlpanel/logs/`) |
+
+Rotierte Dateien werden als `*.1` (vorherige), `*.2.gz`, `*.3.gz` usw. aufbewahrt.
+
+### Konfigurationsdatei
+
+Die logrotate-Konfiguration liegt im Image unter `/etc/logrotate.d/tmserver` (Quelle: `assets/config/logrotate.conf`). Sie wird beim Bau des Images fest eingebettet und erfordert keine manuelle Anpassung.
+
+> **Hinweis:** Die Log-Rotation ist nach einem Image-Update automatisch aktiv – auch bei bestehenden Installationen. Es sind keine manuellen Schritte nötig.
+
+## Startup-Zusammenfassung
+
+Nach Abschluss des gesamten Startprozesses wird automatisch eine übersichtliche Zusammenfassung aller wichtigen Server-Informationen als formatierte Box in der Konsole ausgegeben. Die Box-Breite passt sich dynamisch an den längsten Inhalt an.
+
+Alle angezeigten Werte (Servername, Spielerzahl, Ladder-Modus etc.) werden direkt aus der `dedicated_cfg.txt` gelesen – nicht aus den Umgebungsvariablen. So werden auch nachträgliche Änderungen (z.B. über AdminServ oder manuelles Editieren) korrekt angezeigt.
+
+**Angezeigte Informationen:**
+
+| Bereich | Details | Quelle |
+|---------|---------|--------|
+| **Server** | Servername, Modus (Internet/LAN), Ladder, Spieler-/Zuschauerlimit | `dedicated_cfg.txt` |
+| **Netzwerk** | Server-Port, P2P-Port, XMLRPC-Port | Umgebungsvariablen |
+| **Maps** | Aktive MatchSettings-Datei, Anzahl geladener Maps, Shuffle-Status | MatchSettings-XML |
+| **Dienste** | XAseco-Status (mit PID), Healthcheck, Forced Mods | Laufzeit-PIDs |
+| **Web-Interfaces** | AdminServ- und RemoteCP-URLs | Platzhalter |
+| **System** | Log-Rotation, PHP-Debug-Modus, TM-Server-PID | Laufzeit |
+
+**Beispielausgabe:**
+
+```
+╔════════════════════════════════════════════════════════════════════╗
+║       TrackMania Nations Forever - Server gestartet               ║
+╠════════════════════════════════════════════════════════════════════╣
+║  Servername:     Mein Trackmania Server                           ║
+║  Modus:          Internet (Ladder: forced)                        ║
+║  Spieler:        max. 32 Spieler / 32 Zuschauer                   ║
+║  Server-Port:    2350 (TCP/UDP) | P2P: 3450 (TCP)                 ║
+║  XMLRPC-Port:    5000                                              ║
+╠════════════════════════════════════════════════════════════════════╣
+║  MatchSettings:  custom_game_settings.txt                          ║
+║  Maps:           24 Maps geladen                                   ║
+║  Map-Shuffle:    Deaktiviert                                       ║
+╠════════════════════════════════════════════════════════════════════╣
+║  XAseco:         Aktiv (PID 1234)                                  ║
+║  Healthcheck:    Aktiv (PID 5678)                                  ║
+║  Forced Mods:    Keine                                             ║
+╠════════════════════════════════════════════════════════════════════╣
+║  AdminServ:      http://<host-ip>/                                 ║
+║  RemoteCP:       http://<host-ip>/remotecp/                        ║
+╠════════════════════════════════════════════════════════════════════╣
+║  Log-Rotation:   Aktiv (stuendlich, max. 10 MB)                   ║
+║  PHP-Debug:      Deaktiviert                                       ║
+║  TM-Server:      PID 42                                            ║
+╚════════════════════════════════════════════════════════════════════╝
+```
+
+Die Zusammenfassung kann jederzeit mit `docker logs tmserver` erneut eingesehen werden.
+
+> **Hinweis:** `<host-ip>` ist ein Platzhalter – ersetze ihn durch die tatsächliche IP oder Domain deines Hosts (z.B. `http://192.168.1.100/`).
+
+> **Hinweis:** Die Startup-Zusammenfassung ist nach einem Image-Update automatisch aktiv – auch bei bestehenden Installationen. Es sind keine manuellen Schritte nötig.
+
 ## AdminServ ServerOptions-Import
 
 Wenn über AdminServ Änderungen an den Server-Optionen vorgenommen und als Export gespeichert werden (z.B. Servername, Beschreibung, Spielerzahl), werden diese beim nächsten Container-Start **automatisch** in die `dedicated_cfg.txt` übernommen.

docs/remotecp.md

@@ -165,6 +165,6 @@ Falls RemoteCP nicht erreichbar ist oder Fehler anzeigt:
 
 ### Bekannte Hinweise
 
-- RemoteCP ist ein älteres Tool (Version 4.0.3.5) und wurde für PHP 5.x entwickelt, läuft aber mit PHP 7.4
+- RemoteCP ist ein älteres Tool (Version 4.0.3.5) und wurde für PHP 5.x entwickelt. Ab v1.4.0 läuft es dank automatischer Kompatibilitäts-Patches beim Containerstart unter PHP 8.4 (siehe README)
 - Die Live-Funktionen (`remoteCP[Live]`) benötigen eine laufende Serververbindung
 - **Sicherheitshinweis:** Die Registrierung neuer Benutzer ist standardmäßig aktiviert. Aus Sicherheitsgründen sollte diese deaktiviert werden, damit sich keine unbefugten Nutzer einen Zugang anlegen können. Dazu in der Datei `data/controlpanel/remotecp/xml/settings/settings.xml` den Wert `<register>false</register>` setzen

docs/schnellstart.md

@@ -43,11 +43,9 @@ Die Konfiguration erfolgt über die `.env`-Datei, die automatisch eingelesen wir
 Alternativ kannst du das Image auch selbst bauen:
 
 ```bash
-docker build -t tmserver:latest -t tmserver:1.1.1 .
+docker build -t tmserver:latest .
 ```
 
-Damit wird das Image mit zwei Tags erstellt: `tmserver:latest` und `tmserver:1.1.1`.
-
 Anschließend den Server starten:
 
 ```bash

docs/umgebungsvariablen.md

@@ -73,6 +73,7 @@ nano .env
 |----------|-------------|----------|
 | `MATCHSETTINGS_FILE` | MatchSettings-Datei beim Serverstart: `auto` = neueste `.txt`-Datei im Ordner wird automatisch geladen, oder ein expliziter Dateiname (z.B. `meine_settings.txt`) | `auto` |
 | `ALLWARMUPDURATION` | Warmup-Dauer für alle Runden (`0` = deaktiviert, `1` = eine Runde Warmup) | `0` |
+| `SHUFFLE_MAPLIST` | Map-Reihenfolge beim Containerstart zufällig mischen (`true` = aktiviert, `false` = deaktiviert) | `false` |
 
 ### Automatische MatchSettings-Erkennung
 
@@ -90,6 +91,27 @@ MATCHSETTINGS_FILE=turnier_settings.txt
 
 > **Hinweis:** Falls die angegebene oder automatisch ermittelte Datei nicht existiert, wird auf `custom_game_settings.txt` zurückgefallen. Die aktiv geladene Datei wird beim Serverstart in der Konsole ausgegeben.
 
+### Map-Shuffle
+
+Mit `SHUFFLE_MAPLIST=true` wird die Reihenfolge aller Maps in der aktiven MatchSettings-Datei beim **jedem Containerstart** zufällig durchgemischt. So startet der Server jedes Mal mit einer anderen Map, statt immer bei Map #1 zu beginnen.
+
+- Die `<challenge>`-Einträge in der MatchSettings-XML werden zufällig neu angeordnet
+- Der `<startindex>` wird automatisch auf `0` gesetzt
+- Die aktive MatchSettings-Datei wird dabei direkt überschrieben
+- Die ersten 3 Maps der neuen Reihenfolge werden beim Start in der Konsole angezeigt
+
+**Beispiel:**
+
+```bash
+# Map-Reihenfolge bei jedem Start mischen
+SHUFFLE_MAPLIST=true
+
+# Deaktiviert (Standard) – Reihenfolge bleibt wie in der Datei
+SHUFFLE_MAPLIST=false
+```
+
+> **Hinweis:** Der Shuffle wird auf die MatchSettings-Datei angewendet, die durch `MATCHSETTINGS_FILE` bestimmt wird (entweder automatisch oder explizit). Die Änderung ist persistent – die Datei wird tatsächlich umgeschrieben. Bei jedem Neustart wird erneut gemischt.
+
 ## RemoteCP
 
 RemoteCP verwendet die SuperAdmin-Zugangsdaten (`SERVER_SA_PASSWORD`) des TM-Servers für den Web-Login. Es werden keine separaten Login-Variablen benötigt.
@@ -161,9 +183,19 @@ XAseco ist ein Server-Controller für Rekorde, Karma, Jukebox und mehr. Siehe [X
 | `XASECO_DB_USER` | Datenbank-Benutzername | `xaseco` |
 | `XASECO_DB_PASSWORD` | Datenbank-Passwort | *(muss gesetzt werden)* |
 | `XASECO_DEDIMANIA_NATION` | Dedimania-Nation (IOC-Code) | `DEU` |
+| `XASECO_HEALTHCHECK` | Automatische Überwachung und Neustart von XAseco bei Absturz/Verbindungsverlust | `true` |
+| `XASECO_HEALTHCHECK_INTERVAL` | Prüfintervall des Healthchecks in Sekunden | `60` |
 
 > **Hinweis:** Die Server-Zugangsdaten (`SERVER_SA_PASSWORD`, `SERVER_XMLRPC_PORT`) und Dedimania-Daten (`SERVER_LOGIN`, `SERVER_LOGIN_PASSWORD`) werden automatisch aus der bestehenden Konfiguration übernommen.
 
+## IP-Watcher
+
+| Variable | Beschreibung | Standard |
+|----------|-------------|----------|
+| `IP_WATCHER_INTERVAL` | Prüfintervall in Sekunden, in dem die öffentliche IP geprüft wird | `300` |
+
+> **Hinweis:** Der IP-Watcher verwendet den Docker-Socket (`/var/run/docker.sock`), um `tmserver` bei einer IP-Änderung automatisch neu zu starten. Weitere Details unter [IP-Watcher](ip-watcher.md).
+
 ## Debugging
 
 | Variable | Beschreibung | Standard |

docs/update.md

@@ -0,0 +1,105 @@
+# Update-Anleitung
+
+Diese Anleitung beschreibt, wie du eine **bestehende Installation** auf den neuesten Stand bringst – ohne Daten zu verlieren und ohne alles neu aufsetzen zu müssen.
+
+> **Hinweis:** Alle persistenten Daten (Konfiguration, Tracks, Datenbanken, Logs) liegen im Ordner `./data/` und werden bei einem Update nicht berührt.
+
+---
+
+## 1. Repository aktualisieren
+
+Wechsle in den Projektordner und lade die neuesten Änderungen:
+
+```bash
+git pull
+```
+
+Damit werden aktualisierte Konfigurationsdateien, Skripte und Dokumentation aus dem Repository übernommen.
+
+---
+
+## 2. Neue Umgebungsvariablen prüfen
+
+Mit neuen Versionen können neue Variablen in der `.env.example` hinzugekommen sein. Deine persönliche `.env`-Datei wird dabei **nicht überschrieben** – du musst neue Variablen manuell nachtragen.
+
+Vergleiche `.env.example` mit deiner `.env`, um fehlende Einträge zu finden:
+
+```bash
+diff .env.example .env
+```
+
+Zeilen, die in `.env.example` vorhanden sind, aber nicht in deiner `.env`, erscheinen mit `<` am Anfang. Diese solltest du in deine `.env` übernehmen und die Werte anpassen.
+
+> **Tipp:** Neue Variablen haben in der Regel sinnvolle Standardwerte, die du oft einfach übernehmen kannst. Achte nur auf sicherheitsrelevante Werte wie Passwörter.
+
+---
+
+## 3. Docker Image aktualisieren
+
+Lade das neueste Image aus der Registry:
+
+```bash
+docker compose pull
+```
+
+---
+
+## 4. Container neu starten
+
+Starte die Container mit dem neuen Image neu. Docker Compose erkennt automatisch, ob ein Rebuild nötig ist:
+
+```bash
+docker compose up -d
+```
+
+> **Hinweis:** Wenn sich die `docker-compose.yml` geändert hat (z.B. neue Services oder geänderte Konfiguration), werden betroffene Container automatisch neu erstellt. Deine Daten in `./data/` bleiben dabei vollständig erhalten.
+
+---
+
+## Zusammenfassung
+
+```bash
+# Im Projektordner ausführen:
+git pull
+docker compose pull
+docker compose up -d
+```
+
+Das war's – der Server läuft jetzt auf dem neuesten Stand.
+
+---
+
+## Was passiert mit meinen Daten?
+
+| Ordner | Inhalt | Beim Update |
+|--------|--------|-------------|
+| `./data/gamedata/` | TM-Server-Daten, Konfiguration, Tracks | Bleibt erhalten |
+| `./data/controlpanel/` | AdminServ- und RemoteCP-Daten | Bleibt erhalten |
+| `./data/xaseco/` | XAseco-Konfiguration und Logs | Bleibt erhalten |
+| `./data/mariadb/` | Datenbankdateien | Bleibt erhalten |
+| `.env` | Deine Umgebungsvariablen | Wird nicht überschrieben |
+
+---
+
+## Häufige Situationen
+
+### Neue Umgebungsvariable hat keinen Effekt
+
+Einige Variablen (z.B. `SERVER_SA_PASSWORD`) werden nur beim **ersten Start** in die `dedicated_cfg.txt` geschrieben. Falls du eine neue Variable nachträglich setzen möchtest, kannst du das erzwingen:
+
+```bash
+# In der .env setzen:
+FORCE_CONFIG_UPDATE=true
+```
+
+Dann Container neu starten. Danach unbedingt wieder auf `false` setzen, damit manuelle Änderungen erhalten bleiben. Weitere Details unter [Konfiguration](konfiguration.md).
+
+### Welches Image-Tag wird verwendet?
+
+In der `docker-compose.yml` ist das Image-Tag angegeben (z.B. `1.3.2` oder `latest`). Du kannst auf `latest` umstellen, um immer automatisch das neueste Image zu bekommen:
+
+```yaml
+image: git.techniverse.net/scriptos/trackmania-server:latest
+```
+
+Alle verfügbaren Tags findest du in der [Container-Registry](https://git.techniverse.net/scriptos/-/packages/container/trackmania-server/).

docs/xaseco.md

@@ -2,7 +2,7 @@
 
 XAseco ist ein Server-Controller für TrackMania Nations Forever. Er verwaltet lokale Rekorde, Dedimania-Weltrekorde, Karma/Votes, eine Track-Jukebox und vieles mehr direkt im Spielchat.
 
-Im Container wird die modifizierte Version **XAseco 1.16** verwendet, die für PHP 7.x angepasst wurde (Patches von Bueddel, Xymph, undef.de und reaby).
+Im Container wird die modifizierte Version **XAseco 1.16** verwendet, die für PHP 7.x angepasst wurde (Patches von Bueddel, Xymph, undef.de und reaby). Ab v1.4.0 wird sie beim Containerstart zusätzlich automatisch für PHP 8.4 gepatcht (siehe README).
 
 ## Funktionsweise
 
@@ -77,6 +77,8 @@ Die Konfiguration erfolgt ausschließlich über Umgebungsvariablen in der `.env`
 | `XASECO_DB_NAME` | Name der XAseco-Datenbank | `xaseco` |
 | `XASECO_DB_USER` | Datenbank-Benutzername | `xaseco` |
 | `XASECO_DEDIMANIA_NATION` | Dedimania-Nation ([IOC-Code](https://en.wikipedia.org/wiki/List_of_IOC_country_codes), z.B. `DEU`, `AUT`, `CHE`) | `DEU` |
+| `XASECO_HEALTHCHECK` | Automatische Überwachung und Neustart bei Absturz | `true` |
+| `XASECO_HEALTHCHECK_INTERVAL` | Prüfintervall des Healthchecks in Sekunden | `60` |
 
 ### Automatisch übernommene Variablen
 
@@ -147,6 +149,37 @@ XASECO_ENABLED=false
 
 Der TrackMania-Server läuft dann ohne Server-Controller.
 
+## Healthcheck / Watchdog
+
+XAseco wird automatisch durch einen Watchdog-Prozess überwacht. Dieser erkennt Abstürze und verlorene Verbindungen (z.B. wenn das Overlay im Spiel verschwindet) und startet XAseco selbstständig neu.
+
+### Funktionsweise
+
+Der Watchdog prüft regelmäßig (Standard: alle 60 Sekunden):
+
+1. **PID-Check:** Läuft der XAseco-PHP-Prozess noch?
+2. **Log-Check:** Enthält das XAseco-Log fatale Fehler oder Verbindungsabbrüche?
+3. **XMLRPC-Check:** Ist der TM-Server noch erreichbar?
+
+Bei erkannten Problemen wird XAseco automatisch beendet und neu gestartet. Crash-Logs werden zur Fehleranalyse unter `data/xaseco/aseco_crash_<TIMESTAMP>.log` gesichert (max. 5 Dateien).
+
+### Konfiguration
+
+| Variable | Beschreibung | Standard |
+|----------|-------------|----------|
+| `XASECO_HEALTHCHECK` | Watchdog aktivieren/deaktivieren | `true` |
+| `XASECO_HEALTHCHECK_INTERVAL` | Prüfintervall in Sekunden | `60` |
+
+```env
+# Healthcheck deaktivieren
+XASECO_HEALTHCHECK=false
+
+# Prüfintervall auf 30 Sekunden verkürzen
+XASECO_HEALTHCHECK_INTERVAL=30
+```
+
+> **Hinweis:** Der Watchdog ist standardmäßig aktiviert und erfordert keine zusätzliche Konfiguration. Bei bestehenden Installationen wird er nach dem nächsten Image-Update automatisch aktiv.
+
 ## Logs
 
 Die XAseco-Logdatei befindet sich unter:
@@ -157,13 +190,199 @@ Die XAseco-Logdatei befindet sich unter:
 
 Bei Problemen ist dies die erste Anlaufstelle für die Fehlersuche.
 
-## Wichtige Chat-Befehle
+> **Hinweis:** Die XAseco-Logdatei wird automatisch per logrotate rotiert (max. 10 MB pro Datei, 5 rotierte Dateien). Alte Logs werden komprimiert als `aseco.log.1.gz`, `aseco.log.2.gz` usw. aufbewahrt. Siehe [Konfiguration – Log-Rotation](konfiguration.md#log-rotation).
+
+## Chat-Befehle
+
+Nachfolgend eine Übersicht der wichtigsten Befehle, die im Spielchat verfügbar sind. Eine vollständige Liste aller Befehle findest du in der offiziellen Dokumentation unter: https://docs.xaseco.org/commands.php
+
+### Hilfe & Info
 
 | Befehl | Beschreibung |
 |--------|-------------|
-| `/helpadmin` | Admin-Befehle anzeigen |
+| `/help` | Zeigt alle verfügbaren Befehle |
-| `/recs` | Lokale Rekorde anzeigen |
+| `/helpall` | Zeigt ausführliche Hilfe zu allen Befehlen |
-| `/dedirecs` | Dedimania-Rekorde anzeigen |
+| `/xaseco` | Zeigt Infos über die XAseco-Version |
-| `/jukebox` | Track-Jukebox öffnen |
+| `/server` | Zeigt Infos über den Server |
-| `/stats` | Spieler-Statistiken anzeigen |
+| `/plugins` | Zeigt Liste der aktiven Plugins |
-| `/admin help` | Alle Admin-Befehle |
+| `/time` | Zeigt aktuelle Serverzeit und Datum |
+
+### Rekorde & Statistiken
+
+| Befehl | Beschreibung |
+|--------|-------------|
+| `/recs` | Zeigt alle lokalen Rekorde auf der aktuellen Strecke |
+| `/recs pb` | Zeigt deine persönliche Bestzeit |
+| `/recs new` | Zeigt neu gefahrene Rekorde |
+| `/recs live` | Zeigt Rekorde der Online-Spieler |
+| `/pb` | Zeigt deine persönliche Bestzeit auf der aktuellen Strecke |
+| `/dedirecs` | Zeigt Dedimania-Rekorde auf der aktuellen Strecke |
+| `/dedipb` | Zeigt deine persönliche Dedimania-Bestzeit |
+| `/dedistats` | Zeigt Dedimania-Streckenstatistiken |
+| `/best` | Zeigt deine besten Rekorde |
+| `/worst` | Zeigt deine schlechtesten Rekorde |
+| `/summary` | Zeigt eine Zusammenfassung aller deiner Rekorde |
+| `/stats` | Zeigt Statistiken des aktuellen Spielers |
+| `/wins` | Zeigt Siege des aktuellen Spielers |
+
+### Rankings & Toplisten
+
+| Befehl | Beschreibung |
+|--------|-------------|
+| `/rank` | Zeigt deinen aktuellen Serverrang |
+| `/nextrank` | Zeigt den nächst besser platzierten Spieler |
+| `/top10` | Zeigt die 10 bestplatzierten Spieler |
+| `/top100` | Zeigt die 100 bestplatzierten Spieler |
+| `/topwins` | Zeigt die 100 siegreichsten Spieler |
+| `/toprecs` | Zeigt Top 100 der Rekord-Halter |
+| `/topsums` | Zeigt Top 100 der Top-3-Rekord-Halter |
+| `/active` | Zeigt die 100 aktivsten Spieler |
+| `/topclans` | Zeigt die 10 bestplatzierten Clans |
+
+### Strecken & Jukebox
+
+| Befehl | Beschreibung |
+|--------|-------------|
+| `/track` | Zeigt Infos über die aktuelle Strecke |
+| `/nextmap` | Zeigt den Namen der nächsten Strecke |
+| `/playtime` | Zeigt, wie lange die aktuelle Strecke läuft |
+| `/list` | Listet Strecken auf dem Server (siehe `/list help`) |
+| `/list nofinish` | Strecken, auf denen du keinen Rang hast |
+| `/list newest` | Die neuesten Strecken |
+| `/list <name>` | Suche nach Strecken- oder Autorennamen |
+| `/jukebox` | Track-Jukebox (siehe `/jukebox help`) |
+| `/jukebox list` | Zeigt kommende Strecken |
+| `/jukebox <#>` | Fügt Strecke Nr. `<#>` aus `/list` hinzu |
+| `/jukebox drop` | Entfernt deine hinzugefügte Strecke |
+| `/add <ID>` | Fügt eine Strecke direkt von TMX hinzu |
+| `/history` | Zeigt die 10 zuletzt gespielten Strecken |
+
+### Karma & Voting
+
+| Befehl | Beschreibung |
+|--------|-------------|
+| `/karma` | Zeigt Karma der aktuellen Strecke |
+| `/++` | Positive Bewertung für die aktuelle Strecke |
+| `/--` | Negative Bewertung für die aktuelle Strecke |
+| `/helpvote` | Zeigt Infos zum Chat-Voting-System |
+| `/endround` | Startet Vote zum Beenden der aktuellen Runde |
+| `/replay` | Startet Vote zum Wiederholen der Strecke |
+| `/skip` | Startet Vote zum Überspringen der Strecke |
+| `/kick` | Startet Vote zum Kicken eines Spielers |
+| `/y` | Stimmt mit Ja bei einem laufenden Vote |
+| `/cancel` | Bricht deinen aktuellen Vote ab |
+
+### Kommunikation
+
+| Befehl | Beschreibung |
+|--------|-------------|
+| `/pm <login> <msg>` | Sendet eine private Nachricht |
+| `/pmlog` | Zeigt Verlauf deiner privaten Nachrichten |
+| `/chatlog` | Zeigt Verlauf der letzten Chat-Nachrichten |
+| `/me` | Drückt eine Aktion/Emotion aus |
+| `/hi` | Sendet eine Hallo-Nachricht an alle |
+| `/bye` | Sendet eine Tschüss-Nachricht an alle |
+| `/gg` | Sendet "Good Game" an alle |
+| `/n1` | Sendet "Nice One" an alle |
+| `/brb` | Sendet "Be Right Back" an alle |
+| `/afk` | Sendet "Away From Keyboard" an alle |
+
+### Spieleroptionen
+
+| Befehl | Beschreibung |
+|--------|-------------|
+| `/settings` | Zeigt deine persönlichen Einstellungen |
+| `/cps` | Setzt Checkpoint-Tracking für lokale Rekorde |
+| `/dedicps` | Setzt Checkpoint-Tracking für Dedimania-Rekorde |
+| `/mute <login>` | Chat eines Spielers stummschalten |
+| `/unmute <login>` | Stummschaltung aufheben |
+| `/mutelist` | Zeigt Liste der stummgeschalteten Spieler |
+| `/players` | Zeigt aktuelle Spieler-Liste (Nicks/Logins) |
+| `/ranks` | Zeigt Liste der Online-Ränge |
+| `/bootme` | Kickt dich selbst vom Server |
+
+### Admin-Befehle (`/admin`)
+
+Diese Befehle sind nur für Admins und MasterAdmins verfügbar.
+
+| Befehl | Beschreibung |
+|--------|-------------|
+| `/admin help` | Zeigt alle Admin-Befehle |
+| `/admin helpall` | Zeigt ausführliche Hilfe zu allen Admin-Befehlen |
+
+**Server-Einstellungen:**
+
+| Befehl | Beschreibung |
+|--------|-------------|
+| `/admin setservername <name>` | Ändert den Servernamen |
+| `/admin setpwd <pwd>` | Ändert das Spieler-Passwort |
+| `/admin setspecpwd <pwd>` | Ändert das Zuschauer-Passwort |
+| `/admin setmaxplayers <#>` | Setzt maximale Spieleranzahl |
+| `/admin setmaxspecs <#>` | Setzt maximale Zuschauerzahl |
+| `/admin setgamemode <mode>` | Setzt Spielmodus (ta/rounds/team/laps/stunts/cup) |
+
+**Strecken-Verwaltung:**
+
+| Befehl | Beschreibung |
+|--------|-------------|
+| `/admin nextmap` | Erzwingt nächste Strecke |
+| `/admin restartmap` | Startet aktuelle Strecke neu |
+| `/admin replaymap` | Wiederholt aktuelle Strecke (via Jukebox) |
+| `/admin endround` | Erzwingt Ende der aktuellen Runde |
+| `/admin add <ID>` | Fügt Strecke von TMX hinzu |
+| `/admin addlocal <datei>` | Fügt lokale Strecke hinzu |
+| `/admin remove <#>` | Entfernt Strecke aus der Rotation |
+| `/admin erasethis` | Entfernt aktuelle Strecke und löscht Datei |
+| `/admin shuffle` | Mischt die Streckenliste zufällig |
+| `/admin writetracklist` | Speichert aktuelle Streckenliste |
+| `/admin readtracklist` | Lädt Streckenliste aus Datei |
+
+**Jukebox:**
+
+| Befehl | Beschreibung |
+|--------|-------------|
+| `/admin dropjukebox <#>` | Entfernt eine Strecke aus der Jukebox |
+| `/admin clearjukebox` | Leert die gesamte Jukebox |
+| `/admin pass` | Genehmigt einen laufenden Vote |
+| `/admin cancel` | Bricht einen laufenden Vote ab |
+
+**Spieler-Moderation:**
+
+| Befehl | Beschreibung |
+|--------|-------------|
+| `/admin warn <login>` | Sendet eine Warnung an einen Spieler |
+| `/admin kick <login>` | Kickt einen Spieler vom Server |
+| `/admin kickghost <login>` | Kickt einen Ghost-Spieler |
+| `/admin ban <login>` | Bannt einen Spieler |
+| `/admin unban <login>` | Entbannt einen Spieler |
+| `/admin black <login>` | Setzt einen Spieler auf die Blacklist |
+| `/admin unblack <login>` | Entfernt einen Spieler von der Blacklist |
+| `/admin mute <login>` | Schaltet einen Spieler global stumm |
+| `/admin unmute <login>` | Hebt globale Stummschaltung auf |
+| `/admin forcespec <login>` | Erzwingt Zuschauer-Modus |
+| `/admin forceteam <login>` | Erzwingt Team-Zuordnung (Blue/Red) |
+
+**Admin-Verwaltung:**
+
+| Befehl | Beschreibung |
+|--------|-------------|
+| `/admin addadmin <login>` | Fügt einen neuen Admin hinzu |
+| `/admin removeadmin <login>` | Entfernt einen Admin |
+| `/admin addop <login>` | Fügt einen neuen Operator hinzu |
+| `/admin removeop <login>` | Entfernt einen Operator |
+| `/admin listmasters` | Zeigt MasterAdmin-Liste |
+| `/admin listadmins` | Zeigt Admin-Liste |
+| `/admin listops` | Zeigt Operator-Liste |
+
+**Rekorde & System:**
+
+| Befehl | Beschreibung |
+|--------|-------------|
+| `/admin delrec <#>` | Löscht einen bestimmten Rekord auf der aktuellen Strecke |
+| `/admin wall <msg>` | Zeigt Popup-Nachricht für alle Spieler |
+| `/admin pm <msg>` | Sendet private Nachricht an alle Admins |
+| `/admin server` | Zeigt detaillierte Server-Einstellungen |
+| `/admin shutdown` | Fährt XAseco herunter |
+| `/admin shutdownall` | Fährt Server und XAseco herunter |
+
+> **Tipp:** Eine vollständige Referenz aller Befehle (inkl. `/jfreu`-Befehle für erweiterte Moderation) findest du unter: https://docs.xaseco.org/commands.php