BetterStructures Inhaltspakete
BetterStructures behandelt offizielle Inhalte jetzt als verwaltete Pakete anstelle eines reinen manuellen Import-Workflows.
Hauptbefehle
| Befehl | Zweck |
|---|---|
/bs initialize | Ersteinrichtungsablauf |
/bs setup | Paketzustand durchsuchen und verwalten |
/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 Inhalte herunter (kein Plugin-Update) |
/bs updatecontent | Aktualisiert veraltete Inhalte (Alias: /bs updateallcontent) |
/bs forcereinstallcontent <package|all> | Lädt Inhalte erneut herunter, selbst wenn die installierte Version bereits aktuell ist – der Reparaturbefehl für beschädigte oder teilweise gelöschte Pakete |
/bs recommendedplugins | Listet Begleit-Plugins auf, die gut mit BetterStructures harmonieren |
/nightbreaklogin <token> | Gemeinsame Nightbreak-Token-Registrierung |
Die Download- und Updatebefehle verwenden das mitgelieferte Nightbreak-System von MagmaCore für Token- und Zugangsprüfungen sowie Downloads. Anschließend importiert BetterStructures die Inhalte über seinen eigenen Neuladevorgang.
Pakettypen
Jedes Paket deklariert einen contentPackageType, und das Setup-Menü bietet einen Filter pro Typ:
contentPackageType | Filter im Setup-Menü | Dateien landen in |
|---|---|---|
STRUCTURE (Standard) | Strukturpakete | plugins/BetterStructures/schematics/<folderNameV2> |
MODULAR | Modulpakete | plugins/BetterStructures/modules/<folderNameV2> |
Verwende /bs setup, um Pakete zu filtern und zu inspizieren, anstatt dich auf alte statische Listen zu verlassen.
Felder der Paketkonfiguration
Jedes Paket wird durch eine Konfiguration in plugins/BetterStructures/content_packages beschrieben. Du musst diese nur selten von Hand bearbeiten – sie werden mit dem Plugin ausgeliefert und sind die Art, wie es den Paketzustand verfolgt –, aber die Felder sind:
| Schlüssel | Standard | Beschreibung |
|---|---|---|
isEnabled | true | Installationsstatus des Pakets, den das Setup-Menü ändert. Bei false wird nichts aus dem Paketordner geladen; siehe unten. |
name | — | Anzeigename im Setup-Menü |
description | — | Beschreibungszeilen im Setup-Menü |
downloadLink | — | Manueller Downloadlink für Pakete ohne nightbreakSlug; verwaltete Downloads verwenden den Slug |
version | 0 | Lokale Inhaltsversion, die mit der entfernten Version verglichen wird, um zu entscheiden, ob das Paket veraltet ist |
folderNameV2 | — | Unterordner, in dem die Dateien des Pakets liegen, je nach Typ unter schematics oder modules |
contentPackageType | STRUCTURE | STRUCTURE oder MODULAR |
nightbreakSlug | — | Nightbreak-Bezeichner für Zugangsprüfungen, Downloads und als Auswahl für /bs forcereinstallcontent |
Das Installieren oder Deinstallieren eines Pakets über das Setup-Menü ändert nur das isEnabled des Pakets und löst danach ein Neuladen aus. Die Schematic- und Modulkonfigurationen im Paket werden dabei nicht bearbeitet. Die Deinstallation lässt die Dateien auf der Festplatte.
Solange ein Paket isEnabled: false hat, überspringen der Schematic- und der Modullader seinen gesamten Ordner, schematics/<folderNameV2> bzw. modules/<folderNameV2>, einschließlich der Unterordner. Das gilt sowohl für STRUCTURE- als auch für MODULAR-Pakete. Innerhalb eines aktivierten Pakets hat jede Schematic- und Modulkonfiguration weiterhin ihr eigenes isEnabled.
Paketinhalt
Ein BetterStructures-Paket ist eine Zip-Datei, deren pack.meta betterstructures deklariert. Eine Zip-Datei ohne pack.meta, die in plugins/BetterStructures/imports abgelegt wird, wird genauso behandelt. Ihre Ordner auf oberster Ebene werden anhand ihres Namens entpackt:
| Ordner im Paket | Ziel |
|---|---|
content_packages, schematics, modules, module_generators, generators, treasures, spawn_pools, components | Der gleichnamige Ordner in plugins/BetterStructures |
custombosses, customitems, customtreasurechests, powers, enchantments | Der gleichnamige Ordner in plugins/EliteMobs |
models oder modelengine | Der Modellordner von FreeMinecraftModels oder der blueprints-Ordner von ModelEngine, wenn nur ModelEngine installiert ist |
scripts | plugins/FreeMinecraftModels/scripts |
freeminecraftmodels, elitemobs, betterstructures | Das Stammverzeichnis des Datenordners dieses Plugins, wobei die innere Struktur erhalten bleibt, zum Beispiel freeminecraftmodels/enchantments |
worldcontainer | Der Weltencontainer des Servers |
Ein Ordner auf oberster Ebene, der nicht in dieser Tabelle steht, führt dazu, dass der Importer das gesamte Paket ablehnt. Die gemeinsamen Importregeln findest du unter Manuelle Importe vs. In-Game-Verwaltung.
Fügt ein Paket EliteMobs-Inhalte hinzu, lädt BetterStructures EliteMobs nach dem Import neu. Importiert das Paket eines anderen Plugins Dateien in den BetterStructures-Ordner, führt BetterStructures ein Neuladen der Inhalte durch, sobald sein eigener Start abgeschlossen ist.
Paketzustände
Abhängig vom Paket und deinem Token-Zustand kann BetterStructures unterscheiden zwischen:
- installierten Inhalten
- heruntergeladenen, aber nicht aktivierten Inhalten
- veralteten Inhalten
- Inhalten, die Nightbreak-Zugang benötigen
Das Menü betrachtet einen vorhandenen Paketpfad als heruntergeladen und prüft zusätzlich das isEnabled des Pakets, um den Installationsstatus zu bestimmen. Das ist eine Statusanzeige, keine Integritätsprüfung: Auch ein leerer oder beschädigter Ordner kann als installiert erscheinen. Repariere die Dateien mit /bs forcereinstallcontent <package|all>. all wählt Pakete aus, die als heruntergeladen, installiert oder veraltet erkannt werden. Fehlt der gesamte Paketordner, gib den Slug direkt an.
Alternative: manueller Import
Manuelle Importe verwenden weiterhin:
plugins/BetterStructures/imports
Paket-Zips intakt lassen, dann BetterStructures bei Bedarf neu laden. Manueller Import wird weiterhin unterstützt, ist aber nicht mehr der hauptsächlich dokumentierte Workflow.