mirror of
https://git.techniverse.net/scriptos/tmserver-docker.git
synced 2026-07-09 21:47:02 +00:00
feat: Forced Mods (Skins) per Umgebungsvariable beim Containerstart setzen
This commit is contained in:
+5
-3
@@ -13,7 +13,7 @@
|
||||
| [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 |
|
||||
| [Ports](ports.md) | Freigegebene Ports und deren Verwendung |
|
||||
|
||||
@@ -32,8 +32,10 @@
|
||||
│ │ ├── dedicated_cfg.txt # Server-Config-Template (mit Platzhaltern)
|
||||
│ │ └── remotecp/
|
||||
│ │ └── plugins/
|
||||
│ │ └── CustomPoints/
|
||||
│ │ └── index.php # CustomPoints-Plugin fuer RemoteCP
|
||||
│ │ ├── CustomPoints/
|
||||
│ │ │ └── index.php # CustomPoints-Plugin fuer RemoteCP
|
||||
│ │ └── Mods/
|
||||
│ │ └── settings.xml # Skin-Bibliothek (techniverse.net)
|
||||
│ └── db/
|
||||
│ └── init-xaseco-db.sh # MariaDB Init-Script fuer XAseco-DB
|
||||
├── docs/ # Dokumentation
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -103,6 +103,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 |
|
||||
|
||||
Reference in New Issue
Block a user