Minecraft Wiki

The Minecraft Wiki is no longer considered as official by Microsoft and therefore several changes are required to be made, including to the wiki's logo. Please read this announcement for more information.

READ MORE

Minecraft Wiki
Advertisement
Minecraft Wiki
This article is about the format used by structure blocks. For the similar format used by many community programs, see Schematic file format.
Information icon.svg
This feature is exclusive to Java Edition. 

Structure files are stored as an NBT file. This file format is used to store structures such as end city, igloo and fossil into the data/minecraft/structures folder inside client.jar. Custom structures can also be saved and loaded using the structure block. These structures are saved into the generated/minecraft/structures subfolder in the world save folder.

Structure Files[]

NBT structure[]

All the specified positions are relative to the block located toward -X, -Y, -Z.

  • The root tag.
    •  DataVersion: Data version of the NBT structure.
    •  author: Name of the player who created this structure. Only exists for structures saved before 1.13.
    •  size: 3 TAG_Int describing the size of the structure.
    •  palette: Set of different block states used in the structure.
      • A block.
        •  Name: Block ID.
        •  Properties: List of block state properties, with [name] being the name of the block state property.
          •  Name: The block state name and its value.
    •  palettes: Sets of different block states used in the structure, a random palette gets selected based on coordinates. Used in vanilla by shipwrecks.
      • A set of different block states used in the structure.
        • A block.
          •  Name: Block ID.
          •  Properties: List of block state properties, with [name] being the name of the block state property.
            •  Name: The block state name and its value.
    •  blocks: List of individual blocks in the structure.
      • An individual block.
        •  state: Index of the block in the palette.
        •  pos: 3 TAG_Int describing the position of this block.
        •  nbt: NBT of the associated block entity (optional, only present if the block has one). Does not contain x, y, or z fields. See Block entity format.
    •  entities: List of entities in the structure.
      • An entity.
        •  pos: 3 TAG_Double describing the exact position of the entity.
        •  blockPos: 3 TAG_Int describing the block position of the entity.
        •  nbt: NBT of the entity (required). See entity format.
Advertisement