Zum Hauptinhalt springen

Mods

Diese Seite erklärt, wie das Mod-Management im Admin-Bereich funktioniert, einschließlich Installations-/Update-Abläufen, mehrerer Konfigurationen und des Dateischutz-Modells.

Zugriff und Verfügbarkeit​

Mods im Admin-Bereich hängen von beidem ab:

  • Zugriffsrechte: mods.view und mods.install

Praktische Aufteilung:

  • mods.view: Mods durchsuchen, Details öffnen, Dateiänderungen und Konfigurationen prüfen
  • mods.install: installieren, deinstallieren, aktualisieren, neu anordnen und Konfigurationen ändern

Wo Admins Mods verwalten​

Navigationspfade:

  • Server Admin -> Mods -> All mods
  • Server Admin -> Mods -> Installed mods

Ansicht All mods​

Die Ansicht All mods ist deine marktplatzartige Übersicht.

Sie bietet:

  • Suche nach Mod-Name
  • Maintainer-Informationen
  • Verifizierungsstatus
  • Preis (kostenlos oder kostenpflichtig)
  • Installationsreichweite (wie viele Server die Mod aktuell verwenden)
  • Schnelllink zu den Mod-Details

Kartenkompatibilität wird automatisch erzwungen. Wenn eine Mod deine Server-Karte nicht unterstützt, kann sie nicht installiert werden.

Ansicht Installed mods​

Die Ansicht Installed mods ist deine operative Liste für aktive und inaktive Konfigurationen.

Pro Eintrag können Admins:

  • sehen, ob diese Konfiguration aktuell installiert ist
  • sehen, ob automatische Updates für diese Mod aktiviert sind
  • Details öffnen
  • eine bestimmte Konfiguration installieren oder deinstallieren
  • eine nicht installierte Konfiguration entfernen
  • die Lade-Reihenfolge installierter Einträge ändern (nach oben/unten)

Mod-Detailseite​

Die Detailseite hat drei Tabs:

  • Information
  • File changes
  • Configuration

Das Verhalten der oberen Aktionen hängt vom Zustand ab:

  • Buy mod (für kostenpflichtige Mods, die noch nicht gekauft wurden)
  • Install (für installierbare Mods)
  • Enable/disable auto-update (für installierte Mods)
  • Uninstall all (wenn aktuell mindestens eine Konfiguration installiert ist)

Wenn eine neuere veröffentlichte Version existiert, zeigt die Seite einen Update-Hinweis und bietet eine Aktualisierungsaktion an. Wenn automatische Updates aktiviert sind, werden installierte Konfigurationen dieser Mod automatisch auf die neueste veröffentlichte Version umgestellt, sobald der Creator eine neue Version veröffentlicht.

Wichtiges Verhalten:

  • automatische Updates werden pro Mod auf einem Server verwaltet, auch wenn die Mod mehrere Konfigurationen hat
  • das Aktivieren automatischer Updates zieht die Mod sofort auf die aktuell veröffentlichte Version nach
  • Dateitransfer und Neustart-Erwartungen folgen nach Versionsänderungen weiterhin dem normalen Admin-Workflow

Kostenpflichtige Mods und Besitz​

Kostenpflichtige Mods müssen vor der Installation gekauft werden.

Nach dem Kauf kann es kurze Zeit dauern, bis der Besitz in der Oberfläche erscheint. Während dieses Zeitraums können Installationsaktionen kurzzeitig noch nicht verfügbar sein.

Konfigurationsmodell​

Eine Mod kann eine oder mehrere Server-Konfigurationen haben, je nachdem, wie der Mod-Autor sie gestaltet hat.

Was du tun kannst:

  • erste Konfiguration erstellen
  • zusätzliche Konfigurationen hinzufügen (falls unterstützt)
  • Konfigurationswerte bearbeiten
  • ein Beschreibungs-Label für eine Konfiguration setzen
  • jede Konfiguration unabhängig installieren/deinstallieren

Wichtiges Verhalten:

  • eine ungültige Konfiguration blockiert das wirksame Installationsverhalten, bis sie korrigiert wird
  • wenn eine Mod auf eine neue Version aktualisiert wird, überprüfe die Konfigurationswerte erneut
  • neue Konfigurationen übernehmen die aktuelle Auto-Update-Einstellung der Mod

Mods, die Mehrfachinstallationen unterstützen (z.B. eine Teleporter-Mod, die mehrfach für verschiedene Standorte installiert werden kann), verwenden die eingebaute Variable {$installation_id} in ihren Dateipfaden. Jede Konfigurationsinstanz erhält eine eindeutige Kennung, sodass sich separate Installationen nicht gegenseitig überschreiben. Administratoren müssen nichts weiter tun — dies wird automatisch durch das Design des Mod-Autors gehandhabt.

Dateischutz-Modell (.original)​

dzbot schützt Basisdateien mit .original-Backups.

So funktioniert es:

  • bevor verwaltete Dateiänderungen angewendet werden, wird der Ausgangsinhalt in passenden .original-Dateien gesichert
  • generierte Mod-Ausgabe wird aus dieser Basis erstellt
  • Deinstallations-/Wiederherstellungsabläufe verwenden diese Basisdaten, um Dateien zurückzusetzen

Betriebsregel:

  • wenn du eine von Mods verwaltete Datei manuell bearbeitest, bearbeite die .original-Basisdatei und nicht nur die generierte aktive Datei
  • lösche .original-Dateien nicht

Anwendungsmodell und Neustart-Erwartung​

Der Mod-Dateitransfer wird durch die von dzbot verwaltete Transfer-Logik durchgeführt. Auswirkungen im Spiel erfordern in der Regel Neustart-Zyklen, um vollständig aktiv zu werden.

Empfohlene Betriebsweise:

  • führe Neustarts nach Installations-/Deinstallations-/Update-Änderungen über dzbot aus
  • vermeide das Mischen mit manuellen externen Neustart-Workflows bei mod-lastigen Servern

Verwandte Dokumentation​