Merge pull request 'release-1.3.2' (#18 ) from release-1.3.2 into master

Reviewed-on: #18
Release: Docker Image Version 1.3.2 gepusht
2026-03-26 22:08:33 +00:00 · 2026-03-26 23:05:50 +01:00 · 2026-03-26 23:03:09 +01:00 · 2026-03-26 22:59:26 +01:00 · 2026-03-26 22:54:39 +01:00 · 2026-03-26 22:52:21 +01:00
18 changed files with 1482 additions and 41 deletions
--- a/.env.example
+++ b/.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
--- a/.gitea/workflows/docker-publish.yml
+++ b/.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
--- a/29
+++ b/29
@@ -15,6 +15,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 +48,16 @@ COPY assets/bin/RunTrackmaniaServer.sh /opt/tmserver/
 RUN sed -i 's/\r$//' /opt/tmserver/RunTrackmaniaServer.sh \
    && chmod +x /opt/tmserver/RunTrackmaniaServer.sh

+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 \
@@ -130,9 +135,13 @@ RUN unzip /opt/tmserver/xaseco_v1.16.zip -d /opt/tmserver/ \
    # newinstall-Ordner aufraeumen
    && rm -rf /opt/tmserver/xaseco/newinstall

-# Nicht mehr verfuegbare Plugins deaktivieren (freezone entfernen, teamspeak3 auskommentieren)
-RUN sed -i '/<plugin>plugin\.freezone\.php<\/plugin>/d' /opt/tmserver/xaseco/plugins.xml \
-    && sed -i 's/<plugin>plugin\.teamspeak3\.php<\/plugin>/<!-- <plugin>plugin.teamspeak3.php<\/plugin> -->/' /opt/tmserver/xaseco/plugins.xml
+# Nicht mehr verfuegbares freezone-Plugin entfernen
+RUN sed -i '/<plugin>plugin\.freezone\.php<\/plugin>/d' /opt/tmserver/xaseco/plugins.xml
+
+# TeamSpeak3-Plugin: Eigenes Gateway einbinden (Original-Gateway nicht mehr verfuegbar)
+# Die teamspeak3.xml wird direkt in den XAseco-Ordner kopiert, damit das Plugin
+# beim Start automatisch den konfigurierten TS3-Server anzeigt.
+COPY assets/config/xaseco/teamspeak3.xml /opt/tmserver/xaseco/teamspeak3.xml

 # XAseco als Default-Template sichern (wird beim ersten Start ins Volume kopiert)
 RUN cp -a /opt/tmserver/xaseco /opt/tmserver/default-xaseco
@@ -140,6 +149,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).
@@ -165,6 +179,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=""
@@ -187,6 +202,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
@@ -202,4 +219,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"]
--- a/README.md
+++ b/README.md
@@ -6,7 +6,6 @@ Ein vollständiges Docker-Setup für einen **TrackMania Nations Forever**-Server
 - **[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.

@@ -60,11 +59,13 @@ 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

-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

--- a/assets/bin/RunTrackmaniaServer.sh
+++ b/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 755 "$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."

    # ============================================================
@@ -353,6 +365,56 @@ if [ "$XASECO_ENABLED" = "true" ]; then
    fi
 fi

+# ============================================================
+# XAseco: TeamSpeak3-Plugin Gateway aktualisieren (fuer bestehende Volumes)
+# ============================================================
+# Das Original-TS3-Gateway ist nicht mehr verfuegbar. Falls die
+# teamspeak3.xml fehlt, wird sie aus dem Template kopiert. Falls sie
+# bereits existiert (= Nutzer hat eigene TS3-Daten konfiguriert),
+# 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"
+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, 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."
+    else
+        # Gateway-URLs aus dem Template auslesen
+        NEW_HELPER_URL=$(grep -oP '(?<=<helperURL>).*?(?=</helperURL>)' "$TS3_DEFAULT")
+        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
+
+# TS3-Plugin reaktivieren, falls es auskommentiert ist
+if [ -f "$TS3_PLUGINS_XML" ] && grep -q '<!-- <plugin>plugin\.teamspeak3\.php</plugin> -->' "$TS3_PLUGINS_XML"; then
+    echo "==> TeamSpeak3-Plugin: Reaktiviere auskommentiertes Plugin..."
+    sed -i 's|<!-- <plugin>plugin\.teamspeak3\.php</plugin> -->|<plugin>plugin.teamspeak3.php</plugin>|' "$TS3_PLUGINS_XML"
+    echo "    TeamSpeak3-Plugin erfolgreich aktiviert."
+fi
+
 # ============================================================
 # RemoteCP: PHP-Warnungen in Plugins fixen (fuer bestehende Volumes)
 # ============================================================
@@ -413,6 +475,42 @@ 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: Logs-Verzeichnis-Berechtigungen korrigieren (fuer bestehende Volumes)
+# ============================================================
+# In aelteren Versionen wurde /var/www/html/logs/ mit chmod 777
+# (world-writable) angelegt. logrotate verweigert die Rotation von
+# Log-Dateien in world-writable Verzeichnissen aus Sicherheitsgruenden.
+# Die korrekte Berechtigung ist 755: www-data (Owner) behaelt
+# Schreibzugriff, anderen Nutzern wird Write entzogen.
+# ============================================================
+ADMINSERV_LOGS_DIR="/var/www/html/logs"
+if [ -d "$ADMINSERV_LOGS_DIR" ]; then
+    CURRENT_PERMS=$(stat -c '%a' "$ADMINSERV_LOGS_DIR")
+    if [ "$CURRENT_PERMS" != "755" ]; then
+        echo "==> Korrigiere Berechtigungen fuer AdminServ-Logs-Verzeichnis (${CURRENT_PERMS} -> 755)..."
+        chmod 755 "$ADMINSERV_LOGS_DIR"
+        echo "    Berechtigungen erfolgreich korrigiert."
+    fi
+fi
+
 echo "Starting apache server"
 service apache2 start

@@ -664,6 +762,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}"

@@ -744,10 +919,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."
@@ -933,5 +1120,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
--- a/assets/bin/WatchPublicIP.sh
+++ b/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
--- a/assets/bin/XAsecoHealthcheck.sh
+++ b/assets/bin/XAsecoHealthcheck.sh
@@ -0,0 +1,182 @@
+#!/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
+    LAST_LINES=$(tail -20 "$LOG_FILE" 2>/dev/null)
+    # 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."
--- a/assets/config/logrotate.conf
+++ b/assets/config/logrotate.conf
@@ -0,0 +1,56 @@
+# ============================================================
+# 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
+}
+
+# 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
+}
--- a/assets/config/xaseco/teamspeak3.xml
+++ b/assets/config/xaseco/teamspeak3.xml
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8"?>
+<settings>
+        <!-- Server Configuration, can be address or ip -->
+        <server>ts3.techniverse.net</server>
+        <serverid>1</serverid>
+        <serverport>9987</serverport>
+        <queryport>10011</queryport>
+
+        <!-- Channel & Update Settings -->
+        <defaultchannel></defaultchannel>
+        <subchannel></subchannel>
+        <channelpassword></channelpassword>
+        <update_interval>30</update_interval>
+
+
+        <!-- Helpers and images -->
+        <helperURL>http://assets.techniverse.net/tm/ts3gateway/gateway3.html</helperURL>
+        <logoURL>http://assets.techniverse.net/tm/ts3gateway/ts3logo.jpg</logoURL>
+
+        <!-- Widget position -->
+        <posx>-64</posx>
+        <posy>45</posy>
+</settings>
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,10 +1,11 @@
 services:
  tmserver:
-    image: git.techniverse.net/scriptos/trackmania-server:1.2.0
+    image: git.techniverse.net/scriptos/trackmania-server:1.3.2
    build:
      context: .
    container_name: tmserver
    restart: unless-stopped
+    stop_grace_period: 30s
    depends_on:
      mariadb:
        condition: service_healthy
@@ -52,6 +53,22 @@ services:
      tmserver_net:
        ipv4_address: 172.20.60.11

+  ip-watcher:
+    image: alpine:3.21
+    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.60.12
+
 networks:
  tmserver_net:
    name: tmserver.dockernetwork.local
--- a/docs/README.md
+++ b/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
-│   │   ├── remoteCP_v4.0.3.5.zip               # RemoteCP Web-UI
-│   │   ├── xaseco_v1.16.zip                     # XAseco Server-Controller
+│   │   ├── AdminServ_v2.1.1.zip                 # AdminServ Web-UI
+│   │   ├── remoteCP_v4.0.3.5.zip                # RemoteCP Web-UI
 │   │   ├── 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/
-│   │       └── plugins/
-│   │           ├── CustomPoints/
-│   │           │   └── index.php                # CustomPoints-Plugin fuer RemoteCP
-│   │           └── Mods/
-│   │               └── settings.xml             # Skin-Bibliothek (techniverse.net)
+│   │   ├── logrotate.conf                       # Log-Rotation-Konfiguration (groessenbasiert)
+│   │   ├── remotecp/
+│   │   │   └── plugins/
+│   │   │       ├── CustomPoints/
+│   │   │       │   └── index.php                # CustomPoints-Plugin fuer RemoteCP
+│   │   │       └── 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)
--- a/docs/adminserv.md
+++ b/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
-2. Ein Passwort festlegen – dieses wird als AdminServ-Passwort verwendet
-3. TM-Server-Informationen eintragen (Standardwerte können beibehalten werden)
-4. `Address` auf `localhost` setzen, um den eingebetteten Server zu verwalten
-5. Speichern
+AdminServ wird beim ersten Container-Start **vollständig automatisch konfiguriert**:
+
+- Serververbindung (Adresse `127.0.0.1`, XML-RPC-Port)
+- Server-Eintrag (Name, DisplayServ-Passwort)
+- Konfigurationspasswort (siehe [Konfigurationsseite (`/config`)](#konfigurationsseite-config))
+
+Es ist kein manuelles Setup nötig.

 ## Verbindung zum Server

-1. Über den Button „Servers" zur Serverliste navigieren
-2. Den gewünschten Server auswählen
-3. Admin-Stufe wählen und zugehöriges Passwort eingeben
+1. `http://<host-server-des-containers>` im Browser aufrufen
+2. Den Server aus der Liste auswählen
+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.
--- a/docs/ip-watcher.md
+++ b/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.
--- a/docs/konfiguration.md
+++ b/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.
--- a/docs/schnellstart.md
+++ b/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
--- a/docs/umgebungsvariablen.md
+++ b/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 |
--- a/docs/update.md
+++ b/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/).
--- a/docs/xaseco.md
+++ b/docs/xaseco.md
@@ -8,6 +8,55 @@ Im Container wird die modifizierte Version **XAseco 1.16** verwendet, die für P

 XAseco verbindet sich über XML-RPC mit dem TrackMania-Server und reagiert auf Spielereignisse (neue Rekorde, Spieler-Connects, Chat-Befehle usw.). Die Daten werden in einer eigenen MySQL-Datenbank gespeichert.

+## TeamSpeak 3 Integration
+
+XAseco enthält ein Plugin (`plugin.teamspeak3.php`), das im Spiel ein Widget mit den aktuell verbundenen TeamSpeak-3-Nutzern anzeigt. Das Plugin ist **standardmäßig aktiviert** und verwendet ein eigenes Gateway, das im Container mitgeliefert wird (das Original-Gateway des Plugin-Entwicklers ist nicht mehr verfügbar).
+
+### TS3-Server konfigurieren
+
+Die Konfiguration erfolgt über die Datei `data/xaseco/teamspeak3.xml`. Dort kann der eigene TeamSpeak-3-Server eingetragen werden:
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<settings>
+        <!-- Server Configuration, can be address or ip -->
+        <server>ts3.techniverse.net</server>
+        <serverid>1</serverid>
+        <serverport>9987</serverport>
+        <queryport>10011</queryport>
+
+        <!-- Channel & Update Settings -->
+        <defaultchannel></defaultchannel>
+        <subchannel></subchannel>
+        <channelpassword></channelpassword>
+        <update_interval>30</update_interval>
+
+        <!-- Helpers and images -->
+        <helperURL>http://assets.techniverse.net/tm/ts3gateway/gateway3.html</helperURL>
+        <logoURL>http://assets.techniverse.net/tm/ts3gateway/ts3logo.jpg</logoURL>
+
+        <!-- Widget position -->
+        <posx>-64</posx>
+        <posy>45</posy>
+</settings>
+```
+
+| Feld | Beschreibung |
+|------|-------------|
+| `server` | Hostname oder IP des TS3-Servers |
+| `serverid` | Virtuelle-Server-ID (meist `1`) |
+| `serverport` | Voice-Port des TS3-Servers (Standard: `9987`) |
+| `queryport` | ServerQuery-Port (Standard: `10011`) |
+| `defaultchannel` | Standard-Channel (leer = Server-Default) |
+| `subchannel` | Sub-Channel (optional) |
+| `channelpassword` | Channel-Passwort (optional) |
+| `update_interval` | Aktualisierungsintervall in Sekunden |
+| `helperURL` | URL zur Gateway-HTML-Seite (nicht ändern) |
+| `logoURL` | URL zum TS3-Logo im Widget (nicht ändern) |
+| `posx` / `posy` | Widget-Position im Spiel |
+
+> **Hinweis:** Standardmäßig ist der TS3-Server `ts3.techniverse.net` vorkonfiguriert. Zum Anpassen einfach nach dem ersten Start die Datei `data/xaseco/teamspeak3.xml` bearbeiten. Die Felder `helperURL` und `logoURL` verweisen auf das mitgelieferte Gateway und sollten nicht geändert werden.
+
 ## Konfiguration

 Die Konfiguration erfolgt ausschließlich über Umgebungsvariablen in der `.env`-Datei. Beim **ersten Start** (leeres XAseco-Volume) werden die Werte automatisch in die XML-Konfigurationsdateien eingetragen.
@@ -28,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

@@ -98,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:
@@ -108,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 |
-| `/recs` | Lokale Rekorde anzeigen |
-| `/dedirecs` | Dedimania-Rekorde anzeigen |
-| `/jukebox` | Track-Jukebox öffnen |
-| `/stats` | Spieler-Statistiken anzeigen |
-| `/admin help` | Alle Admin-Befehle |
+| `/help` | Zeigt alle verfügbaren Befehle |
+| `/helpall` | Zeigt ausführliche Hilfe zu allen Befehlen |
+| `/xaseco` | Zeigt Infos über die XAseco-Version |
+| `/server` | Zeigt Infos über den Server |
+| `/plugins` | Zeigt Liste der aktiven Plugins |
+| `/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
Author	SHA1	Message	Date
Patrick Asmus	22733ce651	Merge pull request 'release-1.3.2' (#18 ) from release-1.3.2 into master All checks were successful Build & Push Docker Image / build-and-push (push) Successful in 51s Details Reviewed-on: #18	2026-03-26 22:08:33 +00:00
scriptos	2382546308	Release: Docker Image Version 1.3.2 gepusht	2026-03-26 23:05:50 +01:00
scriptos	e89ac156ce	fix(ip-watcher): IP-Prüfung bei unveränderter IP im Log ausgeben	2026-03-26 23:03:09 +01:00
scriptos	32a09ba808	docs: Update-Anleitung hinzugefügt, .env.example um fehlende XAseco-Healthcheck-Variablen ergänzt	2026-03-26 22:59:26 +01:00
scriptos	931c62eb6b	docs: IP-Watcher in Dokumentationsübersicht der README ergänzt	2026-03-26 22:54:39 +01:00
scriptos	44dde46067	fix: logrotate-Fehler durch unsichere Permissions am logs-Verzeichnis beheben	2026-03-26 22:52:21 +01:00
Patrick Asmus	14c47bbdd7	Merge pull request 'release-1.3.1' (#17 ) from release-1.3.1 into master All checks were successful Build & Push Docker Image / build-and-push (push) Successful in 4m6s Details Reviewed-on: #17	2026-03-26 20:27:09 +00:00
scriptos	5601b1469d	Release: Docker Image Version 1.3.1 gepusht	2026-03-26 21:24:26 +01:00
scriptos	d77961818a	ci: Gitea Action für automatischen Docker-Build und Registry-Push hinzugefügt	2026-03-26 21:21:22 +01:00
scriptos	7bf847d31c	feat: IP-Watcher – automatischer Neustart bei IP-Wechsel	2026-03-26 21:09:23 +01:00
Patrick Asmus	7539e18a46	Merge pull request 'feat: Map-Shuffle beim Containerstart (SHUFFLE_MAPLIST) - Variable ergänzt' (#15 ) from release-1.3.0 into master Reviewed-on: #15	2026-03-23 22:23:01 +00:00
Patrick Asmus	2c3aaaee23	Merge branch 'master' into release-1.3.0	2026-03-23 22:22:48 +00:00
Patrick Asmus (scriptos)	69bfa07457	feat: Map-Shuffle beim Containerstart (SHUFFLE_MAPLIST) - Variable ergänzt	2026-03-23 23:20:48 +01:00
Patrick Asmus	af44a273fa	Merge pull request 'release-1.3.0' (#14 ) from release-1.3.0 into master Reviewed-on: #14	2026-03-23 22:12:34 +00:00
Patrick Asmus (scriptos)	e60cc0804c	Release: Docker Image Version 1.3.0 gepusht	2026-03-23 23:08:54 +01:00
Patrick Asmus (scriptos)	e453ab6dbd	Startup-Zusammenfassung: HOST_IP-Variable entfernt, Platzhalter beibehalten	2026-03-23 23:01:02 +01:00
Patrick Asmus (scriptos)	6cb5f783bf	Startup-Zusammenfassung: Servername aus Config lesen, Host-IP ermitteln	2026-03-23 22:55:17 +01:00
Patrick Asmus (scriptos)	4ec60113f7	Fix: Signal-Handler dash-kompatibel (SIGTERM -> TERM)	2026-03-23 22:49:01 +01:00
Patrick Asmus (scriptos)	8b61571ac5	Doku sauber formatiert	2026-03-23 22:33:55 +01:00
Patrick Asmus (scriptos)	d7be0b37ef	Startup-Zusammenfassung am Ende des Startscripts hinzugefuegt	2026-03-23 22:28:13 +01:00
Patrick Asmus (scriptos)	7eb2b6ff0b	Graceful Shutdown: Signal-Handler für sauberes Herunterfahren aller Dienste	2026-03-23 22:20:05 +01:00
Patrick Asmus (scriptos)	cbb918d6b2	Log-Rotation fuer Apache-, PHP- und XAseco-Logs eingerichtet	2026-03-23 22:14:38 +01:00
Patrick Asmus (scriptos)	7710a032d9	XAseco-Healthcheck: Automatische Überwachung und Neustart bei Absturz	2026-03-23 22:06:58 +01:00
Patrick Asmus (scriptos)	12a8e0f778	feat: Map-Shuffle beim Containerstart (SHUFFLE_MAPLIST)	2026-03-23 21:55:27 +01:00
Patrick Asmus (scriptos)	ca6c0faaa0	fix: TS3-Konfiguration wird bei Update nicht mehr überschrieben	2026-03-23 21:47:22 +01:00
Patrick Asmus	77ac9cc37a	Merge pull request 'release-1.2.2' (#13 ) from release-1.2.2 into master Reviewed-on: #13	2026-03-23 08:51:05 +00:00
scriptos	8a3ef5241e	Release: Docker Image Version 1.2.2 gepusht	2026-03-23 09:50:21 +01:00
scriptos	634cd8c0a6	docs(xaseco): umfassende Chat-Befehlsreferenz ergänzt Bisherige Kurztabelle durch vollständige Befehlsübersicht ersetzt, gegliedert nach Kategorien: Hilfe, Rekorde, Rankings, Strecken, Karma/Voting, Kommunikation, Spieleroptionen und Admin-Befehle. Verweis auf offizielle Dokumentation (docs.xaseco.org) hinzugefügt.	2026-03-23 09:47:52 +01:00
scriptos	daaace417b	fix(security): AdminServ-Konfigurationspasswort durch zufälligen Hash ersetzen	2026-03-23 09:43:28 +01:00
scriptos	f7d3a9ce83	docs: Doku an Code anpassen, AdminServ-Konfigurationspasswort automatisch absichern	2026-03-23 09:25:48 +01:00
Patrick Asmus	59826b2e75	Merge pull request 'release-1.2.1' (#12 ) from release-1.2.1 into master Reviewed-on: #12	2026-03-22 22:42:26 +00:00
Patrick Asmus (scriptos)	5a321db094	Release: Docker Image Version 1.2.1 gepusht	2026-03-22 23:41:40 +01:00
Patrick Asmus (scriptos)	344029c551	feat: TeamSpeak3-Plugin mit eigenem Gateway reaktivieren	2026-03-22 23:35:11 +01:00