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
• ResurrectionChest
• WorldCannon

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> (Berechtigung nightbreak.login, standardmäßig OP)
• den gemeinsamen Befehl /nightbreaklogout zum Trennen des Servers von seinem Nightbreak-Konto (Berechtigung nightbreak.login, standardmäßig OP)
• den gemeinsamen Befehl /logify zum Hochladen des aktuellen Server-Logs zu mclo.gs (Berechtigung logify.*, standardmäßig OP)
• den gemeinsamen Befehl /nightbreak plugins zum Durchsuchen des Nightbreak-Plugin-Katalogs (Berechtigung nightbreak.plugins, standardmäßig OP)
• 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
• den gemeinsamen Changelog-Posteingang, der Admins im Spiel mitteilt, wenn ein Plugin oder ein installiertes Inhaltspaket ungelesene Release Notes hat (siehe Nightbreak-Changelog-Benachrichtigungen)
• den Standard-Unterbefehlssatz, den jedes von Nightbreak verwaltete Plugin unter seinem eigenen Stammbefehl registriert (siehe unten)

/nightbreaklogin, /nightbreaklogout, /logify und /nightbreak werden pro Server einmalig von dem von Nightbreak verwalteten Plugin registriert, das MagmaCore zuerst lädt, sodass sie unabhängig davon verfügbar sind, welches Plugin sie zur Laufzeit „besitzt".

Gemeinsame Standard-Unterbefehle

Die untenstehenden Unterbefehle werden nicht von jedem Plugin selbst geschrieben. MagmaCore registriert dieselben Implementierungen unter dem jeweils vom Plugin deklarierten Stammbefehl (/em, /bs, /fmm, /etd, …), weshalb sie sich überall identisch verhalten.

Unterbefehl	Was er tut	Berechtigung
setup	Öffnet das Setup-Menü des Plugins. Nur für Spieler.	Setup-Berechtigung des Plugins
initialize	Öffnet das Ersteinrichtungsmenü für Spieler, wenn das Plugin diesen Ablauf registriert. Preset-Modi sind keine Voraussetzung; FreeMinecraftModels registriert ihn ebenfalls. Sieh auf der Befehlsseite des jeweiligen Plugins nach.	Initialize-Berechtigung des Plugins
recommendedplugins	Zeigt empfohlene Begleit-Plugins (Menü im Spiel, Chat-Liste von der Konsole).	Setup-Berechtigung des Plugins
downloadpluginupdate	Lädt nur eine Plugin-Update-Jar herunter. Keine Inhalte.	Admin-Berechtigung des Plugins
downloadall	Lädt das Plugin-Update und anschließend alle verfügbaren Inhalte herunter.	Admin-Berechtigung des Plugins
downloadallcontent	Lädt alle verfügbaren Inhalte herunter, kein Plugin-Update. Wird nur von Plugins registriert, die Inhaltspakete ausliefern.	Setup-Berechtigung des Plugins
updatecontent (Alias updateallcontent)	Lädt nur Updates für bereits veraltete Inhalte herunter. Wird nur von Plugins registriert, die Inhaltspakete ausliefern.	Setup-Berechtigung des Plugins
forcereinstallcontent <package|all>	Lädt Inhalte über den normalen authentifizierten Import- und Reload-Pfad erneut herunter, selbst wenn die installierte Version bereits aktuell ist. all umfasst jedes Paket, das heruntergeladen, installiert oder veraltet ist; gib den Paket-Slug direkt an, wenn dessen Dateien vollständig fehlen. Wird nur von Plugins registriert, die Inhaltspakete ausliefern.	Admin-Berechtigung des Plugins

Der genaue Berechtigungsknoten hinter jeder Spalte wird vom Plugin gewählt, sieh also auf der Seite des jeweiligen Plugins nach den Knotennamen. initialize ist ein Ersteinrichtungsassistent — er ersetzt nicht das Setup-Menü oder die Inhaltsverwaltungsbefehle.

Da downloadall mit dem Plugin-Update beginnt, hält es vor dem Inhaltsschritt an, wenn das Konto keinen Token hat oder die Token-Authentifizierung fehlgeschlagen ist. Korrigiere zuerst den Token und führe ihn dann erneut aus.

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

Automatische Updates

Jedes von Nightbreak verwaltete Plugin schreibt einen gemeinsamen Schlüssel in seine eigene config.yml:

nightbreak:
  autoDownloadPluginUpdates: false

Steht er auf true, lädt dieses Plugin wenige Minuten nach dem Start automatisch herunter:

• eine verfügbare Plugin-Update-Jar und
• Update-Dateien für alle veralteten Inhaltspakete, die es verwaltet.

Heruntergeladene Plugin- und Inhalts-Updates werden nach einem Server-Neustart verwendet — nichts wird im laufenden Server ausgetauscht. Die Einstellung ist standardmäßig false, sodass du ab Werk bei der In-Game-Update-Schaltfläche bleibst.

Automatische Plugin-Jar-Downloads erfordern sowohl einen gültigen Konto-Token als auch eine aktive Supporter-Patreon-Mitgliedschaft auf dem verknüpften Nightbreak-Konto. Ohne beides wird der Download verweigert und das Plugin protokolliert den Grund. Downloads werden außerdem verifiziert: Die Jar wird per Prüfsumme kontrolliert und als echtes Plugin-Artefakt validiert, bevor sie im update-Ordner des Servers abgelegt wird; eine fehlgeschlagene Prüfung verwirft die Datei, statt sie zu installieren.

Unabhängig von der Auto-Download-Einstellung prüft jedes Plugin etwa einmal pro Stunde unauffällig auf eine neuere Version, damit das Setup-Menü einen korrekten Update-Status anzeigen kann. Diese Prüfung lädt von sich aus niemals etwas herunter.

Empfohlener Ablauf für Serverbesitzer

1. Installiere zuerst das Plugin

Lege die Plugin-JAR-Datei und alle erforderlichen zwingenden 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

Öffnet das Ersteinrichtungsmenü für Spieler, wenn das Plugin diesen Ablauf registriert. Preset-Modi sind keine Voraussetzung; FreeMinecraftModels registriert ihn ebenfalls. Sieh auf der Befehlsseite des jeweiligen Plugins nach.

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

Interaktive Massenbefehle fordern das besitzende Plugin nach mindestens einem erfolgreichen Download zum Neuladen auf. Automatische Inhalts-Downloads beim Start laden das Plugin bewusst nicht neu; sie werden erst nach einem Server-Neustart wirksam.

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
• ResourcePackManager verwaltet Ressourcenpakete, keine Nightbreak-DLC-Pakete

Beide Plugins registrieren dennoch die gemeinsame Setup-Hülle sowie die gemeinsamen Plugin-Update- und Changelog-Befehle; was ihnen fehlt, sind Nightbreak-Inhaltspakete.

ResurrectionChest und WorldCannon sind keine Ausnahmen — beide deklarieren Inhaltspakete, beide registrieren die gemeinsamen Inhalts-Unterbefehle und beide nutzen den gemeinsamen Importeur, akzeptieren also auch von Hand abgelegte Paket-ZIPs. Siehe Manuelle Importe vs. In-Game-Verwaltung.