Minecraft:Structure file

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

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

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.