Compare commits
60 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 22733ce651 | |||
| 2382546308 | |||
| e89ac156ce | |||
| 32a09ba808 | |||
| 931c62eb6b | |||
| 44dde46067 | |||
| 14c47bbdd7 | |||
| 5601b1469d | |||
| d77961818a | |||
| 7bf847d31c | |||
| 7539e18a46 | |||
| 2c3aaaee23 | |||
| 69bfa07457 | |||
| af44a273fa | |||
| e60cc0804c | |||
| e453ab6dbd | |||
| 6cb5f783bf | |||
| 4ec60113f7 | |||
| 8b61571ac5 | |||
| d7be0b37ef | |||
| 7eb2b6ff0b | |||
| cbb918d6b2 | |||
| 7710a032d9 | |||
| 12a8e0f778 | |||
| ca6c0faaa0 | |||
| 77ac9cc37a | |||
| 8a3ef5241e | |||
| 634cd8c0a6 | |||
| daaace417b | |||
| f7d3a9ce83 | |||
| 59826b2e75 | |||
| 5a321db094 | |||
| 344029c551 | |||
| bf3b7858ee | |||
| ebd20d4653 | |||
| fcea5b4d41 | |||
| 6f4426e080 | |||
| ed5b3d22fb | |||
| 3fb1dac5ba | |||
| 61deb93273 | |||
| fdcc82e935 | |||
| 75ae777f1e | |||
| b7a909392e | |||
| ec6418e9ab | |||
| f013ccd61e | |||
| 0717088eb4 | |||
| 5ccba54e84 | |||
| 9b37dfd2bc | |||
| 503fadf1d6 | |||
| 3354ebd541 | |||
| 7482071f2c | |||
| 69940ee56b | |||
| c081e43375 | |||
| 35e485b065 | |||
| b672f84f55 | |||
| 76e739f12a | |||
| 5891429c83 | |||
| ffdc11a02b | |||
| e05de1fbe2 | |||
| 495a5a2663 |
41
.env.example
41
.env.example
@@ -35,6 +35,7 @@ SERVER_PASSWORD=
|
||||
SERVER_MAX_SPECTATORS=40
|
||||
SERVER_SPEC_PASSWORD=
|
||||
SERVER_LADDER_MODE=forced
|
||||
SERVER_LADDER_LIMIT_MAX=60000
|
||||
|
||||
# --- Netzwerk ---
|
||||
# Bitte ändere die Ports, wenn sie in deinem Netzwerk bereits verwendet werden.
|
||||
@@ -54,6 +55,34 @@ SERVER_MODE=internet
|
||||
# In einer Produktionsumgebung sollte dieser Wert jedoch auf false belassen werden, um zu verhindern, dass die Konfiguration versehentlich überschrieben wird.
|
||||
FORCE_CONFIG_UPDATE=false
|
||||
|
||||
# --- Forced Mods (Skins) ---
|
||||
# Beim Containerstart kann automatisch ein Mod (Skin) pro Umgebung forciert werden.
|
||||
# Der Wert ist die vollständige URL zu einer Mod-ZIP-Datei, die Spieler beim Betreten des Servers herunterladen.
|
||||
# Verfügbare Skins findest du unter: https://assets.techniverse.net/tm/skins/
|
||||
# Beispiel: FORCE_MOD_STADIUM=https://assets.techniverse.net/tm/skins/Portal.zip
|
||||
# Leer lassen = kein Mod für diese Umgebung.
|
||||
FORCE_MOD_STADIUM=
|
||||
FORCE_MOD_ISLAND=
|
||||
FORCE_MOD_BAY=
|
||||
FORCE_MOD_COAST=
|
||||
FORCE_MOD_SPEED=
|
||||
FORCE_MOD_ALPINE=
|
||||
FORCE_MOD_RALLY=
|
||||
|
||||
# --- 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
|
||||
@@ -88,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
|
||||
|
||||
41
.gitea/workflows/docker-publish.yml
Normal file
41
.gitea/workflows/docker-publish.yml
Normal file
@@ -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
|
||||
2
.gitignore
vendored
2
.gitignore
vendored
@@ -3,3 +3,5 @@
|
||||
|
||||
# Persistente Server-Daten
|
||||
data/
|
||||
|
||||
.ki-workspace/
|
||||
|
||||
74
Dockerfile
74
Dockerfile
@@ -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)
|
||||
@@ -41,18 +42,22 @@ RUN mkdir -p /opt/tmserver/GameData/Config/AdminServ/ServerOptions \
|
||||
&& chown -R www-data:www-data /opt/tmserver/GameData/Config/AdminServ
|
||||
|
||||
# Gesamtes GameData als Default-Template sichern (wird beim ersten Start ins Volume kopiert)
|
||||
RUN cp -r /opt/tmserver/GameData /opt/tmserver/default-gamedata
|
||||
RUN cp -a /opt/tmserver/GameData /opt/tmserver/default-gamedata
|
||||
|
||||
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 \
|
||||
@@ -70,8 +75,35 @@ RUN unzip /var/www/html/remoteCP_v4.0.3.5.zip -d /var/www/html \
|
||||
&& chmod -R 777 /var/www/html/remotecp/xml/settings \
|
||||
&& chown -R www-data:www-data /var/www/html/remotecp/
|
||||
|
||||
# Fix PHP-Warnungen in RemoteCP CustomPoints-Plugin (undefined constants)
|
||||
# RemoteCP nutzt bare constants (pt_custom, pt_points, ...), die in PHP 7.2+
|
||||
# Warnungen ausloesen. Das gepatchte Plugin nutzt stattdessen defined()-Pruefungen.
|
||||
COPY assets/config/remotecp/plugins/CustomPoints/index.php /var/www/html/remotecp/plugins/CustomPoints/index.php
|
||||
RUN chown www-data:www-data /var/www/html/remotecp/plugins/CustomPoints/index.php
|
||||
|
||||
# Fix PHP-Warnungen in RemoteCP Mods-Plugin (foreach auf leere Umgebungen)
|
||||
# Leere Umgebungen (Island, Bay, …) fuehrten zu "Invalid argument supplied
|
||||
# for foreach()", weil $this->mods['Env'] nicht initialisiert war.
|
||||
# Zusaetzlich bare-constant-Warnungen (pt_*) mit defined()-Pruefungen entschaerft.
|
||||
COPY assets/config/remotecp/plugins/Mods/index.php /var/www/html/remotecp/plugins/Mods/index.php
|
||||
RUN chown www-data:www-data /var/www/html/remotecp/plugins/Mods/index.php
|
||||
|
||||
# RemoteCP Mods-Plugin: Vorkonfigurierte Skin-Liste (techniverse.net)
|
||||
COPY assets/config/remotecp/plugins/Mods/settings.xml /var/www/html/remotecp/plugins/Mods/settings.xml
|
||||
RUN chown www-data:www-data /var/www/html/remotecp/plugins/Mods/settings.xml
|
||||
|
||||
# Fix AdminServ MatchSettings-Bugs fuer TmForever:
|
||||
# 1) get_matchset_mapimport.php: Falscher Pfad-Praefix (MatchSettings/ statt
|
||||
# des tatsaechlichen Map-Ordners) beim Erstellen von MatchSettings.
|
||||
# 2) maps-creatematchset.php: GetModeScriptInfo-Aufruf (existiert nur in
|
||||
# ManiaPlanet/TM2) wird fuer TmForever uebersprungen.
|
||||
COPY assets/config/adminserv/get_matchset_mapimport.php /var/www/html/resources/ajax/get_matchset_mapimport.php
|
||||
COPY assets/config/adminserv/maps-creatematchset.php /var/www/html/resources/process/maps-creatematchset.php
|
||||
RUN chown www-data:www-data /var/www/html/resources/ajax/get_matchset_mapimport.php \
|
||||
&& chown www-data:www-data /var/www/html/resources/process/maps-creatematchset.php
|
||||
|
||||
# AdminServ- und RemoteCP-Dateien als Default-Template sichern (wird beim ersten Start ins Volume kopiert)
|
||||
RUN cp -r /var/www/html /opt/tmserver/default-controlpanel
|
||||
RUN cp -a /var/www/html /opt/tmserver/default-controlpanel
|
||||
|
||||
# XAseco installieren
|
||||
COPY assets/bin/xaseco_v1.16.zip /opt/tmserver/
|
||||
@@ -103,16 +135,25 @@ 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 -r /opt/tmserver/xaseco /opt/tmserver/default-xaseco
|
||||
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).
|
||||
@@ -136,6 +177,19 @@ ENV SERVER_DOWNLOAD_RATE=8192
|
||||
ENV SERVER_MODE=internet
|
||||
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=""
|
||||
ENV FORCE_MOD_ISLAND=""
|
||||
ENV FORCE_MOD_BAY=""
|
||||
ENV FORCE_MOD_COAST=""
|
||||
ENV FORCE_MOD_SPEED=""
|
||||
ENV FORCE_MOD_ALPINE=""
|
||||
ENV FORCE_MOD_RALLY=""
|
||||
|
||||
# RemoteCP
|
||||
ENV REMOTECP_DB_HOST=mariadb
|
||||
ENV REMOTECP_DB_NAME=remotecp
|
||||
@@ -148,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
|
||||
@@ -163,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"]
|
||||
|
||||
8
LICENSE
8
LICENSE
@@ -23,11 +23,9 @@ unterzulizenzieren und/oder Kopien der Software zu verkaufen, und Personen,
|
||||
denen die Software zur Verfügung gestellt wird, dies unter den folgenden
|
||||
Bedingungen zu gestatten:
|
||||
|
||||
Der obige Urheberrechtshinweis und dieser Genehmigungshinweis müssen in allen
|
||||
Kopien oder wesentlichen Teilen der Software enthalten sein. Bei jeglicher
|
||||
Weiterverarbeitung, Veröffentlichung oder Verbreitung der Software müssen der
|
||||
Name „Patrick Asmus" und die E-Mail-Adresse „support@techniverse.net" des
|
||||
Urhebers genannt werden.
|
||||
Der obige Urheberrechtshinweis einschließlich der Angaben zum Lizenzinhaber
|
||||
sowie dieser Genehmigungshinweis müssen in allen Kopien oder wesentlichen
|
||||
Teilen der Software enthalten sein.
|
||||
|
||||
DIE SOFTWARE WIRD „WIE BESEHEN" OHNE JEGLICHE AUSDRÜCKLICHE ODER
|
||||
STILLSCHWEIGENDE GEWÄHRLEISTUNG ZUR VERFÜGUNG GESTELLT, EINSCHLIESSLICH,
|
||||
|
||||
61
README.md
61
README.md
@@ -1,6 +1,13 @@
|
||||
# tmserver-docker
|
||||
|
||||
Trackmania Nations Forever Docker Server
|
||||
Ein vollständiges Docker-Setup für einen **TrackMania Nations Forever**-Server – inklusive Web-Verwaltung und Server-Controller:
|
||||
|
||||
- **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
|
||||
|
||||
Alle Komponenten laufen in einem einzigen Container und werden über Umgebungsvariablen konfiguriert.
|
||||
|
||||
> **Hinweis:** Dieses Projekt ist ein Fork von [lduriez/tmserver-docker](https://github.com/lduriez/tmserver-docker?tab=readme-ov-file).
|
||||
|
||||
@@ -20,10 +27,20 @@ Passe die Werte in der `.env`-Datei an deine Umgebung an (Passwörter, Masterser
|
||||
|
||||
### 2. Server starten
|
||||
|
||||
Das fertige Docker Image kann direkt verwendet werden – kein eigener Build nötig:
|
||||
|
||||
```bash
|
||||
docker compose up -d --build
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
Das Image wird automatisch aus der Container-Registry geladen:
|
||||
|
||||
```
|
||||
git.techniverse.net/scriptos/trackmania-server:latest
|
||||
```
|
||||
|
||||
> **Tipp:** Alle verfügbaren Tags findest du in der [Container-Registry](https://git.techniverse.net/scriptos/-/packages/container/trackmania-server/). Wenn du das Image lieber selbst bauen möchtest, findest du die Anleitung unter [Schnellstart – Selbst bauen](docs/schnellstart.md#docker-image-selbst-bauen).
|
||||
|
||||
### 3. Verwaltungsoberflächen öffnen
|
||||
|
||||
- **AdminServ:** `http://<host-ip>/`
|
||||
@@ -31,33 +48,6 @@ docker compose up -d --build
|
||||
|
||||
> **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`.
|
||||
|
||||
## 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
|
||||
│ │ ├── RunTrackmaniaServer.sh # Container-Startscript
|
||||
│ │ └── TrackmaniaServer_*.zip # Trackmania Server Binary
|
||||
│ ├── config/
|
||||
│ ├── custom_game_settings.txt # MatchSettings (Spielmodus, Map-Rotation)
|
||||
│ └── dedicated_cfg.txt # Server-Config-Template (mit Platzhaltern)
|
||||
│ └── db/
|
||||
│ └── init-xaseco-db.sh # MariaDB Init-Script fuer XAseco-DB
|
||||
├── docs/ # Dokumentation
|
||||
├── docker-compose.yml # Docker Compose Konfiguration
|
||||
├── Dockerfile # Docker Build-Definition
|
||||
├── .env.example # Vorlage fuer Umgebungsvariablen
|
||||
├── .env # Lokale Umgebungsvariablen (nicht im Git!)
|
||||
└── data/ # Persistente Daten (zur Laufzeit)
|
||||
├── gamedata/ # TM-Server-Daten
|
||||
├── controlpanel/ # AdminServ + RemoteCP
|
||||
├── xaseco/ # XAseco-Konfiguration und Logs
|
||||
└── mariadb/ # MariaDB-Datenbankdateien
|
||||
```
|
||||
|
||||
## Dokumentation
|
||||
|
||||
Die vollständige Dokumentation befindet sich im Ordner [`docs/`](docs/README.md):
|
||||
@@ -69,7 +59,20 @@ 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
|
||||
|
||||
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
|
||||
|
||||
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)
|
||||
|
||||
---
|
||||
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
33
assets/bin/WatchPublicIP.sh
Normal file
33
assets/bin/WatchPublicIP.sh
Normal file
@@ -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
|
||||
182
assets/bin/XAsecoHealthcheck.sh
Normal file
182
assets/bin/XAsecoHealthcheck.sh
Normal file
@@ -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."
|
||||
76
assets/config/adminserv/get_matchset_mapimport.php
Normal file
76
assets/config/adminserv/get_matchset_mapimport.php
Normal file
@@ -0,0 +1,76 @@
|
||||
<?php
|
||||
// INCLUDES
|
||||
session_start();
|
||||
if( !isset($_SESSION['adminserv']['sid']) ){ exit; }
|
||||
$configPath = '../../'.$_SESSION['adminserv']['path'].'config/';
|
||||
require_once $configPath.'adminlevel.cfg.php';
|
||||
require_once $configPath.'adminserv.cfg.php';
|
||||
require_once $configPath.'extension.cfg.php';
|
||||
require_once $configPath.'servers.cfg.php';
|
||||
require_once '../core/adminserv.php';
|
||||
AdminServConfig::$PATH_RESOURCES = '../';
|
||||
AdminServ::getClass();
|
||||
AdminServUI::lang();
|
||||
|
||||
// ISSET
|
||||
if( isset($_GET['path']) ){ $path = addslashes($_GET['path']); }else{ $path = null; }
|
||||
if( isset($_GET['d']) ){ $directory = addslashes($_GET['d']); }else{ $directory = null; }
|
||||
if( isset($_GET['op']) ){ $operation = addslashes($_GET['op']); }else{ $operation = null; }
|
||||
if( isset($_GET['select']) ){ $selection = $_GET['select']; }else{ $selection = null; }
|
||||
|
||||
// DATA
|
||||
$out = null;
|
||||
if( AdminServ::initialize() && $path != null ){
|
||||
// Maps
|
||||
if($path == 'currentServerSelection'){
|
||||
$mapsImport = AdminServ::getMapList();
|
||||
}
|
||||
else{
|
||||
// FIX: Den relativen Pfad aus dem absoluten Pfad (Dropdown-Auswahl)
|
||||
// berechnen, statt den URL-Parameter 'd' (= MatchSettings-Speicherordner)
|
||||
// zu verwenden. Sonst wird z.B. "MatchSettings/" statt "Challenges/Downloaded/"
|
||||
// als Pfad-Praefix in die MatchSettings-Datei geschrieben.
|
||||
$mapsDirectoryPath = AdminServ::getMapsDirectoryPath();
|
||||
$relativePath = str_replace($mapsDirectoryPath, '', Str::toSlash($path));
|
||||
// Sicherstellen, dass der Pfad mit / endet (wenn nicht leer)
|
||||
if($relativePath && substr($relativePath, -1) !== '/'){
|
||||
$relativePath .= '/';
|
||||
}
|
||||
|
||||
$currentDir = Folder::read($path, AdminServConfig::$MATCHSET_HIDDEN_FOLDERS, AdminServConfig::$MATCHSET_EXTENSION, intval(AdminServConfig::RECENT_STATUS_PERIOD * 3600) );
|
||||
$mapsImport = AdminServ::getLocalMapList($currentDir, $relativePath);
|
||||
}
|
||||
|
||||
// Faire une sélection
|
||||
if($operation == 'setSelection'){
|
||||
// On supprime les maps non sélectionnées
|
||||
if( $selection != null && count($selection) > 0 ){
|
||||
foreach($mapsImport['lst'] as $id => $values){
|
||||
if( !in_array($id, $selection) ){
|
||||
unset($mapsImport['lst'][$id]);
|
||||
}
|
||||
}
|
||||
}
|
||||
else{
|
||||
foreach($mapsImport['lst'] as $id => $values){
|
||||
unset($mapsImport['lst'][$id]);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Enregistrement de la sélection du MatchSettings
|
||||
if($operation != 'getSelection'){
|
||||
AdminServ::saveMatchSettingSelection($mapsImport);
|
||||
}
|
||||
|
||||
$client->Terminate();
|
||||
}
|
||||
|
||||
// OUT
|
||||
if($operation == 'getSelection'){
|
||||
echo json_encode($mapsImport);
|
||||
}
|
||||
else{
|
||||
echo json_encode($_SESSION['adminserv']['matchset_maps_selected']);
|
||||
}
|
||||
?>
|
||||
160
assets/config/adminserv/maps-creatematchset.php
Normal file
160
assets/config/adminserv/maps-creatematchset.php
Normal file
@@ -0,0 +1,160 @@
|
||||
<?php
|
||||
// ENREGISTREMENT
|
||||
if( isset($_POST['savematchsetting']) && isset($_SESSION['adminserv']['matchset_maps_selected']) ){
|
||||
// Filename
|
||||
$matchSettingName = Str::replaceChars($_POST['matchSettingName']);
|
||||
$filename = $data['mapsDirectoryPath'].$args['directory'].$matchSettingName;
|
||||
if(File::getExtension($matchSettingName) != 'txt'){
|
||||
$filename .= '.txt';
|
||||
}
|
||||
|
||||
$struct = array();
|
||||
|
||||
// Gameinfos
|
||||
$gameinfos = AdminServ::getGameInfosStructFromPOST();
|
||||
$struct['gameinfos'] = array(
|
||||
'game_mode' => $gameinfos['GameMode'],
|
||||
'chat_time' => $gameinfos['ChatTime'],
|
||||
'finishtimeout' => $gameinfos['FinishTimeout'],
|
||||
'allwarmupduration' => $gameinfos['AllWarmUpDuration'],
|
||||
'disablerespawn' => $gameinfos['DisableRespawn'],
|
||||
'forceshowallopponents' => $gameinfos['ForceShowAllOpponents'],
|
||||
'rounds_pointslimit' => $gameinfos['RoundsPointsLimit'],
|
||||
'rounds_custom_points' => $gameinfos['RoundCustomPoints'],
|
||||
'rounds_usenewrules' => $gameinfos['RoundsUseNewRules'],
|
||||
'rounds_forcedlaps' => $gameinfos['RoundsForcedLaps'],
|
||||
'rounds_pointslimitnewrules' => $gameinfos['RoundsPointsLimitNewRules'],
|
||||
'team_pointslimit' => $gameinfos['TeamPointsLimit'],
|
||||
'team_maxpoints' => $gameinfos['TeamMaxPoints'],
|
||||
'team_usenewrules' => $gameinfos['TeamUseNewRules'],
|
||||
'team_pointslimitnewrules' => $gameinfos['TeamPointsLimitNewRules'],
|
||||
'timeattack_limit' => $gameinfos['TimeAttackLimit'],
|
||||
'timeattack_synchstartperiod' => $gameinfos['TimeAttackSynchStartPeriod'],
|
||||
'laps_nblaps' => $gameinfos['LapsNbLaps'],
|
||||
'laps_timelimit' => $gameinfos['LapsTimeLimit'],
|
||||
'cup_pointslimit' => $gameinfos['CupPointsLimit'],
|
||||
'cup_roundsperchallenge' => $gameinfos['CupRoundsPerMap'],
|
||||
'cup_nbwinners' => $gameinfos['CupNbWinners'],
|
||||
'cup_warmupduration' => $gameinfos['CupWarmUpDuration']
|
||||
);
|
||||
if(SERVER_VERSION_NAME != 'TmForever'){
|
||||
$struct['gameinfos']['script_name'] = $gameinfos['ScriptName'];
|
||||
}
|
||||
|
||||
// HotSeat
|
||||
$struct['hotseat'] = array(
|
||||
'game_mode' => intval($_POST['hotSeatGameMode']),
|
||||
'time_limit' => TimeDate::secToMillisec( intval($_POST['hotSeatTimeLimit']) ),
|
||||
'rounds_count' => intval($_POST['hotSeatCountRound'])
|
||||
);
|
||||
|
||||
// Filter
|
||||
$struct['filter'] = array(
|
||||
'is_lan' => array_key_exists('filterIsLan', $_POST),
|
||||
'is_internet' => array_key_exists('filterIsInternet', $_POST),
|
||||
'is_solo' => array_key_exists('filterIsSolo', $_POST),
|
||||
'is_hotseat' => array_key_exists('filterIsHotSeat', $_POST),
|
||||
'sort_index' => intval($_POST['filterSortIndex']),
|
||||
'random_map_order' => array_key_exists('filterRandomMaps', $_POST),
|
||||
'force_default_gamemode' => intval($_POST['filterDefaultGameMode']),
|
||||
);
|
||||
|
||||
// ScriptSettings (nur fuer ManiaPlanet/TM2, nicht fuer TmForever)
|
||||
// TmForever kennt die Methode 'GetModeScriptInfo' nicht (Fehler -506).
|
||||
if(SERVER_VERSION_NAME != 'TmForever'){
|
||||
if( !$client->query('GetModeScriptInfo') ){
|
||||
AdminServ::error();
|
||||
}
|
||||
else{
|
||||
$scriptsettings = $client->getResponse();
|
||||
|
||||
if( !empty($scriptsettings['ParamDescs']) ){
|
||||
foreach($scriptsettings['ParamDescs'] as $param){
|
||||
$struct['scriptsettings'][] = array(
|
||||
'name' => $param['Name'],
|
||||
'type' => $param['Type'],
|
||||
'value' => $param['Default']
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Maps
|
||||
$struct['startindex'] = 1;
|
||||
$maps = $_SESSION['adminserv']['matchset_maps_selected']['lst'];
|
||||
if( isset($maps) && is_array($maps) && !empty($maps) ){
|
||||
$mapsField = (SERVER_VERSION_NAME == 'TmForever') ? 'challenge' : 'map';
|
||||
foreach($maps as $id => $values){
|
||||
$struct[$mapsField][$values['UId']] = $values['FileName'];
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
// Enregistrement
|
||||
if( ($result = AdminServ::saveMatchSettings($filename, $struct)) !== true ){
|
||||
AdminServ::error(Utils::t('Unable to save the MatchSettings').' : '.$matchSettingName.' ('.$result.')');
|
||||
}
|
||||
else{
|
||||
$action = Utils::t('The MatchSettings "!matchSettingName" was successfully created in the folder', array('!matchSettingName' => $matchSettingName)).' : '.$data['mapsDirectoryPath'].$args['directory'];
|
||||
AdminServ::info($action);
|
||||
AdminServLogs::add('action', $action);
|
||||
Utils::redirection(false, '?p='.USER_PAGE .$hasDirectory);
|
||||
}
|
||||
}
|
||||
else{
|
||||
if( !isset($_GET['f']) ){
|
||||
unset($_SESSION['adminserv']['matchset_maps_selected']);
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
// LECTURE
|
||||
$data['directoryList'] = Folder::getArborescence($data['mapsDirectoryPath'], AdminServConfig::$MAPS_HIDDEN_FOLDERS, substr_count($data['mapsDirectoryPath'], '/'));
|
||||
$data['matchSettings'] = array();
|
||||
// Édition
|
||||
if( isset($_GET['f']) && $_GET['f'] != null ){
|
||||
$data['pageTitle'] = Utils::t('Edit');
|
||||
$data['matchSettings']['name'] = $_GET['f'];
|
||||
$matchSettingsData = AdminServ::getMatchSettingsData($data['mapsDirectoryPath'].$args['directory'].$data['matchSettings']['name']);
|
||||
$data['gameInfos'] = array(
|
||||
'curr' => null,
|
||||
'next' => $matchSettingsData['gameinfos']
|
||||
);
|
||||
unset($matchSettingsData['gameinfos']);
|
||||
$data['matchSettings'] += $matchSettingsData;
|
||||
if( isset($data['matchSettings']['maps']) ){
|
||||
$maps = AdminServ::getMapListFromMatchSetting($data['matchSettings']['maps']);
|
||||
$data['matchSettings']['nbm'] = $maps['nbm']['count'];
|
||||
$_SESSION['adminserv']['matchset_maps_selected'] = $maps;
|
||||
}
|
||||
else{
|
||||
$data['matchSettings']['nbm'] = 0;
|
||||
}
|
||||
}
|
||||
else{
|
||||
$data['pageTitle'] = Utils::t('Create');
|
||||
$data['matchSettings']['name'] = 'match_settings';
|
||||
$gameInfos = AdminServ::getGameInfos();
|
||||
$data['gameInfos'] = array(
|
||||
'curr' => null,
|
||||
'next' => $gameInfos['next']
|
||||
);
|
||||
$data['matchSettings']['hotseat'] = array(
|
||||
'GameMode' => 1,
|
||||
'TimeLimit' => 300000,
|
||||
'RoundsCount' => 5
|
||||
);
|
||||
$data['matchSettings']['filter'] = array(
|
||||
'IsLan' => 1,
|
||||
'IsInternet' => 1,
|
||||
'IsSolo' => 0,
|
||||
'IsHotseat' => 1,
|
||||
'SortIndex' => 1000,
|
||||
'RandomMapOrder' => 0,
|
||||
'ForceDefaultGameMode' => 1
|
||||
);
|
||||
$data['matchSettings']['StartIndex'] = 0;
|
||||
$data['matchSettings']['nbm'] = 0;
|
||||
}
|
||||
?>
|
||||
@@ -4,7 +4,7 @@
|
||||
<game_mode>1</game_mode>
|
||||
<chat_time>10000</chat_time>
|
||||
<finishtimeout>1</finishtimeout>
|
||||
<allwarmupduration>1</allwarmupduration>
|
||||
<allwarmupduration>0</allwarmupduration>
|
||||
<disablerespawn>0</disablerespawn>
|
||||
<forceshowallopponents>0</forceshowallopponents>
|
||||
<rounds_pointslimit>30</rounds_pointslimit>
|
||||
|
||||
@@ -35,7 +35,7 @@
|
||||
|
||||
<ladder_mode>%%SERVER_LADDER_MODE%%</ladder_mode> <!-- value between 'inactive', 'forced' (or '0', '1') -->
|
||||
<ladder_serverlimit_min>0</ladder_serverlimit_min> <!-- Those values will be clamped to the limits authorized on http://official.trackmania.com/tmf-ladderserver/ -->
|
||||
<ladder_serverlimit_max>50000</ladder_serverlimit_max>
|
||||
<ladder_serverlimit_max>%%SERVER_LADDER_LIMIT_MAX%%</ladder_serverlimit_max>
|
||||
|
||||
<enable_p2p_upload>True</enable_p2p_upload>
|
||||
<enable_p2p_download>True</enable_p2p_download>
|
||||
|
||||
56
assets/config/logrotate.conf
Normal file
56
assets/config/logrotate.conf
Normal file
@@ -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
|
||||
}
|
||||
135
assets/config/remotecp/plugins/CustomPoints/index.php
Normal file
135
assets/config/remotecp/plugins/CustomPoints/index.php
Normal file
@@ -0,0 +1,135 @@
|
||||
<?php
|
||||
/**
|
||||
* remoteCP 4
|
||||
* ütf-8 release
|
||||
*
|
||||
* @package remoteCP
|
||||
* @author hal.sascha
|
||||
* @copyright (c) 2006-2009
|
||||
* @version 4.0.3.5
|
||||
*
|
||||
* Patched by tmserver-docker:
|
||||
* - Bare-constant-Zugriffe (pt_custom, pt_points, ...) durch
|
||||
* defined()-Pruefungen ersetzt, um PHP 7.2+ Warnungen zu vermeiden.
|
||||
*/
|
||||
class CustomPoints extends rcp_plugin
|
||||
{
|
||||
public $display = 'side';
|
||||
public $title = 'Points';
|
||||
public $author = 'hal.ko.sascha';
|
||||
public $version = '4.0.3.5';
|
||||
public $nservstatus = array(2,3,4,5);
|
||||
public $vpermissions = array('editgamesettings');
|
||||
public $apermissions = array(
|
||||
'setPoints' => 'editgamesettings',
|
||||
'setPointsPreset' => 'editgamesettings'
|
||||
);
|
||||
public $presets;
|
||||
|
||||
public function onLoad()
|
||||
{
|
||||
$this->presets = Core::getObject('session')->loadXML(
|
||||
Core::getSetting('pluginpath') . $this->id . '/presets.xml'
|
||||
);
|
||||
}
|
||||
|
||||
public function onOutput()
|
||||
{
|
||||
$CustomPoints = array();
|
||||
|
||||
if (Core::getObject('gbx')->query('GetRoundCustomPoints')) {
|
||||
$CustomPoints = Core::getObject('gbx')->getResponse();
|
||||
}
|
||||
|
||||
if (!is_array($CustomPoints)) {
|
||||
$CustomPoints = array();
|
||||
}
|
||||
|
||||
if (!Core::getObject('session')->checkPerm('editgamesettings')) {
|
||||
return;
|
||||
}
|
||||
|
||||
echo "<form action='ajax.php' method='post' id='custompoints' name='custompoints' class='postcmd' rel='{$this->display}area'>";
|
||||
echo "<fieldset>";
|
||||
|
||||
echo "<div class='legend'>" . (defined('pt_custom') ? pt_custom : 'Custom Points') . "</div>";
|
||||
|
||||
echo "<div class='f-row'>
|
||||
<label for='points'>" . (defined('pt_points') ? pt_points : 'Points') . "</label>
|
||||
<div class='f-field'>
|
||||
<input type='text' name='points' id='points' value='" . implode(',', $CustomPoints) . "' />
|
||||
<div class='small'>" . (defined('pt_commasep') ? pt_commasep : 'Comma separated') . "</div>
|
||||
</div>";
|
||||
echo "</div>";
|
||||
|
||||
echo "</fieldset>";
|
||||
|
||||
echo "<input type='hidden' name='plugin' value='{$this->id}' />";
|
||||
echo "<input type='hidden' name='action' value='setPoints' />";
|
||||
echo "<button type='submit' title='" . (defined('ct_submit') ? ct_submit : 'Submit') . "' class='wide'>" . (defined('ct_submit') ? ct_submit : 'Submit') . "</button>";
|
||||
echo "</form>";
|
||||
|
||||
echo "<form action='ajax.php' method='post' id='custompointspreset' name='custompointspreset' class='postcmd' rel='{$this->display}area'>";
|
||||
echo "<fieldset>";
|
||||
|
||||
echo "<div class='legend'>" . (defined('pt_presets') ? pt_presets : 'Presets') . "</div>";
|
||||
|
||||
if ($this->presets && is_object($this->presets)) {
|
||||
foreach ($this->presets->children() as $preset) {
|
||||
|
||||
$name = isset($preset['name']) ? $preset['name'] : 'Preset';
|
||||
$points = isset($preset['points']) ? (string)$preset['points'] : '';
|
||||
|
||||
echo "<div class='f-row'>
|
||||
<label>{$name}</label>
|
||||
<div class='f-field'>";
|
||||
|
||||
echo "<input style='width:25px;' type='radio' name='preset' value='{$points}' /> ";
|
||||
|
||||
if (strlen($points) > 25) {
|
||||
echo substr($points, 0, 25) . "...";
|
||||
} else {
|
||||
echo $points;
|
||||
}
|
||||
|
||||
echo "</div>";
|
||||
echo "</div>";
|
||||
}
|
||||
}
|
||||
|
||||
echo "</fieldset>";
|
||||
|
||||
echo "<input type='hidden' name='plugin' value='{$this->id}' />";
|
||||
echo "<input type='hidden' name='action' value='setPointsPreset' />";
|
||||
echo "<button type='submit' title='" . (defined('ct_submit') ? ct_submit : 'Submit') . "' class='wide'>" . (defined('ct_submit') ? ct_submit : 'Submit') . "</button>";
|
||||
echo "</form>";
|
||||
}
|
||||
|
||||
public function setPoints()
|
||||
{
|
||||
if (!array_key_exists('points', $_REQUEST)) return;
|
||||
|
||||
$str = preg_replace("/[^0-9,]/", "", $_REQUEST['points']);
|
||||
$array = $this->makeIntArray(explode(',', $str));
|
||||
|
||||
Core::getObject('actions')->add('SetRoundCustomPoints', $array, true);
|
||||
}
|
||||
|
||||
public function setPointsPreset()
|
||||
{
|
||||
if (!array_key_exists('preset', $_REQUEST)) return;
|
||||
|
||||
$str = preg_replace("/[^0-9,]/", "", $_REQUEST['preset']);
|
||||
$array = $this->makeIntArray(explode(',', $str));
|
||||
|
||||
Core::getObject('actions')->add('SetRoundCustomPoints', $array, true);
|
||||
}
|
||||
|
||||
private function makeIntArray($array)
|
||||
{
|
||||
foreach ($array as $key => $value) {
|
||||
$array[$key] = (int)$value;
|
||||
}
|
||||
return $array;
|
||||
}
|
||||
}
|
||||
320
assets/config/remotecp/plugins/Mods/index.php
Normal file
320
assets/config/remotecp/plugins/Mods/index.php
Normal file
@@ -0,0 +1,320 @@
|
||||
<?php
|
||||
/**
|
||||
* remoteCP 4
|
||||
* ütf-8 release
|
||||
*
|
||||
* @package remoteCP
|
||||
* @author hal.sascha
|
||||
* @copyright (c) 2006-2009
|
||||
* @version 4.0.2.6
|
||||
*
|
||||
* Patch: foreach()-Warnungen behoben – leere Umgebungen (Island, Bay, …)
|
||||
* fuehrten zu "Invalid argument supplied for foreach()", weil
|
||||
* $this->mods['Env'] nicht initialisiert war.
|
||||
* Zusaetzlich bare-constant-Warnungen (pt_*) mit defined()-Pruefungen entschaerft.
|
||||
*/
|
||||
class Mods extends rcp_plugin
|
||||
{
|
||||
public $display = 'side';
|
||||
public $title = 'Mods';
|
||||
public $author = 'hal.ko.sascha';
|
||||
public $version = '4.0.3.5';
|
||||
public $nservstatus = array(2,3,4,5);
|
||||
public $vpermissions = array('editserversettings');
|
||||
public $apermissions = array(
|
||||
'setMods' => 'editserversettings',
|
||||
'setMusic' => 'editserversettings'
|
||||
);
|
||||
|
||||
private $mods = array();
|
||||
private $music = array();
|
||||
|
||||
/**
|
||||
* Alle bekannten Umgebungs-Keys mit leeren Arrays vorbelegen,
|
||||
* damit foreach() auch bei fehlenden Eintraegen nicht warnt.
|
||||
*/
|
||||
private function initModDefaults()
|
||||
{
|
||||
$envs = array('Stadium', 'Island', 'Bay', 'Coast', 'Speed', 'Alpine', 'Rally');
|
||||
foreach($envs as $env) {
|
||||
if(!isset($this->mods[$env])) {
|
||||
$this->mods[$env] = array();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
public function onLoadSettings($settings)
|
||||
{
|
||||
// Set defaults
|
||||
$this->mods = array();
|
||||
$this->music = array();
|
||||
|
||||
// Alle Umgebungen vorinitialisieren
|
||||
$this->initModDefaults();
|
||||
|
||||
// Read mods settings
|
||||
if(!$settings->mods) return;
|
||||
foreach($settings->mods->children() AS $env)
|
||||
{
|
||||
if(!$env) continue;
|
||||
$tmp = (string) $env->getName();
|
||||
if(!isset($this->mods[$tmp])) {
|
||||
$this->mods[$tmp] = array();
|
||||
}
|
||||
foreach($env->children() AS $item)
|
||||
{
|
||||
$this->mods[$tmp][] = array(
|
||||
'url' => (string) $item,
|
||||
'name' => (string) $item['name']
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
// Read music settings
|
||||
if(!$settings->music) return;
|
||||
foreach($settings->music->children() AS $song)
|
||||
{
|
||||
$this->music[] = array(
|
||||
'url' => (string) $song,
|
||||
'name' => (string) $song['name']
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
public function onOutput() {
|
||||
if(Core::getObject('gbx')->query('GetForcedMods')) {
|
||||
$ForcedMods = Core::getObject('gbx')->getResponse();
|
||||
|
||||
if(!empty($ForcedMods)) {
|
||||
echo "<fieldset>";
|
||||
echo "<div class='legend'>".(defined('pt_forcedmods') ? pt_forcedmods : 'Forced Mods')."</div>";
|
||||
if(is_array($ForcedMods['Mods'])) {
|
||||
foreach($ForcedMods['Mods'] as $mod)
|
||||
{
|
||||
echo "<div class='f-row'>
|
||||
<label>{$mod['Env']}</label>
|
||||
<div class='f-field'>". $this->getModName($mod['Env'], $mod['Url']) ."</div>";
|
||||
echo "</div>";
|
||||
}
|
||||
}
|
||||
echo "</fieldset>";
|
||||
}
|
||||
}
|
||||
|
||||
echo "<form action='ajax.php' method='post' id='forcemods' name='forcemods' class='postcmd' rel='{$this->display}area'>";
|
||||
echo "<fieldset>";
|
||||
echo "<div class='legend'>".(defined('pt_forcemods') ? pt_forcemods : 'Force Mods')."</div>";
|
||||
|
||||
// --- Stadium ---
|
||||
echo " <div class='f-row'>
|
||||
<label for='points'>".(defined('pt_stadium') ? pt_stadium : 'Stadium')."</label>
|
||||
<div class='f-field'>
|
||||
<select name='modstadium'>";
|
||||
echo "<option value='0'>".(defined('pt_none') ? pt_none : 'None')."</option>";
|
||||
if(!empty($this->mods['Stadium'])) {
|
||||
foreach($this->mods['Stadium'] AS $mod)
|
||||
{
|
||||
echo "<option value='{$mod['url']}'>{$mod['name']}</option>";
|
||||
}
|
||||
}
|
||||
echo " </select>
|
||||
</div>
|
||||
</div>";
|
||||
|
||||
// --- Island ---
|
||||
echo " <div class='f-row'>
|
||||
<label for='points'>".(defined('pt_island') ? pt_island : 'Island')."</label>
|
||||
<div class='f-field'>
|
||||
<select name='modisland'>";
|
||||
echo "<option value='0'>".(defined('pt_none') ? pt_none : 'None')."</option>";
|
||||
if(!empty($this->mods['Island'])) {
|
||||
foreach($this->mods['Island'] AS $mod)
|
||||
{
|
||||
echo "<option value='{$mod['url']}'>{$mod['name']}</option>";
|
||||
}
|
||||
}
|
||||
echo " </select>
|
||||
</div>
|
||||
</div>";
|
||||
|
||||
// --- Bay ---
|
||||
echo "<div class='f-row'>
|
||||
<label for='points'>".(defined('pt_bay') ? pt_bay : 'Bay')."</label>
|
||||
<div class='f-field'>
|
||||
<select name='modbay'>";
|
||||
echo "<option value='0'>".(defined('pt_none') ? pt_none : 'None')."</option>";
|
||||
if(!empty($this->mods['Bay'])) {
|
||||
foreach($this->mods['Bay'] AS $mod)
|
||||
{
|
||||
echo "<option value='{$mod['url']}'>{$mod['name']}</option>";
|
||||
}
|
||||
}
|
||||
echo " </select>
|
||||
</div>
|
||||
</div>";
|
||||
|
||||
// --- Coast ---
|
||||
echo " <div class='f-row'>
|
||||
<label for='points'>".(defined('pt_coast') ? pt_coast : 'Coast')."</label>
|
||||
<div class='f-field'>
|
||||
<select name='modcoast'>";
|
||||
echo "<option value='0'>".(defined('pt_none') ? pt_none : 'None')."</option>";
|
||||
if(!empty($this->mods['Coast'])) {
|
||||
foreach($this->mods['Coast'] AS $mod)
|
||||
{
|
||||
echo "<option value='{$mod['url']}'>{$mod['name']}</option>";
|
||||
}
|
||||
}
|
||||
echo " </select>
|
||||
</div>
|
||||
</div>";
|
||||
|
||||
// --- Speed ---
|
||||
echo " <div class='f-row'>
|
||||
<label for='points'>".(defined('pt_speed') ? pt_speed : 'Speed')."</label>
|
||||
<div class='f-field'>
|
||||
<select name='modspeed'>";
|
||||
echo "<option value='0'>".(defined('pt_none') ? pt_none : 'None')."</option>";
|
||||
if(!empty($this->mods['Speed'])) {
|
||||
foreach($this->mods['Speed'] AS $mod)
|
||||
{
|
||||
echo "<option value='{$mod['url']}'>{$mod['name']}</option>";
|
||||
}
|
||||
}
|
||||
echo " </select>
|
||||
</div>
|
||||
</div>";
|
||||
|
||||
// --- Alpine ---
|
||||
echo " <div class='f-row'>
|
||||
<label for='points'>".(defined('pt_alpine') ? pt_alpine : 'Alpine')."</label>
|
||||
<div class='f-field'>
|
||||
<select name='modalpine'>";
|
||||
echo "<option value='0'>".(defined('pt_none') ? pt_none : 'None')."</option>";
|
||||
if(!empty($this->mods['Alpine'])) {
|
||||
foreach($this->mods['Alpine'] AS $mod)
|
||||
{
|
||||
echo "<option value='{$mod['url']}'>{$mod['name']}</option>";
|
||||
}
|
||||
}
|
||||
echo " </select>
|
||||
</div>
|
||||
</div>";
|
||||
|
||||
// --- Rally ---
|
||||
echo " <div class='f-row'>
|
||||
<label for='points'>".(defined('pt_rally') ? pt_rally : 'Rally')."</label>
|
||||
<div class='f-field'>
|
||||
<select name='modrally'>";
|
||||
echo "<option value='0'>".(defined('pt_none') ? pt_none : 'None')."</option>";
|
||||
if(!empty($this->mods['Rally'])) {
|
||||
foreach($this->mods['Rally'] AS $mod)
|
||||
{
|
||||
echo "<option value='{$mod['url']}'>{$mod['name']}</option>";
|
||||
}
|
||||
}
|
||||
echo " </select>
|
||||
</div>
|
||||
</div>";
|
||||
|
||||
echo " <div class='f-row'>
|
||||
<label for='DisableAllMods'>".(defined('pt_disableall') ? pt_disableall : 'Disable All')."</label>
|
||||
<div class='f-field'><input type='checkbox' class='checkbox' name='DisableAllMods' /></div>
|
||||
</div>";
|
||||
echo "</fieldset>";
|
||||
echo "<input type='hidden' name='plugin' value='{$this->id}' />";
|
||||
echo "<input type='hidden' name='action' value='setMods' />";
|
||||
echo "<button type='submit' title='".(defined('ct_submit') ? ct_submit : 'Submit')."' class='wide'>".(defined('ct_submit') ? ct_submit : 'Submit')."</button>";
|
||||
echo "</form>";
|
||||
|
||||
if(Core::getObject('gbx')->query('GetForcedMusic')) {
|
||||
$ForcedMusic = Core::getObject('gbx')->getResponse();
|
||||
|
||||
if(!empty($ForcedMusic)) {
|
||||
echo "<fieldset>";
|
||||
echo "<div class='legend'>".(defined('pt_forcedmusic') ? pt_forcedmusic : 'Forced Music')."</div>";
|
||||
echo "<div class='f-row'>
|
||||
<label>{$ForcedMusic['File']}</label>
|
||||
<div class='f-field'>{$ForcedMusic['Url']}</div>";
|
||||
echo "</div>";
|
||||
echo "</fieldset>";
|
||||
}
|
||||
}
|
||||
|
||||
echo "<form action='ajax.php' method='post' id='forcemusic' name='forcemusic' class='postcmd' rel='{$this->display}area'>";
|
||||
echo "<fieldset>";
|
||||
echo "<div class='legend'>".(defined('pt_forcemusic') ? pt_forcemusic : 'Force Music')."</div>";
|
||||
echo "<div class='f-row'>
|
||||
<label for='song'>".(defined('pt_song') ? pt_song : 'Song')."</label>
|
||||
<div class='f-field'>
|
||||
<select name='song'>";
|
||||
if(!empty($this->music)) {
|
||||
foreach($this->music AS $song)
|
||||
{
|
||||
echo "<option value='{$song['url']}'>{$song['name']}</option>";
|
||||
}
|
||||
}
|
||||
echo " </select>
|
||||
</div>";
|
||||
echo " <div class='f-row'>
|
||||
<label for='DisableAllMusic'>".(defined('pt_disableall') ? pt_disableall : 'Disable All')."</label>
|
||||
<div class='f-field'><input type='checkbox' class='checkbox' name='DisableAllMusic' /></div>
|
||||
</div>";
|
||||
echo "</fieldset>";
|
||||
echo "<input type='hidden' name='plugin' value='{$this->id}' />";
|
||||
echo "<input type='hidden' name='action' value='setMusic' />";
|
||||
echo "<button type='submit' title='".(defined('ct_submit') ? ct_submit : 'Submit')."' class='wide'>".(defined('ct_submit') ? ct_submit : 'Submit')."</button>";
|
||||
echo "</form>";
|
||||
}
|
||||
|
||||
public function setMods()
|
||||
{
|
||||
$array = array();
|
||||
$override = true;
|
||||
if(!array_key_exists('DisableAllMods', $_REQUEST)) {
|
||||
if(!empty($_REQUEST['modstadium']))
|
||||
$array[] = array('Env' => 'Stadium', 'Url' => $_REQUEST['modstadium']);
|
||||
if(!empty($_REQUEST['modisland']))
|
||||
$array[] = array('Env' => 'Island' , 'Url' => $_REQUEST['modisland']);
|
||||
if(!empty($_REQUEST['modbay']))
|
||||
$array[] = array('Env' => 'Bay' , 'Url' => $_REQUEST['modbay']);
|
||||
if(!empty($_REQUEST['modcoast']))
|
||||
$array[] = array('Env' => 'Coast' , 'Url' => $_REQUEST['modcoast']);
|
||||
if(!empty($_REQUEST['modspeed']))
|
||||
$array[] = array('Env' => 'Speed' , 'Url' => $_REQUEST['modspeed']);
|
||||
if(!empty($_REQUEST['modalpine']))
|
||||
$array[] = array('Env' => 'Alpine' , 'Url' => $_REQUEST['modalpine']);
|
||||
if(!empty($_REQUEST['modrally']))
|
||||
$array[] = array('Env' => 'Rally' , 'Url' => $_REQUEST['modrally']);
|
||||
} else {
|
||||
$override = false;
|
||||
}
|
||||
Core::getObject('actions')->add('SetForcedMods', $override, $array);
|
||||
}
|
||||
|
||||
public function setMusic()
|
||||
{
|
||||
$url = '';
|
||||
$override = true;
|
||||
if(!array_key_exists('DisableAllMusic', $_REQUEST)) {
|
||||
$url = $_REQUEST['song'];
|
||||
} else {
|
||||
$override = false;
|
||||
}
|
||||
Core::getObject('actions')->add('SetForcedMusic', $override, $url);
|
||||
}
|
||||
|
||||
private function getModName($env, $url)
|
||||
{
|
||||
if(!isset($this->mods[$env]) || !is_array($this->mods[$env])) {
|
||||
return '';
|
||||
}
|
||||
foreach($this->mods[$env] AS $value)
|
||||
{
|
||||
if($url == $value['url']) {
|
||||
return $value['name'];
|
||||
}
|
||||
}
|
||||
return '';
|
||||
}
|
||||
}
|
||||
93
assets/config/remotecp/plugins/Mods/settings.xml
Normal file
93
assets/config/remotecp/plugins/Mods/settings.xml
Normal file
@@ -0,0 +1,93 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<settings>
|
||||
<mods>
|
||||
<!-- Mods fuer die Stadium-Umgebung -->
|
||||
<!-- Alle Mods werden von https://assets.techniverse.net/tm/skins/ bereitgestellt -->
|
||||
<Stadium>
|
||||
<item name='A Romanorum Superbia'>https://assets.techniverse.net/tm/skins/ARomanorumSuperbia.zip</item>
|
||||
<item name='Bluemod'>https://assets.techniverse.net/tm/skins/Bluemod.zip</item>
|
||||
<item name='Candy Box II'>https://assets.techniverse.net/tm/skins/CANDY_BOX_II.zip</item>
|
||||
<item name='Egyptian Stadium'>https://assets.techniverse.net/tm/skins/Egyptian_Stadium.zip</item>
|
||||
<item name='FC Mod'>https://assets.techniverse.net/tm/skins/FC-mod.zip</item>
|
||||
<item name='Forest Mod'>https://assets.techniverse.net/tm/skins/FoResT_MoD.zip</item>
|
||||
<item name='Imperial Palace'>https://assets.techniverse.net/tm/skins/ImperialPalace.zip</item>
|
||||
<item name='Inca 3'>https://assets.techniverse.net/tm/skins/Inca3.zip</item>
|
||||
<item name='Jurassic Park'>https://assets.techniverse.net/tm/skins/JurassicPark.zip</item>
|
||||
<item name='LMDS Matrix'>https://assets.techniverse.net/tm/skins/LMDSMatrix.zip</item>
|
||||
<item name='Lego Mod'>https://assets.techniverse.net/tm/skins/LegoMod.zip</item>
|
||||
<item name='Lego Mod v2'>https://assets.techniverse.net/tm/skins/LegoModv2.zip</item>
|
||||
<item name='Lego City'>https://assets.techniverse.net/tm/skins/Lego_City.zip</item>
|
||||
<item name='Mario Mod'>https://assets.techniverse.net/tm/skins/MarioMod.zip</item>
|
||||
<item name='Moon Base'>https://assets.techniverse.net/tm/skins/MoonBase.zip</item>
|
||||
<item name='Portal'>https://assets.techniverse.net/tm/skins/Portal.zip</item>
|
||||
<item name='Quantum Leap'>https://assets.techniverse.net/tm/skins/QuantumLeap.zip</item>
|
||||
<item name='RDV Urban 01'>https://assets.techniverse.net/tm/skins/RDV-Urban01.zip</item>
|
||||
<item name='Rainbow Road'>https://assets.techniverse.net/tm/skins/Rainbow%20Road.zip</item>
|
||||
<item name='Star Wars Mod'>https://assets.techniverse.net/tm/skins/StarWarsMod.zip</item>
|
||||
<item name='The Pirate Bay'>https://assets.techniverse.net/tm/skins/ThePirateBay.zip</item>
|
||||
<item name='Toxic'>https://assets.techniverse.net/tm/skins/Toxic.zip</item>
|
||||
<item name='Transparence V1'>https://assets.techniverse.net/tm/skins/TransparenceV1.zip</item>
|
||||
<item name='Western Fortress'>https://assets.techniverse.net/tm/skins/WesternFortress.zip</item>
|
||||
<item name='Wood Mod'>https://assets.techniverse.net/tm/skins/Wood%20Mod.zip</item>
|
||||
<item name='Wooden Domnann'>https://assets.techniverse.net/tm/skins/Wooden%20Domnann.zip</item>
|
||||
<item name='Xmas'>https://assets.techniverse.net/tm/skins/Xmas.zip</item>
|
||||
<item name='N64 Rainbow Road'>https://assets.techniverse.net/tm/skins/_N64_%20Rainbow%20Road.zip</item>
|
||||
<item name='Blue Light'>https://assets.techniverse.net/tm/skins/bluelight.zip</item>
|
||||
<item name='Blue Water'>https://assets.techniverse.net/tm/skins/bluewater.zip</item>
|
||||
<item name='Construct'>https://assets.techniverse.net/tm/skins/construct.zip</item>
|
||||
<item name='Dark Mirror'>https://assets.techniverse.net/tm/skins/darkmirror.zip</item>
|
||||
<item name='Formel 1'>https://assets.techniverse.net/tm/skins/formel1.zip</item>
|
||||
<item name='Future'>https://assets.techniverse.net/tm/skins/future.zip</item>
|
||||
<item name='Hypercube'>https://assets.techniverse.net/tm/skins/hypercube.zip</item>
|
||||
<item name='Icebreaker'>https://assets.techniverse.net/tm/skins/icebraker.zip</item>
|
||||
<item name='Just Black'>https://assets.techniverse.net/tm/skins/justblack.zip</item>
|
||||
<item name='Lego II'>https://assets.techniverse.net/tm/skins/lego_II.zip</item>
|
||||
<item name='Mars'>https://assets.techniverse.net/tm/skins/mars.zip</item>
|
||||
<item name='Modernizer'>https://assets.techniverse.net/tm/skins/modernizer.zip</item>
|
||||
<item name='Neon Glow'>https://assets.techniverse.net/tm/skins/neonglow.zip</item>
|
||||
<item name='Pioneer'>https://assets.techniverse.net/tm/skins/pioneer.zip</item>
|
||||
<item name='Push'>https://assets.techniverse.net/tm/skins/push.zip</item>
|
||||
<item name='Puzzle'>https://assets.techniverse.net/tm/skins/puzzle.zip</item>
|
||||
<item name='Robot Mod 2'>https://assets.techniverse.net/tm/skins/robotmod2.zip</item>
|
||||
<item name='Rubik'>https://assets.techniverse.net/tm/skins/rubik.zip</item>
|
||||
<item name='Smarties'>https://assets.techniverse.net/tm/skins/smarties.zip</item>
|
||||
<item name='Sonic'>https://assets.techniverse.net/tm/skins/sonic.zip</item>
|
||||
<item name='Stadium 2010'>https://assets.techniverse.net/tm/skins/stadium2010.zip</item>
|
||||
<item name='Stadium Storm'>https://assets.techniverse.net/tm/skins/stadium_storm_mod.zip</item>
|
||||
<item name='Tomb'>https://assets.techniverse.net/tm/skins/tomb.zip</item>
|
||||
<item name='Tron Blue'>https://assets.techniverse.net/tm/skins/tronblue.zip</item>
|
||||
<item name='Tron Green'>https://assets.techniverse.net/tm/skins/trongreen.zip</item>
|
||||
<item name='Tron Red'>https://assets.techniverse.net/tm/skins/tronred.zip</item>
|
||||
<item name='Tron Yellow'>https://assets.techniverse.net/tm/skins/tronyellow.zip</item>
|
||||
<item name='Wipeout'>https://assets.techniverse.net/tm/skins/wipeout.zip</item>
|
||||
</Stadium>
|
||||
|
||||
<!-- Mods fuer die Island-Umgebung -->
|
||||
<Island>
|
||||
</Island>
|
||||
|
||||
<!-- Mods fuer die Bay-Umgebung -->
|
||||
<Bay>
|
||||
</Bay>
|
||||
|
||||
<!-- Mods fuer die Coast-Umgebung -->
|
||||
<Coast>
|
||||
</Coast>
|
||||
|
||||
<!-- Mods fuer die Speed-Umgebung -->
|
||||
<Speed>
|
||||
</Speed>
|
||||
|
||||
<!-- Mods fuer die Alpine-Umgebung -->
|
||||
<Alpine>
|
||||
</Alpine>
|
||||
|
||||
<!-- Mods fuer die Rally-Umgebung -->
|
||||
<Rally>
|
||||
</Rally>
|
||||
</mods>
|
||||
<music>
|
||||
<!-- Musik-URLs hier eintragen -->
|
||||
<!-- <item name='Songname'>https://example.com/song.ogg</item> -->
|
||||
</music>
|
||||
</settings>
|
||||
23
assets/config/xaseco/teamspeak3.xml
Normal file
23
assets/config/xaseco/teamspeak3.xml
Normal file
@@ -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>
|
||||
@@ -1,10 +1,11 @@
|
||||
services:
|
||||
tmserver:
|
||||
image: git.techniverse.net/scriptos/trackmania-server:1.0.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
|
||||
@@ -12,7 +13,6 @@ services:
|
||||
- "${SERVER_PORT:-2350}:${SERVER_PORT:-2350}/tcp"
|
||||
- "${SERVER_PORT:-2350}:${SERVER_PORT:-2350}/udp"
|
||||
- "${SERVER_P2P_PORT:-3450}:${SERVER_P2P_PORT:-3450}/tcp"
|
||||
- "${SERVER_XMLRPC_PORT:-5000}:${SERVER_XMLRPC_PORT:-5000}/tcp"
|
||||
- "80:80/tcp"
|
||||
env_file:
|
||||
- .env
|
||||
@@ -32,9 +32,14 @@ services:
|
||||
- .env
|
||||
environment:
|
||||
MYSQL_ROOT_PASSWORD: ${MARIADB_ROOT_PASSWORD}
|
||||
# RemoteCP-Datenbank (via MariaDB-Init)
|
||||
MYSQL_DATABASE: ${REMOTECP_DB_NAME:-remotecp}
|
||||
MYSQL_USER: ${REMOTECP_DB_USER:-remotecp}
|
||||
MYSQL_PASSWORD: ${REMOTECP_DB_PASSWORD}
|
||||
# XAseco-Datenbank (via Init-Script init-xaseco-db.sh)
|
||||
XASECO_DB_NAME: ${XASECO_DB_NAME:-xaseco}
|
||||
XASECO_DB_USER: ${XASECO_DB_USER:-xaseco}
|
||||
XASECO_DB_PASSWORD: ${XASECO_DB_PASSWORD}
|
||||
volumes:
|
||||
- ./data/mariadb:/var/lib/mysql
|
||||
- ./assets/db/init-xaseco-db.sh:/docker-entrypoint-initdb.d/20-init-xaseco-db.sh:ro
|
||||
@@ -48,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
|
||||
|
||||
@@ -9,10 +9,62 @@
|
||||
| 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 |
|
||||
| [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
|
||||
│ │ ├── RunTrackmaniaServer.sh # Container-Startscript
|
||||
│ │ ├── 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)
|
||||
│ │ ├── 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
|
||||
├── .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)
|
||||
├── gamedata/ # TM-Server-Daten
|
||||
├── controlpanel/ # AdminServ + RemoteCP
|
||||
├── xaseco/ # XAseco-Konfiguration und Logs
|
||||
└── mariadb/ # MariaDB-Datenbankdateien
|
||||
```
|
||||
|
||||
@@ -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:
|
||||
@@ -66,3 +72,45 @@ rm -rf ./data/controlpanel/*
|
||||
# Container neu starten – AdminServ wird frisch initialisiert
|
||||
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.
|
||||
|
||||
### Falscher Pfad in MatchSettings-Dateien
|
||||
|
||||
Beim Erstellen einer neuen MatchSettings-Datei über AdminServ wurden die Track-Pfade falsch geschrieben. Statt des tatsächlichen Ordners (z.B. `Challenges/Downloaded/`) wurde immer der Speicherort der MatchSettings (`MatchSettings/`) als Pfad-Präfix verwendet:
|
||||
|
||||
```xml
|
||||
<!-- Fehlerhaft (Original) -->
|
||||
<file>MatchSettings/speed vs. fullspeed.Challenge.Gbx</file>
|
||||
|
||||
<!-- Korrekt (nach Patch) -->
|
||||
<file>Challenges/Downloaded/speed vs. fullspeed.Challenge.Gbx</file>
|
||||
```
|
||||
|
||||
**Ursache:** Die AJAX-Funktion `get_matchset_mapimport.php` hat den URL-Parameter `d` (= MatchSettings-Speicherordner) als relativen Pfad für die Map-Dateinamen verwendet, anstatt den tatsächlichen Ordner aus der Dropdown-Auswahl zu berechnen.
|
||||
|
||||
**Betroffene Datei:** `resources/ajax/get_matchset_mapimport.php`
|
||||
|
||||
### GetModeScriptInfo-Fehler (-506)
|
||||
|
||||
Beim Speichern einer MatchSettings-Datei erschien die Fehlermeldung:
|
||||
|
||||
```
|
||||
[-506] Method 'GetModeScriptInfo' not defined
|
||||
```
|
||||
|
||||
**Ursache:** `GetModeScriptInfo` ist eine XML-RPC-Methode, die nur in ManiaPlanet/TM2 existiert. AdminServ hat sie ohne Versionsprüfung aufgerufen. An anderen Stellen im Code wurde korrekt mit `SERVER_VERSION_NAME != 'TmForever'` unterschieden – nur hier fehlte die Prüfung.
|
||||
|
||||
**Betroffene Datei:** `resources/process/maps-creatematchset.php`
|
||||
|
||||
36
docs/ip-watcher.md
Normal file
36
docs/ip-watcher.md
Normal file
@@ -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.
|
||||
@@ -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
|
||||
@@ -88,7 +89,7 @@ docker run -d \
|
||||
-v ./data/gamedata:/opt/tmserver/GameData \
|
||||
-v ./data/controlpanel:/var/www/html \
|
||||
-v ./data/xaseco:/opt/tmserver/xaseco \
|
||||
--name tmserver tmserver:latest
|
||||
--name tmserver git.techniverse.net/scriptos/trackmania-server:latest
|
||||
```
|
||||
|
||||
> **Achtung:** Bei `FORCE_CONFIG_UPDATE=true` wird die `dedicated_cfg.txt` komplett aus dem Template neu erzeugt und alle Platzhalter mit den aktuellen Umgebungsvariablen ersetzt. **Manuelle Änderungen an der Config gehen dabei verloren!** Andere Dateien im GameData-Volume (Tracks, Skins, Scores, etc.) bleiben erhalten. Nach dem Update sollte `FORCE_CONFIG_UPDATE` wieder auf `false` gesetzt werden.
|
||||
@@ -103,6 +104,138 @@ Der Ordner `GameData/Config/` enthält:
|
||||
| `blacklist.txt` | Liste gesperrter Spieler |
|
||||
| `guestlist.txt` | Liste erlaubter Spieler |
|
||||
| `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.
|
||||
|
||||
**Ablauf:**
|
||||
|
||||
1. In AdminServ unter „Server Options" die gewünschten Einstellungen ändern und „Export" klicken
|
||||
2. Die exportierte Datei wird in `GameData/Config/AdminServ/ServerOptions/` gespeichert
|
||||
3. Beim nächsten Start des Containers wird die **neueste** Export-Datei erkannt
|
||||
4. Die darin enthaltenen Werte werden in die `dedicated_cfg.txt` geschrieben
|
||||
|
||||
**Unterstützte Felder:**
|
||||
|
||||
| AdminServ-Feld | dedicated_cfg.txt-Feld |
|
||||
|----------------|----------------------|
|
||||
| `Name` | `<name>` |
|
||||
| `Comment` | `<comment>` |
|
||||
| `HideServer` | `<hide_server>` |
|
||||
| `NextMaxPlayers` | `<max_players>` |
|
||||
| `Password` | `<password>` |
|
||||
| `PasswordForSpectator` | `<password_spectator>` |
|
||||
| `NextMaxSpectators` | `<max_spectators>` |
|
||||
| `NextLadderMode` | `<ladder_mode>` |
|
||||
| `NextCallVoteTimeOut` | `<callvote_timeout>` |
|
||||
| `CallVoteRatio` | `<callvote_ratio>` |
|
||||
| `AllowChallengeDownload` | `<allow_challenge_download>` |
|
||||
| `AutoSaveReplays` | `<autosave_replays>` |
|
||||
| `IsP2PUpload` | `<enable_p2p_upload>` |
|
||||
| `IsP2PDownload` | `<enable_p2p_download>` |
|
||||
|
||||
> **Hinweis:** Die AdminServ-Exports haben **Vorrang** vor den Werten aus den Umgebungsvariablen. Beim ersten Start werden zunächst die Umgebungsvariablen angewendet, danach die AdminServ-Exports (falls vorhanden). Bei weiteren Starts werden nur die AdminServ-Exports angewendet.
|
||||
|
||||
## Wichtige Parameter in der dedicated_cfg.txt
|
||||
|
||||
@@ -127,3 +260,49 @@ Alle diese Parameter können über [Umgebungsvariablen](umgebungsvariablen.md) g
|
||||
| `<xmlrpc_port>` | `SERVER_XMLRPC_PORT` | `5000` |
|
||||
| `<connection_uploadrate>` | `SERVER_UPLOAD_RATE` | `512` |
|
||||
| `<connection_downloadrate>` | `SERVER_DOWNLOAD_RATE` | `8192` |
|
||||
|
||||
## MatchSettings (Spieleinstellungen)
|
||||
|
||||
Die MatchSettings-Dateien liegen im Verzeichnis `data/gamedata/Tracks/MatchSettings/` und definieren Spielmodus, Regeln und die aktive Track-Liste des Servers. Sie werden als `.txt`-Dateien im XML-Format gespeichert.
|
||||
|
||||
### Automatische Erkennung (Standard)
|
||||
|
||||
Standardmäßig wird beim Serverstart automatisch die **neueste** `.txt`-Datei im MatchSettings-Ordner anhand des Änderungsdatums geladen. So werden z.B. über AdminServ erstellte oder bearbeitete MatchSettings beim nächsten Neustart automatisch aktiv.
|
||||
|
||||
```bash
|
||||
# In der .env-Datei (Standardwert):
|
||||
MATCHSETTINGS_FILE=auto
|
||||
```
|
||||
|
||||
**Ablauf bei jedem Containerstart:**
|
||||
|
||||
1. Der Ordner `data/gamedata/Tracks/MatchSettings/` wird nach `.txt`-Dateien durchsucht
|
||||
2. Die Datei mit dem neuesten Änderungsdatum wird ermittelt
|
||||
3. Diese Datei wird als `/game_settings`-Parameter an den TM-Server übergeben
|
||||
4. Dateiname und Änderungsdatum werden in der Konsole ausgegeben
|
||||
|
||||
### Bestimmte Datei verwenden
|
||||
|
||||
Alternativ kann eine bestimmte MatchSettings-Datei direkt angegeben werden:
|
||||
|
||||
```bash
|
||||
# In der .env-Datei:
|
||||
MATCHSETTINGS_FILE=turnier_settings.txt
|
||||
```
|
||||
|
||||
Der Dateiname bezieht sich immer auf den Ordner `data/gamedata/Tracks/MatchSettings/`.
|
||||
|
||||
### Fallback
|
||||
|
||||
Falls die angegebene oder automatisch ermittelte Datei nicht existiert, wird auf die mitgelieferte Standard-Datei `custom_game_settings.txt` zurückgefallen.
|
||||
|
||||
### Neue MatchSettings über AdminServ erstellen
|
||||
|
||||
1. In AdminServ mit SuperAdmin einloggen
|
||||
2. Unter „Maps" → „MatchSettings" → „Create" eine neue Datei anlegen
|
||||
3. Tracks aus den gewünschten Ordnern importieren (z.B. `Challenges/Downloaded/`)
|
||||
4. Spielmodus und Regeln konfigurieren
|
||||
5. Speichern – die Datei wird in `MatchSettings/` abgelegt
|
||||
6. Container neustarten (`docker compose restart`) – die neue Datei wird automatisch als neueste erkannt und geladen
|
||||
|
||||
> **Hinweis:** Die aktive MatchSettings-Datei wird beim Serverstart in der Konsole ausgegeben. Mit `docker logs tmserver` kann überprüft werden, welche Datei geladen wurde.
|
||||
|
||||
@@ -5,7 +5,7 @@
|
||||
| 2350 | TCP | Gameserver-Port |
|
||||
| 2350 | UDP | Gameserver-Port |
|
||||
| 3450 | TCP | P2P-Gameserver-Port |
|
||||
| 5000 | TCP | XML-RPC-Port (interne Kommunikation) |
|
||||
| 5000 | TCP | XML-RPC-Port (nur containerintern, nicht nach außen freigegeben) |
|
||||
| 80 | TCP | Server-Verwaltungsoberflächen (AdminServ + RemoteCP) |
|
||||
|
||||
## Minimale Port-Freigabe
|
||||
@@ -20,7 +20,19 @@ docker run -d \
|
||||
-p 3450:3450/tcp \
|
||||
-v ./data/gamedata:/opt/tmserver/GameData \
|
||||
-v ./data/xaseco:/opt/tmserver/xaseco \
|
||||
--name tmserver tmserver:latest
|
||||
--name tmserver git.techniverse.net/scriptos/trackmania-server:latest
|
||||
```
|
||||
|
||||
> **Hinweis:** Port 5000 (XML-RPC) wird intern von AdminServ verwendet und muss in der Regel nicht nach außen freigegeben werden.
|
||||
> **Hinweis:** Port 5000 (XML-RPC) wird containerintern von AdminServ, RemoteCP und XAseco verwendet und ist standardmäßig **nicht** nach außen freigegeben.
|
||||
>
|
||||
> Falls du den XML-RPC-Port extern benötigst (z. B. für ein externes Tool außerhalb des Containers), kannst du ihn nachträglich in der `docker-compose.yml` unter `ports:` ergänzen:
|
||||
>
|
||||
> ```yaml
|
||||
> - "${SERVER_XMLRPC_PORT:-5000}:${SERVER_XMLRPC_PORT:-5000}/tcp"
|
||||
> ```
|
||||
>
|
||||
> Bzw. bei `docker run`:
|
||||
>
|
||||
> ```bash
|
||||
> -p 5000:5000/tcp
|
||||
> ```
|
||||
|
||||
@@ -93,6 +93,61 @@ Die Konfigurationsdateien befinden sich unter `./data/controlpanel/remotecp/xml/
|
||||
| `admins.xml` | Benutzer und Zugangsdaten |
|
||||
| `groups.xml` | Berechtigungsgruppen |
|
||||
|
||||
## Mods / Skins
|
||||
|
||||
RemoteCP enthält ein **Mods-Plugin**, mit dem Texturpakete (Skins) pro Spielumgebung auf dem Server forciert werden können. Spieler laden den jeweiligen Mod automatisch beim Betreten des Servers herunter.
|
||||
|
||||
### Wie funktionieren Mods?
|
||||
|
||||
In TrackMania Forever sind Mods ZIP-Archive mit alternativen Texturen für eine Spielumgebung (Stadium, Island, Bay, etc.). Der Ablauf:
|
||||
|
||||
1. Der Mod liegt als `.zip`-Datei auf einem **Webserver**, der für die Spieler erreichbar ist
|
||||
2. Der Serveradmin forciert den Mod über den XML-RPC-Befehl `SetForcedMods` (pro Umgebung eine URL)
|
||||
3. Wenn ein Spieler dem Server beitritt, lädt sein Client den Mod automatisch von der angegebenen URL herunter
|
||||
4. Mods sind **flüchtig** – nach einem Serverneustart müssen sie erneut gesetzt werden (das Startup-Script übernimmt das automatisch, siehe unten)
|
||||
|
||||
### Vorkonfigurierte Skin-Bibliothek
|
||||
|
||||
Das Image wird mit einer vorkonfigurierten Skin-Bibliothek ausgeliefert, die über **50 Skins** für die Stadium-Umgebung enthält. Alle Skins werden von [assets.techniverse.net](https://assets.techniverse.net/tm/skins/) bereitgestellt und sind im RemoteCP-Mods-Plugin als Dropdown-Auswahl verfügbar.
|
||||
|
||||
Die Konfiguration befindet sich unter:
|
||||
|
||||
| Host-Pfad | Container-Pfad | Beschreibung |
|
||||
|-----------|----------------|-------------|
|
||||
| `./data/controlpanel/remotecp/plugins/Mods/settings.xml` | `/var/www/html/remotecp/plugins/Mods/settings.xml` | Mod-Katalog (URLs pro Umgebung) |
|
||||
|
||||
> **Hinweis:** Bei bestehenden Installationen (Volumes) wird die alte Standard-`settings.xml` (mit den Original-Beispiel-URLs von blacksunonline.com) beim nächsten Containerstart automatisch durch die neue Version mit den techniverse.net-Skins ersetzt.
|
||||
|
||||
### Mods über RemoteCP verwalten
|
||||
|
||||
1. RemoteCP öffnen: `http://<host-ip>/remotecp/`
|
||||
2. Mit SuperAdmin-Zugangsdaten einloggen
|
||||
3. Im Seitenmenü das **Mods**-Plugin aufrufen
|
||||
4. Pro Umgebung (Stadium, Island, etc.) einen Skin aus dem Dropdown auswählen
|
||||
5. "Submit" klicken – der Mod wird sofort auf dem Server aktiviert
|
||||
|
||||
### Mods automatisch beim Start forcieren
|
||||
|
||||
Über die Umgebungsvariablen `FORCE_MOD_*` kann ein Mod pro Umgebung automatisch bei **jedem** Containerstart gesetzt werden – unabhängig von `FORCE_CONFIG_UPDATE`. Siehe [Umgebungsvariablen – Forced Mods](umgebungsvariablen.md#forced-mods-skins) für Details.
|
||||
|
||||
**Beispiel** (in der `.env`-Datei):
|
||||
|
||||
```bash
|
||||
FORCE_MOD_STADIUM=https://assets.techniverse.net/tm/skins/Portal.zip
|
||||
```
|
||||
|
||||
### Eigene Skins hinzufügen
|
||||
|
||||
Um eigene Skins in das RemoteCP-Dropdown aufzunehmen, bearbeite die Datei `data/controlpanel/remotecp/plugins/Mods/settings.xml` und füge innerhalb der gewünschten Umgebung einen neuen Eintrag hinzu:
|
||||
|
||||
```xml
|
||||
<Stadium>
|
||||
<item name='Mein Skin'>https://example.com/mods/mein_skin.zip</item>
|
||||
</Stadium>
|
||||
```
|
||||
|
||||
> **Wichtig:** Die ZIP-Datei muss von den Spielern über HTTP/HTTPS erreichbar sein.
|
||||
|
||||
## Sicherheit
|
||||
|
||||
RemoteCP liefert eine `.htaccess`-Datei mit, die den direkten Zugriff auf XML-Konfigurationsdateien über den Browser verhindert. Apache `mod_rewrite` und `AllowOverride` sind im Image aktiviert, damit dieser Schutz funktioniert.
|
||||
@@ -112,4 +167,4 @@ Falls RemoteCP nicht erreichbar ist oder Fehler anzeigt:
|
||||
|
||||
- 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
|
||||
- Die Live-Funktionen (`remoteCP[Live]`) benötigen eine laufende Serververbindung
|
||||
- Die Registrierung neuer Benutzer ist standardmäßig aktiviert und kann in `xml/settings/settings.xml` über `<register>false</register>` deaktiviert werden
|
||||
- **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
|
||||
|
||||
@@ -18,24 +18,40 @@ Bearbeite die `.env`-Datei und setze mindestens die gewünschten Passwörter. F
|
||||
|
||||
> **Wichtig:** Die `.env`-Datei enthält sensible Daten (Passwörter, Keys) und wird über die `.gitignore` vom Einchecken ausgeschlossen.
|
||||
|
||||
## 2. Docker Image bauen
|
||||
## 2. Server starten
|
||||
|
||||
```bash
|
||||
docker build -t tmserver:latest -t tmserver:1.0.0 .
|
||||
### Fertiges Docker Image verwenden (empfohlen)
|
||||
|
||||
Es steht ein fertiges Docker Image in der Container-Registry bereit – kein eigener Build nötig:
|
||||
|
||||
```
|
||||
git.techniverse.net/scriptos/trackmania-server:latest
|
||||
```
|
||||
|
||||
Damit wird das Image mit zwei Tags erstellt: `tmserver:latest` und `tmserver:1.0.0`.
|
||||
> **Tipp:** Alle verfügbaren Tags findest du in der [Container-Registry](https://git.techniverse.net/scriptos/-/packages/container/trackmania-server/).
|
||||
|
||||
## 3. Server starten
|
||||
#### Mit Docker Compose
|
||||
|
||||
### Mit Docker Compose (empfohlen)
|
||||
```bash
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
Die Konfiguration erfolgt über die `.env`-Datei, die automatisch eingelesen wird. Das Image wird automatisch aus der Registry geladen.
|
||||
|
||||
### Docker Image selbst bauen
|
||||
|
||||
Alternativ kannst du das Image auch selbst bauen:
|
||||
|
||||
```bash
|
||||
docker build -t tmserver:latest .
|
||||
```
|
||||
|
||||
Anschließend den Server starten:
|
||||
|
||||
```bash
|
||||
docker compose up -d --build
|
||||
```
|
||||
|
||||
Die Konfiguration erfolgt über die `.env`-Datei, die automatisch eingelesen wird.
|
||||
|
||||
### Internet-Modus (docker run)
|
||||
|
||||
Für den Internet-Modus wird ein Server-Account benötigt. Dieser kann auf der [Trackmania Players-Seite](https://players.trackmaniaforever.com) erstellt werden.
|
||||
@@ -50,7 +66,7 @@ docker run -d \
|
||||
-v ./data/gamedata:/opt/tmserver/GameData \
|
||||
-v ./data/controlpanel:/var/www/html \
|
||||
-v ./data/xaseco:/opt/tmserver/xaseco \
|
||||
--name tmserver tmserver:latest
|
||||
--name tmserver git.techniverse.net/scriptos/trackmania-server:latest
|
||||
```
|
||||
|
||||
### LAN-Modus (docker run)
|
||||
@@ -68,10 +84,10 @@ docker run -d \
|
||||
-v ./data/gamedata:/opt/tmserver/GameData \
|
||||
-v ./data/controlpanel:/var/www/html \
|
||||
-v ./data/xaseco:/opt/tmserver/xaseco \
|
||||
--name tmserver tmserver:latest
|
||||
--name tmserver git.techniverse.net/scriptos/trackmania-server:latest
|
||||
```
|
||||
|
||||
## 4. Verwaltungsoberflächen öffnen
|
||||
## 3. Verwaltungsoberflächen öffnen
|
||||
|
||||
| Tool | URL | Beschreibung |
|
||||
|------|-----|-------------|
|
||||
|
||||
@@ -56,5 +56,5 @@ docker run -d \
|
||||
-v ./data/gamedata:/opt/tmserver/GameData \
|
||||
-v ./data/controlpanel:/var/www/html \
|
||||
-v ./data/xaseco:/opt/tmserver/xaseco \
|
||||
--name tmserver tmserver:latest
|
||||
--name tmserver git.techniverse.net/scriptos/trackmania-server:latest
|
||||
```
|
||||
|
||||
@@ -48,6 +48,7 @@ nano .env
|
||||
| `SERVER_MAX_SPECTATORS` | Maximale Zuschaueranzahl | `32` |
|
||||
| `SERVER_SPEC_PASSWORD` | Zuschauer-Passwort (leer = offen) | *(leer)* |
|
||||
| `SERVER_LADDER_MODE` | Ladder-Modus (`inactive` oder `forced`) | `forced` |
|
||||
| `SERVER_LADDER_LIMIT_MAX` | Oberes Ladder-Serverlimit (Punktegrenze) | `60000` |
|
||||
|
||||
## Netzwerk
|
||||
|
||||
@@ -66,6 +67,51 @@ nano .env
|
||||
| `SERVER_MODE` | Server-Modus (`internet` oder `lan`) | `internet` |
|
||||
| `FORCE_CONFIG_UPDATE` | Erzwingt erneutes Anwenden aller Umgebungsvariablen auf die Config | `false` |
|
||||
|
||||
## Spieleinstellungen (MatchSettings)
|
||||
|
||||
| Variable | Beschreibung | Standard |
|
||||
|----------|-------------|----------|
|
||||
| `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
|
||||
|
||||
Standardmäßig (`MATCHSETTINGS_FILE=auto`) wird beim Serverstart automatisch die **neueste** `.txt`-Datei im Verzeichnis `data/gamedata/Tracks/MatchSettings/` anhand des Änderungsdatums ermittelt und geladen. So werden z.B. über AdminServ exportierte MatchSettings beim nächsten Neustart automatisch aktiv.
|
||||
|
||||
**Beispiele:**
|
||||
|
||||
```bash
|
||||
# Automatisch die neueste Datei laden (Standard)
|
||||
MATCHSETTINGS_FILE=auto
|
||||
|
||||
# Eine bestimmte Datei verwenden
|
||||
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.
|
||||
@@ -79,6 +125,41 @@ RemoteCP verwendet die SuperAdmin-Zugangsdaten (`SERVER_SA_PASSWORD`) des TM-Ser
|
||||
|
||||
> **Hinweis:** Diese Werte werden nur beim ersten Start (leeres Volume) angewendet. Weitere Details unter [RemoteCP](remotecp.md).
|
||||
|
||||
## Forced Mods (Skins)
|
||||
|
||||
Mods sind Texturpakete (Skins), die das Aussehen einer Spielumgebung komplett verändern. Über `FORCE_MOD_*`-Variablen kann beim Containerstart automatisch ein Mod pro Umgebung forciert werden. Spieler laden den Mod dann automatisch beim Betreten des Servers herunter.
|
||||
|
||||
| Variable | Beschreibung | Standard |
|
||||
|----------|-------------|----------|
|
||||
| `FORCE_MOD_STADIUM` | Mod-URL für die Stadium-Umgebung | *(leer)* |
|
||||
| `FORCE_MOD_ISLAND` | Mod-URL für die Island-Umgebung | *(leer)* |
|
||||
| `FORCE_MOD_BAY` | Mod-URL für die Bay-Umgebung | *(leer)* |
|
||||
| `FORCE_MOD_COAST` | Mod-URL für die Coast-Umgebung | *(leer)* |
|
||||
| `FORCE_MOD_SPEED` | Mod-URL für die Speed-Umgebung | *(leer)* |
|
||||
| `FORCE_MOD_ALPINE` | Mod-URL für die Alpine-Umgebung | *(leer)* |
|
||||
| `FORCE_MOD_RALLY` | Mod-URL für die Rally-Umgebung | *(leer)* |
|
||||
|
||||
> **Hinweis:** Die Mods werden per XML-RPC (`SetForcedMods`) bei **jedem** Containerstart gesetzt – unabhängig von `FORCE_CONFIG_UPDATE`. Die URL muss auf eine gültige Mod-ZIP-Datei zeigen, die für die Spieler erreichbar ist.
|
||||
|
||||
### Verfügbare Skins
|
||||
|
||||
Eine Auswahl vorkonfigurierter Skins steht unter `https://assets.techniverse.net/tm/skins/` bereit und ist auch im RemoteCP-Mods-Plugin als Dropdown auswählbar.
|
||||
|
||||
**Beispiel:**
|
||||
|
||||
```bash
|
||||
# Portal-Mod für Stadium forcieren
|
||||
FORCE_MOD_STADIUM=https://assets.techniverse.net/tm/skins/Portal.zip
|
||||
|
||||
# Mehrere Umgebungen gleichzeitig
|
||||
FORCE_MOD_STADIUM=https://assets.techniverse.net/tm/skins/Xmas.zip
|
||||
FORCE_MOD_ISLAND=https://example.com/mods/island_mod.zip
|
||||
```
|
||||
|
||||
### Mods über RemoteCP verwalten
|
||||
|
||||
Zusätzlich zur automatischen Konfiguration per Umgebungsvariable können Mods auch zur Laufzeit über das RemoteCP-Web-Interface (`http://<host-ip>/remotecp/`) im Mods-Plugin per Dropdown ausgewählt und aktiviert werden.
|
||||
|
||||
## MariaDB
|
||||
|
||||
| Variable | Beschreibung | Standard |
|
||||
@@ -102,16 +183,28 @@ 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 |
|
||||
|----------|-------------|----------|
|
||||
| `PHP_DISPLAY_ERRORS` | Zeigt PHP-Fehlermeldungen im Browser an (nur zur Fehlersuche!) | `false` |
|
||||
| `PHP_DISPLAY_ERRORS` | Aktiviert den PHP-Debug-Modus: Fehlermeldungen im Browser + vollständige Warnungen im Log (nur zur Fehlersuche!) | `false` |
|
||||
|
||||
> **Hinweis:** Der Debug-Modus erfordert **keinen** Rebuild des Images. Es genügt, die Variable in der `.env`-Datei zu ändern und den Container neu zu starten (`docker compose restart`). Im Produktivbetrieb sollte `PHP_DISPLAY_ERRORS` immer auf `false` stehen.
|
||||
>
|
||||
> Bei `false` werden nur schwerwiegende Fehler geloggt (keine Warnungen/Notices). Bei `true` werden zusätzlich alle Warnungen und Hinweise angezeigt und geloggt – nützlich zur Fehlersuche bei Problemen mit RemoteCP oder AdminServ.
|
||||
|
||||
> **Hinweis:** Bei `FORCE_CONFIG_UPDATE=true` wird die `dedicated_cfg.txt` aus dem Template neu erzeugt und alle Platzhalter mit den aktuellen Umgebungsvariablen ersetzt. Manuelle Änderungen gehen dabei verloren! Nach dem Update sollte `FORCE_CONFIG_UPDATE` wieder auf `false` gesetzt werden.
|
||||
|
||||
@@ -122,9 +215,11 @@ XAseco ist ein Server-Controller für Rekorde, Karma, Jukebox und mehr. Siehe [X
|
||||
Passe die Werte in der `.env`-Datei an und starte mit:
|
||||
|
||||
```bash
|
||||
docker compose up -d --build
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
> **Tipp:** Das fertige Docker Image wird automatisch aus der [Container-Registry](https://git.techniverse.net/scriptos/-/packages/container/trackmania-server/) geladen. Wenn du das Image selbst bauen möchtest, verwende stattdessen `docker compose up -d --build`.
|
||||
|
||||
### docker run
|
||||
|
||||
```bash
|
||||
@@ -137,7 +232,7 @@ docker run -d \
|
||||
-v ./data/gamedata:/opt/tmserver/GameData \
|
||||
-v ./data/controlpanel:/var/www/html \
|
||||
-v ./data/xaseco:/opt/tmserver/xaseco \
|
||||
--name tmserver tmserver:latest
|
||||
--name tmserver git.techniverse.net/scriptos/trackmania-server:latest
|
||||
```
|
||||
|
||||
Einzelne Werte können zusätzlich überschrieben werden:
|
||||
@@ -154,5 +249,5 @@ docker run -d \
|
||||
-v ./data/gamedata:/opt/tmserver/GameData \
|
||||
-v ./data/controlpanel:/var/www/html \
|
||||
-v ./data/xaseco:/opt/tmserver/xaseco \
|
||||
--name tmserver tmserver:latest
|
||||
--name tmserver git.techniverse.net/scriptos/trackmania-server:latest
|
||||
```
|
||||
|
||||
105
docs/update.md
Normal file
105
docs/update.md
Normal file
@@ -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/).
|
||||
282
docs/xaseco.md
282
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
|
||||
|
||||
Reference in New Issue
Block a user