Nightbreak-Einrichtung und Content-Verwaltung
Diese Seite ist die gemeinsame Einrichtungsanleitung fuer Plugins mit Nightbreak-verwaltetem Content.
Sie gilt direkt fuer:
- EliteMobs
- BetterStructures
- FreeMinecraftModels
- EternalTD
Diese Plugins teilen sich jetzt denselben allgemeinen Lebenszyklus:
- Installieren Sie das Plugin und alle zwingend erforderlichen Abhaengigkeiten.
- Starten Sie den Server einmal, damit Dateien und Menues erzeugt werden.
- Fuehren Sie den Erst-Einrichtungsbefehl des Plugins aus, falls es einen gibt.
- Verknuepfen Sie ein Nightbreak-Token mit
/nightbreaklogin <token>. - Verwenden Sie das Setup-Menue des Plugins, um Content zu durchsuchen, zu installieren, zu aktivieren, zu deaktivieren und zu aktualisieren.
- Verwenden Sie die Sammelbefehle zum Herunterladen oder Aktualisieren, wenn Sie eine schnellere Erst-Einrichtung moechten.
Was MagmaCore Tatsachlich Gemeinsam Bereitstellt
MagmaCore ist die gemeinsame Schicht hinter dem Nightbreak-verwalteten Ablauf. Sie stellt Folgendes bereit:
- den gemeinsamen Befehl
/nightbreaklogin <token> - die gemeinsame Token-Speicherung in
plugins/MagmaCore/nightbreak.yml - gemeinsame Setup-Menue-Bausteine, die von Plugin-Setup-Menues genutzt werden
- gemeinsame Nightbreak-Zugriffs-, Versions- und Download-Pruefungen
- gemeinsame Sammel-Download-Logik, die Dateien in den
imports-Ordner des jeweiligen Plugins herunterlaedt
Plugin-spezifische Befehle wie /em initialize oder /bs setup werden weiterhin von jedem Plugin selbst implementiert. MagmaCore liefert die gemeinsamen Systeme, die diese Befehle verwenden.
Gemeinsames Erst-Einrichtungs-Muster
Die meisten aktuellen Plugins mit Nightbreak-Verwaltung bieten Folgendes an:
| Plugin | Erst-Einrichtungsbefehl | Setup-Menue | Sammelinstallation | Sammelaktualisierung |
|---|---|---|---|---|
| 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 gefuehrter Erst-Einrichtungsablauf. Er ersetzt weder das plugin-spezifische Setup-Menue noch die Befehle zur Content-Verwaltung.
MagmaCore besitzt ausserdem ein separates Initialisierungssystem beim Plugin-Start, aber das ist nicht dasselbe wie die hier dokumentierten, spielerseitigen initialize-Befehle.
Empfohlener Ablauf Fuer Serverbetreiber
1. Installieren Sie zuerst das Plugin
Legen Sie die Plugin-Jar und alle erforderlichen Hard-Dependencies in plugins/ ab und starten Sie den Server einmal.
2. Fuehren Sie den Erst-Einrichtungsablauf aus
Wenn das Plugin einen initialize-Befehl anbietet, verwenden Sie ihn zuerst. Die aktuellen Menues sind darauf ausgelegt:
- die Erst-Einrichtung als abgeschlossen zu markieren
- Sie zur Nightbreak-Kontoverknuepfung zu fuehren
- Sie zum aktuellen Setup-Menue weiterzuleiten
- zu verdeutlichen, wann manuelle Importe weiterhin sinnvoll sind
Das Verhalten des Erst-Einrichtungsmenues ist gemeinsam, aber der genaue Befehlsname und die anschliessende Logik bleiben plugin-spezifisch.
3. Verknuepfen Sie Ihr Nightbreak-Konto
Gehen Sie auf die Nightbreak-Kontoseite, holen Sie Ihr Server-Token und fuehren Sie aus:
/nightbreaklogin <token>
Das Token wird ueber MagmaCore gemeinsam genutzt. Ein einmal verknuepftes Token kann daher von allen kompatiblen MagmaGuy-Plugins auf demselben Server verwendet werden.
4. Nutzen Sie das Setup-Menue fuer die taegliche Content-Verwaltung
Die Setup-Menues sind die aktuelle Quelle der Wahrheit fuer:
- Paketstatus
- Zugriffsstatus
- installierten vs. nur heruntergeladenen Content
- teilweise installierten Content, der repariert werden muss
- veralteten Content
- Content-Filter nach Kategorie
Wenn Sie ein verknuepftes Token haben, sind die Setup-Menues der empfohlene Ort zum Installieren und Aktualisieren von Content.
5. Nutzen Sie Sammelinstallation oder -aktualisierung, wenn Sie Geschwindigkeit wollen
Verwenden Sie downloadall, wenn Sie einen Server schnell aufsetzen moechten, und updatecontent, wenn Sie alles Veraltete auf einmal aktualisieren moechten.
Der gemeinsame Sammel-Downloader versucht nur Nightbreak-verwaltete Pakete, die:
- einen Nightbreak-Slug haben
- fuer das verknuepfte Token verfuegbar sind
- noch nicht heruntergeladen wurden oder als veraltet markiert sind
Die meisten aktuellen Plugins laden sich nach erfolgreichen Sammeldownloads automatisch neu.
Gemeinsame Konzepte
Heruntergeladen vs. installiert
Ein Paket kann lokal vorhanden sein, ohne aktiviert zu sein. Die genaue Bedeutung unterscheidet sich leicht je nach Plugin, aber der Status im Setup-Menue ist wichtiger als die reine Existenz einer Zip-Datei im imports-Ordner.
Sammeldownloads landen ebenfalls im selben imports-Ordner des Plugins, der auch fuer manuelle Importe verwendet wird, bevor der plugin-spezifische Import- oder Reload-Schritt abgeschlossen ist.
Content mit zugriffsabhaengigem Status
Setup-Menues koennen jetzt zwischen Content unterscheiden, der:
- fuer Ihr Token verfuegbar ist
- gekauft oder freigeschaltet werden muss
- installiert ist
- nur teilweise installiert ist
- heruntergeladen, aber deaktiviert ist
- veraltet ist
Manuelle Importe sind weiterhin gueltig
Plugins mit Nightbreak-Verwaltung unterstuetzen weiterhin manuelle Import-Workflows. Manuelle Importe sind jetzt der Rueckfallpfad, nicht mehr der Standardpfad. Siehe Manuelle Importe vs. In-Game-Verwaltung.
Plugins, Die Diesen Ablauf Nicht Verwenden
Nicht jedes Plugin in diesem Wiki nutzt Nightbreak-verwalteten, herunterladbaren Content.
- BetterFood verwendet keine Nightbreak-Paketverwaltung
- ResurrectionChest verwendet keine Nightbreak-Paketverwaltung
- WorldCannon verwendet keine Nightbreak-Paketverwaltung
- ResourcePackManager verwaltet Resource Packs, keine Nightbreak-DLC-Pakete