Mineuniverse
Log in Register

Structure file

A structure file (also called structure template) is an NBT file that stores small structures of blocks and entities. Structure files are used to store…

79 min read Updated 7 views
Structures Bedrock Edition Data packs Development
Advertisement Remove ads with Premium →
Contents (7)
  1. Usage
  2. Java Edition
  3. Bedrock Edition
  4. NBT structure
  5. History
  6. Java Edition
  7. Bedrock Edition
This article is about the format used by structure blocks. For the similar format used by many community programs, see Schematic file format.

A structure file (also called structure template) is an NBT file that stores small structures of blocks and entities. Structure files are used to store some structures such as end cities, igloos, and fossils.

Usage

Java Edition

Structure files are stored as .nbt files in data packs in the File directory.png: Sprite image for directory in Minecraft data/<namespace>/structure folder.

They can be saved and loaded using the Structure Block. When saved from Structure Blocks they are saved into the generated/<namespace>/structure subfolder in the world save folder. When no namespace is given, then the minecraft namespace is used.

Structure files can also be placed using the /place template command. They are also used during the generation of some structures and of fossil features.

Prebuild structures

Bedrock Edition

Structure files are stored using the NBT format in the game files. In behavior packs, they are stored as .mcstructure files in the structures/<namespace> folder.

Prebuild structures

NBT structure

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

  • [NBT Compound / JSON Object] The root tag.
    • [Int] DataVersion: Data version of the NBT structure.
    • [String] author: Name of the player who created this structure. Only exists for structures saved before 1.13.
    • [NBT List / JSON Array] size: 3 TAG_Int describing the size of the structure.
    • [NBT List / JSON Array] palette: Set of different block states used in the structure.
      • [NBT Compound / JSON Object] A block.
        • [String] Name: Block ID.
        • [NBT Compound / JSON Object] Properties: List of block state properties.
          • [String] <state property name>: The value of the corresponding state property.
    • [NBT List / JSON Array] palettes: Sets of different block states used in the structure, a random palette gets selected based on coordinates. Used in vanilla by shipwrecks.
      • [NBT List / JSON Array] A set of different block states used in the structure.
        • [NBT Compound / JSON Object] A block.
          • [String] Name: Block ID.
          • [NBT Compound / JSON Object] Properties: List of block state properties.
            • [String] <state property name>: The value of the corresponding state property.
    • [NBT List / JSON Array] blocks: List of individual blocks in the structure.
      • [NBT Compound / JSON Object] An individual block.
        • [Int] state: Index of the block in the palette.
        • [NBT List / JSON Array] pos: 3 TAG_Int describing the position of this block.
        • [NBT Compound / JSON Object] 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.
    • [NBT List / JSON Array] entities: List of entities in the structure.
      • [NBT Compound / JSON Object] An entity.
        • [NBT List / JSON Array] pos: 3 TAG_Double describing the exact position of the entity.
        • [NBT List / JSON Array] blockPos: 3 TAG_Int describing the block position of the entity.
        • [NBT Compound / JSON Object] nbt: NBT of the entity (required). See entity format.


History

Java Edition

Java Edition
1.915w31a Added structure files.
1.1016w20a Changed structure files to their current format. Before this, [NBT List / JSON Array] palette did not exist. Instead of referring to an index in the palette, [Int] state encoded the block ID and metadata at that position. The last byte encodes the block id, and the second-to-last byte encodes the block data.
1.11 Removed [Int] version. Before its removal, its value was always 1.
Added [Int] DataVersion that is set to the data version of the version of the game that saved the file.
1.2124w21a Moved structure files from File directory.png: Sprite image for directory in Minecraft structures to File directory.png: Sprite image for directory in Minecraft structure.

Bedrock Edition

Bedrock Edition
? Added structure files.
26.50Preview 26.50.24 Added version 2 structure files.
26.60Preview 26.60.29 Version 2 structure files now have a tag named [Int] compression which controls use of zlib compression.
Advertisement Remove ads with Premium →

More in Bedrock Edition

View all 266 →
Stonecutter (old)Stonecutter (old)The stonecutter is an unused decorative block. It was previously used to craft many stone items in Pocket Edition Alpha and the Windows 10 Edition Beta…Story Mode Skin PackStory Mode Skin PackStory Mode Skin Pack, also referred to as Minecraft Story Mode Skin pack, is a skin pack that includes 27 skins referencing various characters from…Stranger Things Skin PackStranger Things Skin PackStranger Things Skin Pack is a skin pack consisting of 52 skins of characters from the popular Netflix sci-fi horror series Stranger Things. At some…Strangers - Biome Settlers 3Strangers - Biome Settlers 3Strangers - Biome Settlers 3 is a skin pack themed around the inhabitants of the Farland, ocean, and End biomes. At some point in 2025, the skin pack was…Super Cute Texture PackSuper Cute Texture PackThe Super Cute Texture Pack is a texture pack that customizes the game with colorful kawaii styled textures. It additionally includes 15 skins.Super FertilizerSuper FertilizerSuper fertilizer is a powerful alternative to bone meal that is created using ammonia and phosphorus.Superman DLCSuperman DLCSuperman DLC is a Marketplace map developed by Oreville Studios that crosses over with the popular Superman franchise, featuring 11 skins that are based…Superman Skin PackSuperman Skin PackSuperman Skin Pack is a skin pack consisting of 5 skins of characters from the popular Superman franchise. The skin pack's launch coincided with the…
Advertisement Remove ads with Premium →

Related mods

SQUIDBRUSH Special Blocks Builder Tool one click command + NBT structure file SQUIDBRUSH Special Blocks Builder Tool one click command + NBT structure file Map · 1.3K downloads
Explore the Minecraft Wiki
Blocks, items, mobs, biomes and game mechanics — all in one place.
Wiki home