Minecraft:Structure file: Difference between revisions
More actions
Sync: updated from Minecraft |
Sync: updated from Minecraft |
||
| Line 2,319: | Line 2,319: | ||
==History== | ==History== | ||
{{info needed section|History of structure files on Bedrock Edition.}} | |||
=== ''Java Edition'' === | |||
{{HistoryTable | {{HistoryTable | ||
|{{HistoryLine|java}} | |{{HistoryLine|java}} | ||
| Line 2,326: | Line 2,329: | ||
|Added {{nbt|int|DataVersion}} that is set to the [[Minecraft:data version]] of the version of the game that saved the file.}} | |Added {{nbt|int|DataVersion}} that is set to the [[Minecraft:data version]] of the version of the game that saved the file.}} | ||
|{{HistoryLine||1.21|dev=24w21a|Moved structure files from {{file|directory|inline=1|structures}} to {{file|directory|inline=1|structure}}.}} | |{{HistoryLine||1.21|dev=24w21a|Moved structure files from {{file|directory|inline=1|structures}} to {{file|directory|inline=1|structure}}.}} | ||
}} | |||
=== ''Bedrock Edition'' === | |||
{{HistoryTable | |||
|{{HistoryLine|bedrock}} | |||
|{{HistoryLine||?|Added structure files.}} | |||
|{{HistoryLine||26.50|dev=Preview 26.50.24|Added version 2 structure files.}} | |||
|{{HistoryLine||26.60|dev=Preview 26.60.29|Version 2 structure files now have a tag named {{nbt|int|compression}} which controls use of zlib compression.}} | |||
}} | }} | ||
Latest revision as of 11:24, 14 October 2026
 |
For the {{{Description}}} of the same name, see [[{{{Destination}}}]]. |
A structure file (also called structure template) is an Minecraft:NBT file that stores small structures of blocks and entities. Structure files are used to store some structures such as Minecraft:end cities, Minecraft:igloos, and Minecraft:fossils.
Usage
Java Edition
Structure files are stored as .nbt files in Minecraft:data packs in the Template:File folder.
They can be saved and loaded using the Minecraft:Structure Block. When saved from Structure Blocks they are saved into the Template:Cd subfolder in the world save folder. When no namespace is given, then the Template:Cd namespace is used.
Structure files can also be placed using the Template:Cmd command. They are also used during the generation of some Minecraft:structures and of Minecraft:fossil features.
Prebuild structures
Template:Collapse Template:Collapse Template:Collapse Template:Collapse Template:Collapse Template:Collapse Template:Collapse Template:Collapse Template:Collapse Template:Collapse Template:Collapse Template:Collapse Template:Collapse
Template:CollapseBedrock Edition
Structure files are stored using the Minecraft:NBT format in the game files. In Minecraft:behavior packs, they are stored as Template:Cd files in the Template:Cd folder.
Prebuild structures
NBT structure
All the specified positions are relative to the block located toward -X, -Y, -Z.
- Template:Nbt The root tag.
- Template:Nbt: Minecraft:Data version of the NBT structure.
Template:Nbt: Name of the player who created this structure. Only exists for structures saved before 1.13.- Template:Nbt: 3 TAG_Int describing the size of the structure.
- Template:Nbt: Set of different block states used in the structure.
- Template:Nbt A block.
- Template:Nbt: Block ID.
- Template:Nbt: List of Minecraft:block state properties.
- Template:Nbt: The value of the corresponding state property.
- Template:Nbt A block.
- Template:Nbt: Sets of different block states used in the structure, a random palette gets selected based on coordinates. Used in vanilla by shipwrecks.
- Template:Nbt A set of different block states used in the structure.
- Template:Nbt A block.
- Template:Nbt: Block ID.
- Template:Nbt: List of Minecraft:block state properties.
- Template:Nbt: The value of the corresponding state property.
- Template:Nbt A block.
- Template:Nbt A set of different block states used in the structure.
- Template:Nbt: List of individual blocks in the structure.
- Template:Nbt An individual block.
- Template:Nbt: Index of the block in the palette.
- Template:Nbt: 3 TAG_Int describing the position of this block.
- Template:Nbt: NBT of the associated Minecraft:block entity (optional, only present if the block has one). Does not contain x, y, or z fields. See Minecraft:Block entity format.
- Template:Nbt An individual block.
- Template:Nbt: List of entities in the structure.
- Template:Nbt An entity.
- Template:Nbt: 3 TAG_Double describing the exact position of the entity.
- Template:Nbt: 3 TAG_Int describing the block position of the entity.
- Template:Nbt: NBT of the entity (required). See Minecraft:entity format.
- Template:Nbt An entity.
History
Java Edition
Bedrock Edition
Template:Navbox Java Edition technical Template:Navbox Bedrock Edition
Minecraft:de:Konstruktionsvorlagen Minecraft:fr:Fichier de structure Minecraft:ja:構造物ファイルフォーマット Minecraft:pt:Modelo de estrutura Minecraft:zh:结构存储格式