BetterStructures Einrichtung

BetterStructures unterstützt weiterhin manuelle Importe, aber der aktuell empfohlene Workflow ist Nightbreak-zuerst und im Spiel.

Voraussetzungen

• WorldEdit oder FAWE-kompatible Schematic-Unterstützung
• Java 21 Runtime für die aktuelle Build-Linie

Empfohlener Workflow

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 einen schnellen Bootstrap (es 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.

Option	Was sie bewirkt
Recommended Setup	Markiert 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 Setup	Markiert die Einrichtung als abgeschlossen und überlässt dir die Inhaltsverwaltung, mit einem Verweis auf /bs setup und den imports-Ordner.
Use Current Content	Blendet die Aufforderung aus und behält die bereits installierten Inhalte bei, dann wird neu geladen. Sind keine Inhalte installiert, wird das gemeldet und auf /bs setup verwiesen.

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 seitenweises Menü, in dem Pakete in zwei Filter aufgeteilt sind: Strukturpakete und Modulpakete. Jedes Paket zeigt an, ob es installiert, heruntergeladen aber nicht aktiviert, veraltet ist oder Nightbreak-Zugang benötigt; ein Klick darauf installiert/aktualisiert es.

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). 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. Dies ist standardmäßig deaktiviert und wird durch den Schlüssel nightbreak.autoDownloadPluginUpdates in config.yml gestützt. Ein Neustart ist weiterhin erforderlich, um ein heruntergeladenes Plugin-Update anzuwenden.
• 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.

Sollten die Dateien eines Pakets beschädigt oder teilweise gelöscht sein, repariert /bs setup sie nicht – es vergleicht Versionen und hält das Paket für aktuell. Verwende stattdessen /bs forcereinstallcontent <package|all>.

Manueller Import-Fallback

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.