Minecraft:Structure file: Difference between revisions

Latest revision as of 11:18, 5 September 2026

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:Collapse

Bedrock 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

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:Collapse

Template:Collapse

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: 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: 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: 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.

History

Template:HistoryTable

Navigation

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:结构存储格式

@@ Line 6: / Line 6: @@
 Structure files are stored as .nbt files in [[Minecraft:data pack]]s in the {{file|directory|inline=1|data/{{ph|namespace}}/structure}} folder.
-They can be saved and loaded using the [[Minecraft:Structure Block]]. When saved from Structure Blocks they are saved into the {{cd|generated/{{ph|namespace}}/structures}} subfolder in the world save folder. When no namespace is given, then the {{cd|minecraft}} namespace is used.
+They can be saved and loaded using the [[Minecraft:Structure Block]]. When saved from Structure Blocks they are saved into the {{cd|generated/{{ph|namespace}}/structure}} subfolder in the world save folder. When no namespace is given, then the {{cd|minecraft}} namespace is used.
 Structure files can also be placed using the {{cmd|place template}} command. They are also used during the generation of some [[Minecraft:structure]]s and of [[Minecraft:fossil]] features.