Zum Hauptinhalt springen

Modding

dzbot enthält einen Creator-Marktplatz, auf dem du eigene Mods erstellen, versionieren, veröffentlichen und optional monetarisieren kannst.

Dieser Leitfaden behandelt den praktischen Workflow für Creator – vom ersten Entwurf bis zur veröffentlichten Mod.

Verwandte Guides:

Creator-Bereich öffnen​

Navigationspfad:

  • Plattform-Panel -> Creator-Bereich

Direkter Zugriff ist verfügbar unter https://dzbot.de/creators.

Verwende dein dzbot-Konto (normalerweise ein mit Discord verknüpftes Konto), um dich anzumelden und deine Mods zu verwalten.

Übersicht über Mods​

Die Übersicht ist dein Creator-Dashboard für alle Mods, die du pflegst.

Was du dort tun kannst:

  • eine neue Mod erstellen
  • deine Mods nach Name durchsuchen
  • den Verifizierungsstatus einsehen
  • prüfen, ob eine veröffentlichte Version existiert
  • sehen, wie viele Server-Installationen existieren
  • die neueste Version zur Bearbeitung öffnen

Du kannst eine Mod nur dauerhaft löschen, wenn sie auf keinen Servern mehr installiert ist.

Mod-Details​

Die Mod-Detailseite ist in Tabs organisiert:

  • Information
  • Zugriff
  • Dateiänderungen
  • Konfiguration
  • Versionen

Wichtige Lebenszyklusregel:

  • Sobald eine Version veröffentlicht ist, sind Dateiänderungen und Konfigurationen gesperrt.
  • Weitere Änderungen erfordern die Erstellung einer neuen Version.
  • Metadaten der Mod (Name, Beschreibung, Karten, öffentlich/privat, Preis) können weiterhin aktualisiert werden.

Mod-Einstellungen​

Verwende den Tab Information, um wichtige Metadaten zu definieren:

  • Mod-Name
  • Beschreibung
  • unterstützte Karten
  • öffentlich/private Verfügbarkeit
  • optionaler Preis (falls Zahlungskonto eingerichtet ist)

Praktischer Hinweis:

  • Für kostenpflichtige Mods verwendet dzbot Euro-Cent (100 = 1 EUR).
  • Positive Preise unter 100 werden automatisch auf 100 angehoben.

Mod-Zugriff​

Der Tab Zugriff zeigt, welche Server deine Mod haben.

  • Öffentliche Mods stehen jedem Server zur Verfügung, der eine der Karten der Mod spielt.
  • Private Mods stehen nur den Servern zur Verfügung, denen du Zugriff gibst.

Einem Server Zugriff auf eine private Mod gibst du auf zwei Wegen:

  • Auf deinem eigenen Server: Unter Auf deinem Server freigeben einen der Server wählen, auf denen du selbst Mods installieren darfst, und Freigeben klicken.
  • Auf einem fremden Server: Serverlink erstellen kopiert einen Link, der einmal funktioniert. Schick ihn an den Admin des Servers; er öffnet ihn und wählt seinen Server. Der Link läuft nach 7 Tagen ab.

In beiden Fällen erscheint die Mod danach in der Mod-Liste des Servers; die Admins des Servers installieren sie dort wie jede andere Mod. Server bekommen die veröffentlichte Version, solange keine veröffentlicht ist die neueste.

Das alles geht auch aus einer mit dzbot verbundenen KI-App, siehe KI-Apps verbinden.

Mod-Versionen und Veröffentlichung​

Jede Mod ist versioniert.

Wichtiges Verhalten:

  • Eine neue Mod beginnt mit Version 1.
  • Nur veröffentlichte Versionen sind auf Servern installierbar.
  • Das Erstellen einer neuen Version klont aktuelle Dateien/Konfigurationen als Ausgangspunkt.
  • Alte Versionen sind einsehbar, aber nur die neueste unveröffentlichte Version ist bearbeitbar.
  • Die nächste Version kann erst erstellt werden, nachdem die aktuelle neueste Version veröffentlicht wurde.
  • Server, die für deine Mod automatische Updates aktiviert haben, wechseln beim Veröffentlichen automatisch auf die neue veröffentlichte Version.

Empfohlener Veröffentlichungsablauf:

  1. Erstelle und teste auf der neuesten bearbeitbaren Version.
  2. Finalisiere Dateiänderungen und Konfigurationsschema.
  3. Veröffentliche diese Version.
  4. Für Updates erstelle eine neue Version und wiederhole den Ablauf.

Praktischer Hinweis:

  • Automatische Updates ändern nur, auf welche veröffentlichte Version ein Server zeigt. Für die Übernahme auf den laufenden Server gilt weiterhin der normale Transfer-/Neustart-Workflow der Administratoren.