BetterStructures Befehle

Verwende /betterstructures oder /bs.

Setup und Inhalte

Befehl	Zweck
/bs	Hauptbefehl für die Hilfe
/bs initialize	Ersteinrichtungsablauf (öffnet das Ersteinrichtungsmenü)
/bs setup	Öffnet das Setup-/Inhaltsmenü
/bs recommendedplugins	Zeigt Begleit-Plugins an, die gut mit BetterStructures funktionieren
/bs downloadall	Lädt das Plugin-Update (falls vorhanden) und alle verfügbaren Inhalte herunter und lädt dann neu
/bs downloadallcontent	Lädt nur alle verfügbaren Inhaltspakete herunter (kein Plugin-Update)
/bs updatecontent	Lädt Updates für veraltete Inhalte herunter (Alias: /bs updateallcontent)
/bs forcereinstallcontent <package|all>	Lädt Inhalte über die normale authentifizierte Pipeline erneut herunter, selbst wenn die installierte Version bereits aktuell ist. Die Tab-Vervollständigung bietet all sowie jeden Nightbreak-Paket-Slug an.
/bs downloadpluginupdate	Lädt ein ausstehendes Plugin-Update herunter. Ein Neustart wendet es an, sofern /bs applypluginupdate oder die Einstellung nightbreak.applyPluginUpdatesWithoutRestart es nicht schon früher anwendet.
/bs applypluginupdate	Wendet ein heruntergeladenes Plugin-Update an, ohne den Server neu zu starten
/bs reload	Lädt Konfigurationen und Inhalte von BetterStructures neu und importiert ausstehende Inhalte
/bs version	Zeigt die Plugin-Version an

Über /bs reload

/bs reload deaktiviert und reaktiviert das Plugin nicht mehr. Es führt jetzt ein In-Place-Neuladen der Inhalte durch: config.yml und ValidWorlds.yml werden im Server-Thread neu eingelesen, anschließend werden die Konfigurationen für Schätze, Generatoren, Modulgeneratoren, Spawn-Pools, Schematics, Module und Inhaltspakete in einem Worker-Thread neu aufgebaut. Befehle, Listener und der NMS-Adapter bleiben registriert.

Wissenswerte Konsequenzen:

• Das Neuladen bricht laufende Vorgenerierung und modulare Generierung ab und stoppt Struktur- und Dungeon-Platzierungen, die noch in der Warteschlange stehen oder gerade laufen, an ihrem aktuellen Stand. Auch das Setup-Menü und das Menü der Ersteinrichtung sind währenddessen nicht verfügbar.
• Während des Neuladens werden /bs place, /bs lootify, /bs pregenerate und /bs generateModules mit einer "content is reloading"-Meldung abgelehnt. Scans neuer Chunks bleiben vorgemerkt, bis das Neuladen erfolgreich endet. Auch ausstehende Dungeon-Scans bleiben erhalten. Wird ein vorgemerkter Chunk entladen, wartet sein Scan darauf, dass der Chunk wieder geladen wird.
• Wenn du /bs reload erneut auslöst, während bereits eines läuft, wird deine Anfrage in die Warteschlange gestellt und danach läuft ein zweites vollständiges Neuladen, sodass eine mitten im Neuladen geänderte Datei trotzdem übernommen wird.
• Schlägt das Neuladen fehl, deaktiviert sich BetterStructures absichtlich selbst, statt mit halbleeren Inhaltsregistern weiterzumachen. Prüfe die Konsole auf die Ursache und starte den Server nach der Behebung neu.

Über /bs forcereinstallcontent

Normale Downloads überspringen ein Paket, dessen lokale Version bereits mit der entfernten übereinstimmt, was sie nutzlos macht, wenn die Dateien auf der Festplatte beschädigt oder teilweise gelöscht wurden. forcereinstallcontent umgeht diese Versionsprüfung und schickt das ausgewählte Paket erneut durch dieselbe authentifizierte Download-, Import- und Reload-Pipeline.

• all wählt jedes Paket aus, das BetterStructures derzeit für heruntergeladen, installiert oder veraltet hält. Passt nichts, lehnt der Befehl ab und bittet dich, einen Slug direkt zu nennen – genau das brauchst du, wenn die Dateien eines Pakets vollständig fehlen.
• Die Angabe eines einzelnen Slugs installiert nur dieses Paket neu.
• Ein unbekannter Slug wird mit einer Meldung abgelehnt, die auf die Tab-Vervollständigung verweist.

Über /bs applypluginupdate

/bs applypluginupdate spielt ein BetterStructures-Update ein, das bereits heruntergeladen ist und im Update-Ordner des Servers wartet, ohne Neustart. Der Befehl deaktiviert BetterStructures und jedes MagmaGuy-Plugin, das davon abhängt, ersetzt die Jar und lädt und aktiviert sie anschließend wieder. Die Plugins, die dabei mit neu geladen werden, werden im Chat aufgelistet. Lässt sich die neue Jar nicht aktivieren, wird die vorherige Jar wieder geladen und das Update bleibt für den nächsten Neustart vorgemerkt.

Der Befehl verweigert die Ausführung, wenn kein Update vorgemerkt ist, wenn die vorgemerkte Jar ungültig oder nicht neuer als die laufende Version ist, oder wenn ein Plugin eines anderen Autors von BetterStructures abhängt. Starte den Server in diesem Fall neu. Laufende Bosse, Arenen und Dungeon-Instanzen enden, wenn das Plugin neu geladen wird.

Um heruntergeladene Updates automatisch anzuwenden, setze nightbreak.applyPluginUpdatesWithoutRestart in config.yml (siehe Konfiguration).

Die Download-/Update-, Begleit-Plugin- und Plugin-Update-Befehle werden vom gemeinsamen MagmaCore-Nightbreak-System bereitgestellt, das in BetterStructures gebündelt ist. Dasselbe Setup-Menü stellt einen Plugin Update-Eintrag, einen Recommended Plugins-Eintrag und einen Automatic Updates-Schalter bereit (siehe Einrichtung).

Hilfs- und Admin-Befehle

Befehl	Zweck
/bs place <schematic> <type>	Sucht ausgehend vom aktuellen Chunk des Spielers einen passenden Strukturstandort; die Suche kann eine benachbarte Position wählen. Gültige Typen: SURFACE, UNDERGROUND_SHALLOW, UNDERGROUND_DEEP, SKY, LIQUID_SURFACE
/bs lootify <generator> <rarity> <minAmount> <maxAmount> <weight>	Fügt das gehaltene Item zu einer Schatztabelle hinzu. Der Generator muss eine gültige Schatzkonfiguration sein, die Seltenheit muss in dieser Konfiguration existieren, minAmount muss mindestens 1 sein, maxAmount darf höchstens 64 sein, und du musst ein Item halten.
/bs pregenerate <centerType> <shape> <radiusInBlocks> <applyWorldBorder>	Generiert Chunks mit aktiviertem BetterStructures vor. Die Welt wird von der aktuellen Welt des Spielers abgeleitet. centerType: HERE, WORLD_CENTER, WORLD_SPAWN. shape: SQUARE, CIRCLE. applyWorldBorder: TRUE/FALSE.
/bs cancelPregenerate	Bricht die aktive Vorgenerierung in der aktuellen Welt des Spielers ab (Alias: /bs cancelpregenerate)
/bs generateModules <generatorFile>	Generiert modulare Inhalte aus einer Modulgeneratordatei
/bs teleport <world> <x> <y> <z>	Teleportiert zu einem bestimmten Ort (Alias: /bs tp)
/bs silent	Schaltet bestimmte Operator-Warnungen um

Beachte bei diesen Hilfsbefehlen folgende Einschränkungen:

• /bs place meldet einen Platzierungsversuch, keine bestätigte Platzierung.
• Führe /bs lootify im Spiel mit dem Gegenstand in der Haupthand aus. Mengen und Gewicht müssen ganzzahlig sein. Wähle 1 <= minAmount <= maxAmount <= 64 und ein positives Gewicht; der Befehl weist nicht jeden ungültigen Bereich zurück. Das Speichern eines Eintrags startet ein Neuladen der Inhalte.
• /bs pregenerate akzeptiert einen Radius ab null Blöcken und rundet auf ganze Chunks auf. Bei applyWorldBorder gleich TRUE wird nach Abschluss eine quadratische Weltgrenze mit dem Durchmesser 2 × radiusInBlocks gesetzt, auch bei CIRCLE. Ein Abbruch setzt keine Weltgrenze und macht bereits generierte Chunks nicht rückgängig. Lässt sich ein Chunk nicht laden, stoppt die Vorgenerierung, protokolliert den fehlgeschlagenen Chunk und lässt die Weltgrenze unverändert.
• /bs teleport benötigt eine geladene Welt und ganzzahlige Koordinaten. Relative Koordinaten werden nicht unterstützt.

Berechtigungen

Berechtigung	Beschreibung	Standard
betterstructures.setup	Zugang zu /bs setup, /bs recommendedplugins, /bs downloadallcontent und /bs updatecontent	OP
betterstructures.initialize	Zugang zu /bs initialize	OP
betterstructures.generatemodules	Zugang zu /bs generateModules	OP
betterstructures.generatemodules.slowly	In plugin.yml registriert, wird aber derzeit von keinem Befehl im Quellcode verwendet. Vermutlich überflüssig.	OP
betterstructures.generatemodules.instantly	In plugin.yml registriert, wird aber derzeit von keinem Befehl im Quellcode verwendet. Vermutlich überflüssig.	OP
betterstructures.*	Wildcard für Dienstprogramm- und Admin-Befehle (place, pregenerate, cancelPregenerate, reload, teleport, version, lootify, /bs-Hilfe) plus die Admin-Inhaltsbefehle /bs downloadall, /bs downloadpluginupdate, /bs applypluginupdate und /bs forcereinstallcontent. Wird standardmäßig von OPs gehalten.	OP
betterstructures.*	Auch für /bs silent erforderlich, das die serverweite Warneinstellung ändert.	OP
betterstructures.warn	Erhält die anklickbaren Meldungen "new building generated" und "new dungeon started generating", solange warnAdminsAboutNewBuildings auf true steht. Nicht in plugin.yml deklariert, daher vergibt Bukkit sie standardmäßig an OPs.	OP

betterstructures.setup deckt die Befehle zum Durchsuchen/Verwalten von Inhalten ab, betterstructures.initialize deckt die Ersteinrichtung ab und betterstructures.generatemodules deckt die Dungeon-Generierung ab. Der kombinierte Plugin-und-Inhalts-Befehl /bs downloadall, die reinen Plugin-Befehle /bs downloadpluginupdate und /bs applypluginupdate sowie der auf Reparatur ausgerichtete /bs forcereinstallcontent sind hinter der Admin-Wildcard betterstructures.* gesperrt. Die Varianten .slowly und .instantly sind zwar weiterhin in plugin.yml deklariert, werden aber derzeit von keinem Befehl geprüft.

Jede der Berechtigungen betterstructures.*, betterstructures.setup, betterstructures.initialize und betterstructures.generatemodules erlaubt den Zugriff auf den Stammbefehl. Jeder Unterbefehl prüft weiterhin seine eigene Berechtigung. Ein Administrator, der nur die Einrichtung verwaltet, benötigt daher keine Wildcard.

betterstructures.* steuert außerdem die Erinnerung an die Ersteinrichtung: Spieler mit dieser Berechtigung erhalten zehn Sekunden nach jedem Beitritt einen Hinweis auf /bs initialize, solange setupDone in config.yml auf false steht.