So fügst Du Mods zu Deinem Soldat Server hinzu

Bei Soldat gibt es zwei völlig unterschiedliche Arten von Mods. Klassische Mods – also andere Gostek-Grafiken, Waffenbilder, Sounds und Menüs – sind reine Client-Sache: Sie liegen im Soldat-Ordner auf dem PC des Spielers und werden dort über einen Startparameter geladen. Auf Deinen Server gehören sie nicht.

Serverseitig erweiterst Du Dein Spiel über drei Wege:

• Eigene Karten, die der Server automatisch an die Spieler überträgt
• Server-Scripting (ScriptCore 3) für eigene Spielregeln und Verwaltungsfunktionen
• Mod-Pakete (.smod) – diese Möglichkeit gibt es nur bei OpenSoldat

Eigene Karten hinzufügen

Karten sind der praktischste Weg, Deinen Server individuell zu gestalten. Sie liegen als .pms-Datei vor.

1. Karte herunterladen
   Lade die gewünschte Karte herunter. Du benötigst die .pms-Datei.

2. Server stoppen
   Stoppe Deinen Server über die Verwaltung.

3. Karte hochladen
   Lade die .pms-Datei per SFTP in den Maps-Ordner Deines Servers hoch. Bei OpenSoldat ist das der Ordner maps/.

4. Karte in die Rotation eintragen
   Öffne die Datei mapslist.txt im Hauptverzeichnis Deines Servers und trage die Karte ein – eine Karte pro Zeile:

   ctf_Ash
   ctf_Laos
   ctf_Run
   

5. Server starten
   Speichere die Datei und starte Deinen Server.

Karten im laufenden Betrieb verwalten

Als angemeldeter Admin kannst Du die Rotation auch im Spiel anpassen:

Befehl	Beschreibung
/addmap <Mapname>	Karte zur laufenden Rotation hinzufügen
/delmap <Mapname>	Karte aus der Rotation entfernen
/map <Mapname>	Sofort auf eine bestimmte Karte wechseln
/nextmap	Zur nächsten Karte wechseln
/restart	Aktuelle Runde neu starten

Karten automatisch an die Spieler übertragen

Damit Mitspieler Deine eigenen Karten nicht selbst installieren müssen, überträgt der Server sie beim Beitritt.

1. Server stoppen
   Stoppe Deinen Server über die Verwaltung.

2. Einstellung setzen
   Klassischer Server – im Abschnitt [NETWORK] der soldat.ini:

   Allow_Download=1
   

   OpenSoldat – in der configs/server.cfg:

   set net_allowdownload 1
   set fileserver_enable 1
   

3. Server starten
   Speichere die Datei und starte Deinen Server.

Server-Scripting aktivieren

Das eigentliche Mod-System für Soldat-Server ist das serverseitige Scripting (ScriptCore 3). Damit lassen sich eigene Spielmodi, Statistiken, Automatisierungen und Verwaltungsbefehle umsetzen.

1. Server stoppen
   Stoppe Deinen Server über die Verwaltung.

2. Scripting einschalten
   Klassischer Server – im Abschnitt [NETWORK] der server.ini:

   Scripting=1
   

   OpenSoldat – in der configs/server.cfg. Dort ist Scripting bereits ab Werk aktiv, der Eintrag dient nur zur Kontrolle:

   set sc_enable 1
   

3. Script hochladen
   Lade Dein Script per SFTP in einen eigenen Unterordner hoch:

   scripts/<Scriptname>/
   

4. Konfigurationsdatei anlegen
   Lege im Scriptordner die Datei sc3.cfg an:

   [Config]
   Name=MeinScript
   MainFile=main.pas
   Sandboxed=2
   

5. Server starten
   Starte Deinen Server und prüfe in der Serverkonsole, ob das Script fehlerfrei kompiliert wurde.

Optionen der sc3.cfg

Option	Bedeutung
Name	Pflichtfeld, maximal 20 Zeichen – erscheint in allen Konsolenausgaben zu diesem Script
MainFile	Einstiegsdatei des Scripts, standardmäßig main.pas
Debug	Zusätzliche Debug-Ausgaben aktivieren
Sandboxed	Dateizugriff des Scripts: 0 gesamtes Laufwerk, 1 Serverordner, 2 nur die eigenen Scriptdaten (Standard)
AllowDlls	Erlaubt dem Script das Einbinden externer Bibliotheken
AllowIniEdit	Erlaubt dem Script das Lesen und Schreiben von soldat.ini und server.ini – wirkt nur mit Sandboxed=1
Gamemod	Meldet den Server in der Lobby als Gamemod-Server
Legacy	Kompatibilitätsmodus für ältere Scripts (ScriptCore 2)

Zusätzlich kennt die Datei die Abschnitte [SearchPaths] und [Defines].

Mod-Pakete bei OpenSoldat

Nur OpenSoldat kann serverseitig ein Mod-Paket laden. Mods liegen dort als .smod-Datei vor.

1. Server stoppen
   Stoppe Deinen Server über die Verwaltung.

2. Mod hochladen
   Lade die .smod-Datei per SFTP in den Ordner mods/ hoch.

3. Mod eintragen
   Trage in der configs/server.cfg den Dateinamen ohne die Endung .smod ein:

   set fs_mod MeinMod
   

4. Server starten
   Speichere die Datei und starte Deinen Server.

Was nicht auf den Server gehört