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 die Inhaltsregister, die während des Neuladens neu aufgebaut werden. Sie werden deshalb für diese Dauer mit einer Meldung abgelehnt, dass Inhalte neu geladen werden. Scans neuer Chunks und ausstehende Dungeon-Scans warten, bis das Neuladen erfolgreich beendet ist. Wird ein vorgemerkter Chunk entladen, wartet sein Scan darauf, dass der Chunk wieder geladen wird. Warte auf die Erfolgsmeldung 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.
Der Schalter gilt serverweit. Die Meldungen gehen an Spieler mit der Berechtigung betterstructures.warn, die online sind; OPs haben sie standardmäßig. Du kannst diese Berechtigung also auch einzelnen Teammitgliedern entziehen.
Was bedeutet setupDone?
setupDone verfolgt, ob der BetterStructures-Ersteinrichtungsablauf abgeschlossen wurde.
falsebedeutet, dass der Einrichtungsablauf noch als unvollständig gilttruebedeutet, 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
minAmountmuss mindestens1seinmaxAmountdarf höchstens64sein- 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 wirdpregenerationTPSPauseThreshold(Standard:12.0) – TPS-Wert, unter dem die Vorgenerierung pausiertpregenerationTPSResumeThreshold(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 v2:
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.
Verwendet deine alte Datei Valid worlds, wird sie beim Update archiviert und mit den aktuellen Standardwerten neu erzeugt. Übertrage deine gewünschten Einstellungen nach Valid worlds v2, wie in der Anleitung zum Konfigurationsupgrade beschrieben.
Beachte außerdem diese beiden Verhaltensweisen:
- Neue, von EliteMobs verwaltete Welten sind standardmäßig ausgeschlossen. BetterStructures prüft das Eigentumsregister von EliteMobs und trägt diese Welten als
falseein, auch wennNew worlds spawn structuresauftruesteht. Bestehende Einstellungen bleiben erhalten, einschließlich eines ausdrücklich gesetztentrue. Eine aktivierte verwaltete Welt löst eine Warnung aus. Ein Weltname mit dem Präfixem_belegt keine Zugehörigkeit zu EliteMobs. Die alte Migrationsmarkierung wird nicht mehr verwendet. - Einträge gelöschter Welten werden entfernt. Beim Start und etwa zehn Sekunden nach dem Entladen einer Welt entfernt BetterStructures jeden
Valid worlds v2-Eintrag, dessen Welt weder geladen noch auf der Festplatte vorhanden ist, damit die Datei keine toten Einträge ansammelt.
Kann ich ein Plugin-Update ohne Neustart anwenden?
Ja. Nachdem /bs downloadpluginupdate, /bs downloadall oder das Setup-Menü ein Update heruntergeladen hat, führe /bs applypluginupdate aus. Damit heruntergeladene Updates automatisch angewendet werden, setze nightbreak.applyPluginUpdatesWithoutRestart in config.yml auf when-empty oder immediately. Unter Befehle erfährst du, was der Austausch neu lädt und wann er verweigert wird.
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.