Zum Hauptinhalt springen

Nightbreak-Einrichtung und Inhaltsverwaltung

Diese Seite ist die gemeinsame Einrichtungsanleitung für die von Nightbreak verwalteten Plugins.

Sie gilt direkt für:

  • EliteMobs
  • BetterStructures
  • FreeMinecraftModels
  • EternalTD

Diese Plugins teilen nun denselben Gesamtlebenszyklus:

  1. Installiere das Plugin und alle zwingend erforderlichen Abhängigkeiten.
  2. Starte den Server einmal, damit Dateien und Menüs generiert werden.
  3. Führe den Ersteinrichtungsbefehl des Plugins aus, falls vorhanden.
  4. Verknüpfe einen Nightbreak-Token mit /nightbreaklogin <token>.
  5. Nutze das Plugin-Setup-Menü, um Inhalte zu durchsuchen, zu installieren, zu aktivieren, zu deaktivieren und zu aktualisieren.
  6. Nutze die Massendownload-/Aktualisierungsbefehle des Plugins, wenn du einen schnelleren Erststart möchtest.

Was MagmaCore tatsächlich teilt

MagmaCore ist die gemeinsame Schicht hinter dem von Nightbreak verwalteten Ablauf. Es bietet:

  • den gemeinsamen Befehl /nightbreaklogin <token>
  • die gemeinsame Token-Speicherung in plugins/MagmaCore/nightbreak.yml
  • gemeinsame Setup-Menü-Grundlagen, die von Plugin-Setup-Menüs verwendet werden
  • gemeinsame Nightbreak-Zugriffs-, Versions- und Download-Prüfungen
  • gemeinsame Massendownload-Logik, die Dateien in den imports-Ordner des besitzenden Plugins herunterlädt

Die plugin-spezifischen Befehle wie /em initialize oder /bs setup werden weiterhin von jedem Plugin selbst implementiert. MagmaCore stellt die gemeinsamen Systeme bereit, die diese Befehle nutzen.

Gemeinsames Ersteinrichtungsmuster

Die meisten aktuellen von Nightbreak verwalteten Plugins bieten:

PluginErsteinrichtungsbefehlSetup-MenüMasseninstallationMassenaktualisierung
EliteMobs/em initialize/em setup/em downloadall/em updatecontent
BetterStructures/bs initialize/bs setup/bs downloadall/bs updatecontent
FreeMinecraftModels/fmm initialize/fmm setup/fmm downloadall/fmm updatecontent
EternalTD/etd initialize/etd setup/etd downloadall/etd updatecontent

initialize ist ein Ersteinrichtungsassistent. Er ersetzt nicht das plugin-spezifische Setup-Menü oder die Inhaltsverwaltungsbefehle.

MagmaCore hat auch ein separates Plugin-Start-Initialisierungssystem, aber das ist nicht dasselbe wie die hier dokumentierten spielerorientierten initialize-Befehle.

Empfohlener Ablauf für Serverbesitzer

1. Installiere zuerst das Plugin

Lege die Plugin-JAR-Datei und alle erforderlichen Abhängigkeiten in plugins/ und starte den Server einmal.

2. Führe den Ersteinrichtungsablauf durch

Wenn das Plugin einen initialize-Befehl anbietet, nutze ihn zuerst. Die aktuellen Menüs sind darauf ausgelegt:

  • die Ersteinrichtung als abgeschlossen zu markieren
  • dich auf die Nightbreak-Kontoverknüpfung hinzuweisen
  • dich zum aktuellen Setup-Menü weiterzuleiten
  • klarzustellen, wann manuelle Importe noch gültig sind

Das Ersteinrichtungsmenü-Verhalten selbst ist geteilt, aber der genaue Befehlsname und die Folgelogik bleiben plugin-spezifisch.

3. Verknüpfe dein Nightbreak-Konto

Gehe zur Nightbreak-Kontoseite, hole dir deinen Server-Token und führe aus:

/nightbreaklogin <token>

Der Token wird über MagmaCore geteilt, sodass ein verknüpfter Token von allen kompatiblen MagmaGuy-Plugins auf diesem Server wiederverwendet werden kann.

4. Nutze das Setup-Menü für die tägliche Inhaltsverwaltung

Die Setup-Menüs sind die aktuelle Referenzquelle für:

  • Paketstatus
  • Zugriffsstatus
  • installierte vs. heruntergeladene Inhalte
  • teilweise installierte Inhalte, die repariert werden müssen
  • veraltete Inhalte
  • Inhaltsfilter nach Kategorie

Wenn du einen verknüpften Token hast, sind die Setup-Menüs der empfohlene Ort, um Inhalte zu installieren und zu aktualisieren.

5. Nutze Masseninstallation/-aktualisierung, wenn du Geschwindigkeit möchtest

Verwende den downloadall-Befehl, wenn du einen Server schnell einrichten möchtest, und den updatecontent-Befehl, wenn du alles aktualisieren möchtest, was veraltet ist.

Der gemeinsame Massendownloader versucht nur Nightbreak-verwaltete Pakete, die:

  • einen Nightbreak-Slug haben
  • für den verknüpften Token zugänglich sind
  • noch nicht heruntergeladen oder als veraltet markiert sind

Die meisten aktuellen Plugins laden sich nach erfolgreichen Massendownloads automatisch neu.

Gemeinsame Konzepte

Heruntergeladen vs. installiert

Ein Paket kann lokal existieren, ohne aktiviert zu sein. Die genaue Bedeutung variiert je nach Plugin leicht, aber der Status im Setup-Menü ist wichtiger als ob eine ZIP-Datei in imports existiert.

Massendownloads landen ebenfalls im gleichen Plugin-imports-Ordner, der von manuellen Importen verwendet wird, bevor der plugin-spezifische Import-/Neuladevorgang abgeschlossen ist.

Zugriffsbasierte Inhalte

Setup-Menüs können jetzt unterscheiden zwischen Inhalten, die:

  • für deinen Token verfügbar sind
  • gekauft oder freigeschaltet werden müssen
  • installiert sind
  • nur teilweise installiert sind
  • heruntergeladen aber deaktiviert sind
  • veraltet sind

Manuelle Importe sind weiterhin gültig

Von Nightbreak verwaltete Plugins unterstützen weiterhin manuelle Import-Workflows. Manueller Import ist jetzt der Ausweichpfad, nicht der Standardpfad. Siehe Manuelle Importe vs. In-Game-Verwaltung.

Plugins, die diesen Ablauf nicht verwenden

Nicht jedes Plugin in diesem Wiki verwendet von Nightbreak verwaltete herunterladbare Inhalte.

  • BetterFood verwendet kein Nightbreak-Paketmanagement
  • ResurrectionChest verwendet kein Nightbreak-Paketmanagement
  • WorldCannon verwendet kein Nightbreak-Paketmanagement
  • ResourcePackManager verwaltet Ressourcenpakete, keine Nightbreak-DLC-Pakete