Zum Hauptinhalt springen

BetterStructures FAQ

Wenn deine Frage die erstmalige Nightbreak-Verknüpfung, Paketdownloads oder manuelle Importe betrifft, beginne zuerst mit den gemeinsamen globalen Seiten. Diese FAQ enthält nur BetterStructures-spezifische Antworten.

Warum erscheinen keine Strukturen?​

Der häufigste Grund ist, dass du in einem Terrain testest, das bereits erkundet wurde, bevor BetterStructures installiert war.

BetterStructures ist darauf ausgelegt, in unerforschtem Terrain zu generieren und füllt alte Chunks nicht nachträglich auf. Wenn du die natürliche Generierung schnell sehen möchtest:

  • fliege in frische Chunks
  • generiere eine neue Testwelt
  • oder verwende die Platzierungs- und Setup-Befehle, anstatt auf natürliche Generierung zu warten

Warum hat sich BetterStructures nach einem Neuladen selbst deaktiviert?​

/bs reload leert jedes Inhaltsregister, bevor ein Worker-Thread sie neu aufbaut. Wirft dieser Neuaufbau eine Exception, bliebe ein Plugin zurück, das aktiviert aussieht, aber unvollständige oder leere Inhalte hat – deshalb scheitert BetterStructures bewusst kontrolliert und deaktiviert sich stattdessen selbst.

Der eigentliche Fehler wird unmittelbar vor der Deaktivierung in der Konsole ausgegeben. Behebe die dort genannte Konfiguration oder das Schematic und starte den Server dann neu.

Warum wird mein Befehl abgelehnt, während ein Neuladen läuft?​

/bs place, /bs lootify, /bs pregenerate und /bs generateModules lesen oder verändern allesamt die Inhaltsregister, die der Reload-Worker besitzt, und werden daher für diese Dauer mit der Meldung „content is reloading“ abgelehnt. Neu generierte Chunks werden in diesem Zeitfenster ebenfalls übersprungen. Warte, bis das Neuladen Erfolg meldet, und versuche es erneut.

/bs reload erneut während eines laufenden Neuladens auszuführen schlägt nicht fehl – deine Anfrage wird in die Warteschlange gestellt, und sobald das erste fertig ist, läuft ein weiteres vollständiges Neuladen, sodass Dateiänderungen, die du mitten im Neuladen vorgenommen hast, trotzdem übernommen werden.

Wie stoppe ich die Admin-Warnungen über neue Strukturen?​

BetterStructures hat einen warnAdminsAboutNewBuildings-Schalter in config.yml, und /betterstructures silent ändert diesen Wert für dich.

Dies ist nützlich während der Vorgenerierung oder anderen admin-intensiven Tests, bei denen die Warnungen störend werden.

Was bedeutet setupDone?​

setupDone verfolgt, ob der BetterStructures-Ersteinrichtungsablauf abgeschlossen wurde.

  • false bedeutet, dass der Einrichtungsablauf noch als unvollständig gilt
  • true bedeutet, dass der Einrichtungsablauf bereits abgeschlossen wurde

Wenn du die Einrichtung absichtlich erneut ausführen möchtest, setze setupDone: false, lade das Plugin neu und führe /bs initialize erneut aus.

Benötigt BetterStructures WorldEdit?​

Ja. WorldEdit ist eine harte Abhängigkeit in plugin.yml, daher wird nicht erwartet, dass BetterStructures ohne es läuft.

Wie funktioniert die WorldGuard-Integration?​

Wenn sowohl WorldGuard als auch EliteMobs installiert sind, registriert und verwendet BetterStructures das Flag betterstructures-protect für seine geschützten Bereiche. Beide Plugins müssen vorhanden sein, damit der WorldGuard-Schutz aktiv wird.

Der relevante Konfigurationsschalter ist:

protectEliteMobsRegions: true

Setze es auf false, wenn du keinen BetterStructures-verwalteten WorldGuard-Schutz für unterstützte Inhalte möchtest.

Die Nachricht, die Spielern angezeigt wird, wenn sie in einem geschützten Bereich Blöcke abbauen oder platzieren wollen, ist ebenfalls konfigurierbar:

regionProtectedMessage: "&8[BetterStructures] &cDefeat the zone's bosses to edit blocks!"

Kann ich benutzerdefinierte Items zum BetterStructures-Schatz hinzufügen?​

Ja. BetterStructures enthält:

/betterstructures lootify <generator> <rarity> <minAmount> <maxAmount> <weight>

Verwende es, während du das Item hältst, das du registrieren möchtest. Der Befehl schreibt das gehaltene Item in den ausgewählten Schatzgenerator-Eintrag.

Aktuelle Validierungsregeln aus der Befehlsimplementierung:

  • der Schatzgenerator muss existieren
  • die Seltenheit muss bereits in dieser Schatzkonfiguration existieren
  • minAmount muss mindestens 1 sein
  • maxAmount darf höchstens 64 sein
  • das gehaltene Item darf nicht Luft sein

Unterstützt BetterStructures MMOItems-Schatzeinträge?​

Ja. BetterStructures hat MMOItems-Unterstützung im Projekt und der bestehende Schatz-Workflow unterstützt Items von Drittanbietern. Für MMOItems-spezifische Syntax halte die exakten Konfigurationsbeispiele in deinen Schatzdateien gemäß der aktuellen Schatzseiten-Dokumentation, anstatt dich auf ältere FAQ-Ausschnitte zu verlassen.

Wie arbeiten EliteMobs und BetterStructures zusammen?​

BetterStructures hat eine Soft-Integration mit EliteMobs.

Auf hoher Ebene:

  • BetterStructures kann EliteMobs-Inhaltsmarker in generierten Strukturen platzieren
  • BetterStructures kann auch geschützte Bereiche verwalten, die für EliteMobs-unterstützte Inhalte relevant sind, wenn die Integration aktiviert ist

Für den gemeinsamen Setup-Ablauf, die Token-Verknüpfung und den offiziellen Paketlebenszyklus verwende die globalen Docs und die BetterStructures-Setup-/Inhaltsseiten, anstatt diese FAQ als primäre Quelle zu behandeln.

Kann ich eine Welt sicherer vorgenerieren?​

Ja. BetterStructures bietet leistungsorientierte Vorgenerierungseinstellungen in config.yml, einschließlich:

  • percentageOfTickUsedForPregeneration (Standard: 0.1) – wie viel von jedem Server-Tick für die Chunk-Vorgenerierung verwendet wird
  • pregenerationTPSPauseThreshold (Standard: 12.0) – TPS-Wert, unter dem die Vorgenerierung pausiert
  • pregenerationTPSResumeThreshold (Standard: 14.0) – TPS-Wert, ab dem die Vorgenerierung fortgesetzt wird

Für normales Struktur-Einfügen ist die Hauptgeschwindigkeitseinstellung:

percentageOfTickUsedForPasting: 0.2

Niedrigere Werte reduzieren die Pro-Tick-Auswirkung, machen das Struktur-Einfügen aber langsamer.

Wie werden Strukturstandorte bestimmt?​

BetterStructures behält Pro-Strukturtyp-Abstands- und Zufalls-Offset-Steuerungen in config.yml. Die vollständige Referenz findest du unter Konfiguration.

Jeder Strukturtyp wird auf seinem eigenen seed-basierten Rautengitter platziert. Die Distanz- und Offset-Werte werden in Chunks gemessen, nicht in Blöcken – ein distanceSurface von 27 bedeutet ungefähr eine Oberflächenstruktur alle 27 Chunks, also etwa 432 Blöcke.

Die Hauptabstandssteuerungen sind:

  • distanceSurface (Standard: 27)
  • distanceShallow (Standard: 22)
  • distanceDeep (Standard: 22)
  • distanceSky (Standard: 90)
  • distanceLiquid (Standard: 60)
  • distanceDungeonV2 (Standard: 80)

Die zugehörigen Offset-Steuerungen sind:

  • maxOffsetSurface (Standard: 5)
  • maxOffsetShallow (Standard: 5)
  • maxOffsetDeep (Standard: 5)
  • maxOffsetSky (Standard: 5)
  • maxOffsetLiquid (Standard: 5)
  • maxOffsetDungeonV2 (Standard: 18)

Distanzen müssen mindestens 1 betragen. Offsets müssen zwischen 0 und 1073741823 liegen (dem größten Wert, den der Platzierungs-Zufallsgenerator gefahrlos verwenden kann). Liegt ein Wert außerhalb seines gültigen Bereichs, protokolliert BetterStructures eine Warnung, schreibt den Standardwert dieses Schlüssels zurück in die config.yml und arbeitet mit dem Standard weiter, statt die Generierung abzubrechen.

In der Praxis bedeutet dies, dass die Generierung seed-gesteuert und konfigurationsgesteuert bleibt, anstatt bei jedem Neustart zufällig neu gemischt zu werden.

Was macht modularChunkPastingSpeed?​

Derzeit nichts. modularChunkPastingSpeed (Standard: 10) wird zwar weiterhin in die config.yml geschrieben, aber nichts im Plugin liest den Wert aus, eine Änderung hat also keine Wirkung. Das Einfügen wird stattdessen über percentageOfTickUsedForPasting getaktet – verwende diesen Schlüssel, wenn du einstellen willst, wie viel von jedem Tick BetterStructures für das Platzieren von Blöcken aufwendet.

Was macht spawnProtectionRadius?​

spawnProtectionRadius (Standard: 100) definiert den Mindestabstand in Blöcken von den Weltkoordinaten 0, 0, innerhalb dessen keine Strukturen platziert werden. Dies gilt für alle Welten. Auf 0 setzen, um den Spawn-Schutz zu deaktivieren.

Wie deaktiviere ich Strukturen in bestimmten Welten?​

BetterStructures pflegt eine Konfigurationsdatei ValidWorlds.yml, die steuert, welche Welten für die Strukturgenerierung infrage kommen. Jede Welt ist mit einem booleschen Schalter aufgeführt:

New worlds spawn structures: true
Valid worlds:
  world: true
  world_nether: true
  world_the_end: true

Setze eine Welt auf false, um zu verhindern, dass BetterStructures dort Strukturen platziert. Die Einstellung New worlds spawn structures steuert, ob neu erkannte Welten automatisch für die Strukturgenerierung aktiviert werden.

Zwei Verhaltensweisen sind es wert, bekannt zu sein:

  • Von EliteMobs verwaltete Welten sind standardmäßig ausgeschlossen. Welten, die EliteMobs gehören – der Abenteurergilden-Hub und instanziierte Dungeon-Kopien –, werden als false registriert, selbst wenn New worlds spawn structures auf true steht. Ihre unbebauten Void-Chunks zählen als neue Chunks, was zuvor dazu führte, dass BetterStructures Dungeon-Hubs dekorierte. Bestehende em_-Einträge wurden durch eine einmalige Migration ein einziges Mal auf false umgestellt; der Markierungsschlüssel EliteMobs worlds excluded by default in der Datei hält fest, dass dies bereits geschehen ist – setzt du eine em_-Welt also bewusst wieder auf true, überlebt deine Entscheidung Neustarts.
  • Einträge gelöschter Welten werden entfernt. Beim Start und etwa zehn Sekunden nach dem Entladen einer Welt entfernt BetterStructures jeden Valid worlds-Eintrag, dessen Welt weder geladen noch auf der Festplatte vorhanden ist, damit die Datei keine toten Einträge ansammelt.

Wie repariere ich ein beschädigtes oder teilweise gelöschtes Inhaltspaket?​

Verwende /bs forcereinstallcontent <package|all>. Normale Downloads vergleichen Versionen und überspringen alles, was bereits aktuell ist – genau das falsche Verhalten, wenn die Dateien auf der Festplatte beschädigt sind. Die erzwungene Neuinstallation schickt das Paket unabhängig von der Version erneut durch dieselbe authentifizierte Download-, Import- und Reload-Pipeline.

all deckt jedes Paket ab, das BetterStructures derzeit als heruntergeladen, installiert oder veraltet sieht. Sind die Dateien eines Pakets vollständig verschwunden, kann BetterStructures es nicht mehr sehen – nenne dann stattdessen direkt seinen Slug; die Tab-Vervollständigung listet jeden bekannten Slug auf.