TrackMania Dedicated Server – der eigentliche Spielserver für Internet- oder LAN-Betrieb
XAseco – Server-Controller, der lokale Rekorde, Dedimania-Weltrekorde, Karma/Votes und eine Track-Jukebox direkt im Spielchat verwaltet
AdminServ – Web-Oberfläche zur komfortablen Verwaltung und Konfiguration des Servers
RemoteCP – 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.

Der Server unterstützt sowohl den Internet-Dedicated-Modus (Standard) als auch den LAN-Dedicated-Modus.

Schnellstart

1. Umgebungsvariablen einrichten

cp .env.example .env

Passe die Werte in der .env-Datei an deine Umgebung an (Passwörter, Masterserver-Account, etc.).

⚠ Sicherheitshinweis: Die .env.example enthält vorgenerierte Beispiel-Passwörter. Diese dienen nur als Platzhalter und sind öffentlich einsehbar! Ändere unbedingt alle Passwörter, bevor du den Server produktiv einsetzt.

2. Server starten

Das fertige Docker Image kann direkt verwendet werden – kein eigener Build nötig:

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. Wenn du das Image lieber selbst bauen möchtest, findest du die Anleitung unter Schnellstart – Selbst bauen.

3. Verwaltungsoberflächen öffnen

AdminServ: http://<host-ip>/
RemoteCP: http://<host-ip>/remotecp/

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 erstellen. Für den LAN-Modus setze SERVER_MODE=lan.

Dokumentation

Die vollständige Dokumentation befindet sich im Ordner docs/:

Schnellstart – Erste Schritte und minimale Konfiguration
Konfiguration – Persistente Serverkonfiguration (dedicated_cfg.txt)
Umgebungsvariablen – Alle verfügbaren Umgebungsvariablen
Server-Modi – LAN- und Internet-Dedicated-Modus
AdminServ – Einrichtung der Server-Verwaltungsoberfläche
RemoteCP – Alternative Server-Verwaltungsoberfläche
XAseco – Server-Controller für Rekorde, Karma und Jukebox
Ports – Freigegebene Ports und deren Verwendung

Danksagung

Ein herzliches Dankeschön an Thomas – 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!