Zum Hauptinhalt springen

BetterStructures Einrichtung

BetterStructures unterstützt weiterhin manuelle Importe. Der empfohlene Ablauf verwendet die Nightbreak-Verwaltung im Spiel.

Voraussetzungen​

  • WorldEdit oder FAWE-kompatible Schematic-Unterstützung
  • Java 21 Runtime für die aktuelle Build-Linie
  1. Installiere BetterStructures und WorldEdit, dann starte den Server einmal.
  2. Führe /bs initialize aus.
  3. Verknüpfe ein Nightbreak-Token mit /nightbreaklogin <token>.
  4. Öffne /bs setup, um Strukturpakete und Modulpakete zu durchsuchen.
  5. Verwende /bs downloadall für eine schnelle Ersteinrichtung. Der Befehl lädt ein ausstehendes Plugin-Update und alle Inhalte herunter.
  6. Verwende /bs updatecontent, wenn Paketaktualisierungen verfügbar sind.

Das Menü der Ersteinrichtung​

/bs initialize öffnet ein kleines geführtes Menü. Solange keine seiner Optionen gewählt wurde, erhält jeder Spieler mit betterstructures.* zehn Sekunden nach dem Beitreten eine Erinnerungsnachricht. Alle drei Optionen markieren die Einrichtung als abgeschlossen, indem sie setupDone: true in die config.yml schreiben.

OptionWas sie bewirkt
Recommended SetupMarkiert die Einrichtung als abgeschlossen und gibt den dreistufigen Weg aus: ein Token unter nightbreak.io/account holen, es mit /nightbreaklogin <token> verknüpfen, dann /bs setup öffnen.
Manual SetupMarkiert die Einrichtung als abgeschlossen und überlässt dir die Inhaltsverwaltung, mit einem Verweis auf /bs setup und den imports-Ordner.
Use Current ContentBlendet die Aufforderung aus und behält die aktuellen Inhalte bei. Ist das Schematic-Verzeichnis im Speicher nicht leer, wird neu geladen. Andernfalls meldet das Menü fehlende Inhalte und verweist auf /bs setup. Module werden bei dieser Prüfung nicht mitgezählt.

Ist weder WorldEdit noch FastAsyncWorldEdit installiert, wird der dritte Platz durch eine Warnung ersetzt, die dich auffordert, vor dem Fortfahren eines von beiden zu installieren.

Das Setup-Menü​

/bs setup öffnet ein Menü mit mehreren Seiten und zwei Filtern: Strukturpakete und Modulpakete. Jedes Paket zeigt an, ob es installiert, heruntergeladen aber nicht aktiviert, veraltet ist oder Nightbreak-Zugang benötigt. Die Klickaktion hängt vom Zustand ab: herunterladen, installieren, aktualisieren, deinstallieren oder Zugangsinformationen anzeigen.

Neben den Paketen stellt das Menü außerdem gemeinsame MagmaCore-Steuerelemente bereit, die in BetterStructures gebündelt sind:

  • Plugin Update – zeigt an, ob ein neuerer BetterStructures-Build verfügbar ist, und ermöglicht dir, ihn herunterzuladen. Ein Neustart wendet ihn an, sofern du nicht /bs applypluginupdate ausführst oder nightbreak.applyPluginUpdatesWithoutRestart in config.yml auf when-empty oder immediately setzt. Die Prüfung läuft automatisch beim Start und wird etwa einmal pro Stunde aufgefrischt, ein frisch gestarteter Server kann also kurzzeitig „Plugin Update Pending“ anzeigen.
  • Recommended Plugins – öffnet die Ansicht mit den Empfehlungen für Begleit-Plugins (entspricht /bs recommendedplugins). Das Symbol wird grün, sobald jede aufgeführte Empfehlung installiert ist.
  • Download All Content – der Sammeleintrag, der hinter der Paketliste angehängt wird, entspricht /bs downloadall.
  • Automatic Updates – ein Schalter in der Werkzeugleiste dafür, ob BetterStructures Plugin- und Inhalts-Updates beim Start automatisch herunterlädt. Er ist standardmäßig deaktiviert und verwendet den Schlüssel nightbreak.autoDownloadPluginUpdates in config.yml. Automatisch heruntergeladene Inhalte werden für den nächsten Neustart bereitgestellt, ohne sofortiges Neuladen. Ein Neustart wendet auch ein heruntergeladenes Plugin-Update an, sofern nightbreak.applyPluginUpdatesWithoutRestart nicht auf when-empty oder immediately gesetzt ist (siehe Konfiguration).
  • Installation tips – die Info-Schaltfläche, die die Einrichtungsanleitung, die Token-Seite des Kontos, den Support-Discord und anklickbare Setup-Befehle in den Chat schreibt.

/bs setup wird abgelehnt, während ein Neuladen der Inhalte läuft, da das Menü dieselben Registries liest, die der Reload-Worker gerade neu aufbaut. Warte, bis das Neuladen Erfolg meldet, und öffne es dann erneut.

Das Menü prüft nicht die Integrität der Dateien. Ein beschädigtes oder teilweise gelöschtes Paket kann weiterhin als aktuell erscheinen, wenn sein Pfad existiert und die Version übereinstimmt. Repariere es mit /bs forcereinstallcontent <package|all>; fehlt der gesamte Paketordner, gib den Slug direkt an. Die Deinstallation lässt Dateien auf der Festplatte. Sie setzt das isEnabled des Pakets auf false und lädt neu, und das Neuladen überspringt jedes Schematic und Modul im Ordner dieses Pakets, einschließlich der Unterordner.

Alternative: manueller Import​

Manuelle Importe funktionieren weiterhin über:

plugins/BetterStructures/imports

Paket-Zips intakt lassen, dann /bs reload ausführen, falls erforderlich. /bs reload importiert alles, was in diesem Ordner liegt, als Teil des Neuladens, du brauchst also keinen Neustart, um ein abgelegtes Paket zu übernehmen.

Beachte, dass Dateien im imports-Ordner den Start verlangsamen: Ist der Ordner nicht leer, wartet BetterStructures vor dem Start darauf, dass die in seinem softdepend aufgeführten Plugins ihre Initialisierung abgeschlossen haben, denn Inhalte in den Datenordner eines anderen Plugins zu importieren bedeutet, dass dieses Plugin neu geladen werden muss. Sobald der Ordner wieder leer ist, initialisiert BetterStructures ohne zu warten.

Siehe die gemeinsame Anleitung: Manuelle Importe vs. In-Game-Verwaltung.