Zum Hauptinhalt springen

BetterStructures Befehle

Verwende /betterstructures oder /bs.

Setup und Inhalte

BefehlZweck
/bsHaupt-Hilfe- und Statusbefehl
/bs initializeErsteinrichtungsablauf (öffnet das Ersteinrichtungsmenü)
/bs setupÖffnet das Setup-/Inhaltsmenü
/bs recommendedpluginsZeigt Begleit-Plugins an, die gut mit BetterStructures funktionieren
/bs downloadallLädt das Plugin-Update (falls vorhanden) und alle verfügbaren Inhalte herunter und lädt dann neu
/bs downloadallcontentLädt nur alle verfügbaren Inhaltspakete herunter (kein Plugin-Update)
/bs updatecontentLä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 downloadpluginupdateLädt ein ausstehendes Plugin-Update herunter (erfordert einen Neustart zur Anwendung)
/bs reloadLädt Konfigurationen und Inhalte von BetterStructures neu und importiert ausstehende Inhalte
/bs versionZeigt 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:

  • Während ein Neuladen läuft, werden /bs place, /bs lootify, /bs pregenerate und /bs generateModules mit der Meldung „content is reloading“ abgelehnt, und neu generierte Chunks werden übersprungen statt gescannt.
  • 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.

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).

Dienstprogramm- und Admin-Befehle

BefehlZweck
/bs place <schematic> <type>Platziert eine Struktur manuell. 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 cancelPregenerateBricht 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 silentSchaltet bestimmte Operator-Warnungen um

Berechtigungen

BerechtigungBeschreibungStandard
betterstructures.setupZugang zu /bs setup, /bs recommendedplugins, /bs downloadallcontent und /bs updatecontentOP
betterstructures.initializeZugang zu /bs initializeOP
betterstructures.generatemodulesZugang zu /bs generateModulesOP
betterstructures.generatemodules.slowlyIn plugin.yml registriert, wird aber derzeit von keinem Befehl im Quellcode verwendet. Vermutlich überflüssig.OP
betterstructures.generatemodules.instantlyIn 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 und /bs forcereinstallcontent. Wird standardmäßig von OPs gehalten.OP
(keine)/bs silent hat im Quellcode keine Berechtigungsprüfung — jeder Sender kann es ausführen.

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, der reine Plugin-Befehl /bs downloadpluginupdate und 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.

betterstructures.* steuert außerdem die Erinnerung an die Ersteinrichtung: Spieler, die diese Berechtigung besitzen, erhalten beim Beitreten eine einmalige Nachricht, die auf /bs initialize verweist, bis setupDone in der config.yml auf true gesetzt ist.