.mcstructure Editor – Bedrock-Strukturdateien

Unterstützt Minecraft Bedrock Edition und Java Edition – einschließlich jedes bekannten oder seltenen Serverkerns: Vanilla, Paper, Spigot, Purpur, Folia, Fabric, Forge, NeoForge, Mohist, Sponge, Bedrock Dedicated Server, PocketMine-MP, Nukkit, PowerNukkitX, Cloudburst, Dragonfly, Endstone, LeviLamina und weitere. Vollständige Liste.

Eine Datei .mcstructure ist unkomprimiertes Little-Endian-NBT, das von einem Bedrock-Strukturblock geschrieben wurde. Ziehe eine Datei nach unten, um Größe, Blockpalette, Blockindizes und Block-Entity-Daten zu lesen und zu bearbeiten. Der Download verwendet dieselbe Kodierung. Add-on- und Kartenentwickler können damit Strukturen korrigieren, ohne die Welt erneut zu öffnen.

StrukturblöckeBedrock-Add-onsVerhaltenspaketeLittle-Endian-NBT

eine .mcstructure-Datei hier ablegen

level.dat · .nbt · .mcstructure · .schem · .schematic · .dat · Chunk-Abbilder

Inhalt einer Datei .mcstructure

TagTypInhalt
format_versionIntRevision des Strukturformats; in aktuellen Dateien 1
sizeListe von IntX-, Y- und Z-Abmessungen des erfassten Volumens
structure_world_originListe von IntPosition, an der die Struktur in der Welt erfasst wurde
structureCompoundEnthält alle folgenden Daten
structure.block_indicesListe von Int[]Zwei Ebenen mit Palettenindizes, normalerweise Blöcke und Waterlogging; -1 bedeutet „vorhandenen Block beibehalten“
structure.entitiesListe von CompoundMit der Struktur erfasste Entities
structure.palette.default.block_paletteListe von CompoundJeder unterschiedliche Blockzustand: name, states, version
structure.palette.default.block_position_dataCompoundBlock-Entity-NBT, indiziert mit dem flachen Positionsindex

Die Indizes in block_indices laufen über X, dann Z und dann Y. Der flache Index (x * sizeZ + z) * sizeY + y verweist auf die Palettenliste. Mit dieser Zuordnung lässt sich ein einzelner falsch gesetzter Block korrigieren, ohne die Struktur neu zu erzeugen.

Typische Änderungen

  • Einen Blocktyp überall ersetzen: Bearbeite einen Eintrag in block_palette. Jede Position mit diesem Index ändert sich dadurch.
  • Einen Blockzustand korrigieren: Ändere beispielsweise einen falschen Wert facing oder versehentliches waterlogged im Compound states.
  • Entities entfernen, die versehentlich erfasst wurden, indem du Einträge aus der Liste entities löschst.
  • Block-Entity-Daten reparieren: Truheninhalte, Schildtext und Spawner-Einstellungen liegen in block_position_data.
  • Versionsangaben prüfen, wenn eine Struktur nach einem Spielupdate mit falschen Blöcken importiert wird.

Speicherort der Dateien

Strukturblöcke speichern im Ordner structures/ des Weltverzeichnisses. Die Dateien heißen <namespace>_<name>.mcstructure. Verhaltenspakete liefern sie in ihrem eigenen Ordner structures/ aus, aus dem das Spiel sie nach Namespace lädt. Beide Varianten verwenden dasselbe Format und lassen sich hier öffnen.

Das Gegenstück der Java Edition ist die gzip-komprimierte Big-Endian-Strukturdatei .nbt mit anderer Kodierung und Tag-Struktur. Die Seite zum Java-Editor beschreibt diese Dateien; auch dieser Editor kann sie öffnen.

Häufig gestellte Fragen

Kann ich .mcstructure in eine Java-Struktur .nbt konvertieren?

Der Editor kann die Bytes als Big-Endian mit gzip neu kodieren, doch die Tag-Strukturen unterscheiden sich. Java-Strukturen verwenden palette/blocks mit anderen Schlüsseln und Blocknamen. Eine neu kodierte Datei ist lesbar, aber keine gültige Java-Struktur.

Warum ist meine .mcstructure-Datei nicht komprimiert?

Bedrock schreibt Strukturdateien als reines Little-Endian-NBT ohne gzip-Hülle. Das ist normal; der Editor erkennt das Format als Bedrock-Rohdaten.

Was bedeutet der Index -1 in block_indices?

Er kennzeichnet eine Position, die von der Struktur nicht verändert wird. Beim Platzieren bleibt der vorhandene Block in der Welt erhalten.

Kann ich eine Struktur durch Ändern von size vergrößern?

Nicht allein dadurch. block_indices enthält einen Eintrag pro Position, seine Array-Länge muss also exakt zum neuen Volumen passen. Wenn nur size geändert wird, lehnt das Spiel die Datei ab.

Verwandte Werkzeuge