Structure Block

A structure block is used to generate structures manually. They can also be used to save and load structures, alongside structure void blocks.

Obtaining
Structure blocks are available using the, , or commands. Structure blocks when placed are unbreakable in survival and have the same blast resistance as bedrock. This is similar to the command block. $$, all structure block types are obtainable through commands with data values, including corner, data modes and the inventory model, although those two default to save mode when placed.

Usage
When placed, the structure block to open the structure block GUI. The GUI opens only if the player is in Creative mode, and has the proper permissions. Once a structure is named, its name appears above the structure block when highlighted, preceded by the block mode (e.g. "Save:House").

Before being placed, the structure block uses a "blank" texture in the inventory, a texture that is not used when on a placed block.

A piston cannot move a structure block. They also cannot be pushed nor pulled by sticky pistons.

Structures saved only to memory have a higher priority than structures of the same name that were saved to disk. To remove a structure from active memory, players need to quit and reload their current game.

Switching between modes preserves the settings of the structure block wherever possible.

Save


Save mode allows the player to highlight a structure in the world and save it to a file.


 * Structure Name
 * The name of the structure is entered into this text box. Capital letters and special characters are not allowed. Underscores (_) and hyphens (-) are allowed. It has "mystructure:" prefix on default.


 * Relative Position
 * Enter the X, Y, and Z values for the structure here, based on the position of the structure block. Sets the origin of the structure outline.
 * Maximum allowed distance from the structure block $$ is 48 blocks in any direction and 64 on horizontal direction and 256 on vertical direction $$.




 * Show invisible blocks


 * Displays invisible blocks as small colored cubes. Red cubes signify structure void, while blue cubes signify air. 1.17 changes the structure void color and also adds functionality for barriers and light blocks. Off by default.


 * Invisible blocks as shown by the "Show invisible blocks" option


 * {| class="wikitable" style="text-align:center" data-description="Rendered invisible blocks"

! Block ! Appearance ! Notes ! minecraft:air ! minecraft:cave_air ! minecraft:void_air ! minecraft:structure_void ! minecraft:barrier ! minecraft:light
 * Air (shown).png
 * Not distinguished from other air types, which is not a bug
 * Air (shown).png
 * Not distinguished from other air types, which is not a bug
 * Air (shown).png
 * Not distinguished from other air types, which is not a bug
 * Structure Void (shown) JE3.png
 * Barrier (shown).png
 * Light (shown).png
 * }
 * }


 * Structure Size
 * Enter the X, Y, and Z values to set the distance from the Relative Position coordinates. This sets the opposite corner of the structure, and defines its size.
 * Maximum structure size is 48x48x48 $$ and 64x256x64 $$.
 * When successful, generates a white outline surrounding the structure. $$, the outline is green, blue, or red (depending on the axis) and the preview design can be used to see every layer of fragmented structure and to change the structure size to be saved.


 * Detect structure size and position
 * Automatically calculates the size and position of the structure using a corner block placed on the opposite corner of the structure.
 * The name of the structure in the save block must match the name within the corner block, or the size calculation fails.
 * Two corner blocks can also be used. It uses the second corner block instead of the structure block.


 * Remove blocks
 * While saving the structure, doesn't include any blocks within structure.


 * Include entities
 * While saving the structure, saves any entities within the structure as well


 * Save
 * When all coordinates and a structure name have been entered, press this button to save the structure to a file. The name of the structure is the name of the file.
 * Structures can be saved to a file on disk only by manually pressing this button. If a structure block in Save mode is instead powered by redstone, the structure is saved only in memory by default. This is the case even if a file for that structure already exists on disk. Reloading the world clears any structures stored in memory. $$, the player can set up the structure block so that it saves to the disk even when automated with redstone.
 * By default, structure blocks are saved in the  namespace. This can be changed by prefixing the structure name with   in the structure block.
 * $$, structures are saved in.

file, which can be used to load from the  folder of a behavior pack. If the structure contains a custom block from a behavior pack, then the block is also saved on the structure block. This option is available only on Android and Windows 10 devices.

Load


Load mode allows the player to load and rotate saved structure files. This is the default mode when a structure block is first placed.


 * Structure Name
 * The path and name of the structure file to load from.


 * Structure files may be found in two locations - in  in minecraft.jar for default structures, and in   for user-created structures.


 * The following folders exist in minecraft.jar:


 * To load a structure from a folder, simply type   or if stored at the top level of the   folder (such as those created in the Save mode) type.
 * Example 1:
 * Example 2:
 * Example 3:


 * Relative Position
 * The X, Y, and Z coordinates of the corner in which to generate the structure, based on the position of the structure block. Coordinates may be defined as numbers between -48 and 48 $$, or between -64 and 64 $$.


 * Show bounding box
 * Highlights the outline of the structure; on by default.


 * Structure Integrity and Seed
 * Removes random blocks that compose the structure based on a user-defined seed.


 * Lower integrity values result in more blocks being removed. The integrity value must be between 0.0 and 1.0 / 100.00.


 * Include entities
 * Include any entities saved in the structure file when loading the structure. Off by default.


 * Remove blocks
 * While loading the structure, doesn't include any blocks within saved structure.


 * Rotation (0, 90, 180, 270)
 * Sets the rotation of the structure to 0° (no rotation), 90° clockwise, 180° clockwise, and 270° clockwise (or 90° counter-clockwise).


 * Mirror (¦, <>, ^v)
 * Sets the mirroring of the structure to none, left to right , or front to back . At 0° rotation  mirrors across the X-axis and   mirrors across the Z-axis.
 * $$, the options are x and z, which can be toggled to set mirroring.


 * Animation mode
 * Select the animation to show how structure is loaded. Place by layer make structure loaded layer by layer, place by block make structure loaded one block by block. Default to none.


 * Animation time
 * Adjust the animation time for loading the structure.


 * Load
 * Type in the name of the structure and press this button once to prepare the outline preview of the structure. When satisfied with the position, press again to generate the structure.This process may also be automated with the use of redstone.

Corner


Corner mode allows for an easier and automatic size calculation while saving or loading structures.


 * To use, place on the opposite corner of a save structure block or a second corner structure block. Then, using a save block, press "DETECT".
 * When successful, a white outline appears.


 * Structure Name
 * The name of the structure on which to calculate the size and position.
 * Name is case sensitive; it must match exactly with the name provided by the complementary save or corner structure block.

Data


Data mode can be used only during natural generation. They mark the location to run a function specified by its metadata input, which can be used only for relevant structures. The structure block is removed afterward. This mode is hidden unless the key is held while switching from Corner mode.


 * Custom Data Tag Name
 * The name of the function to run.
 * Igloo
 * "chest" - sets the loot table for a chest beneath the structure block to "chests/igloo_chest" and sets the loot table seed dependent on the world seed.
 * End city
 * "Chest" - Sets the loot table for a chest beneath the structure block to "chests/end_city_treasure" and sets the loot table seed dependent on the world seed.
 * "Sentry" - Creates a shulker at the location of the structure block.
 * "Elytra" - Creates an item frame entity with an elytra item inside it at the location of the structure block.
 * Woodland mansion
 * "ChestSouth" - Sets the loot table for a chest that replaces the structure block to "chests/woodland_mansion" and sets the loot table seed dependent on the world seed.
 * "ChestNorth" - Sets the loot table for a chest that replaces the structure block to "chests/woodland_mansion" and sets the loot table seed dependent on the world seed.
 * "ChestEast" - Sets the loot table for a chest that replaces the structure block to "chests/woodland_mansion" and sets the loot table seed dependent on the world seed.
 * "ChestWest" - Sets the loot table for a chest that replaces the structure block to "chests/woodland_mansion" and sets the loot table seed dependent on the world seed.
 * "Mage" - Creates an evoker at the location of the structure block.
 * "Warrior" - Creates a vindicator at the location of the structure block.
 * Ocean Ruin
 * "chest" - Creates a chest at the location of the structure block, setting its loot table to either "chests/underwater_ruin_big" or "chests/underwater_ruin_small", with seed dependent on the world seed.
 * "drowned" - Creates a drowned at the location of the structure block.

3D Export


3D Export mode, is similar to save mode, but the structure is saved as a 3D render rather than as an actual structure. Therefore, structures saved this way can be viewed, but cannot be generated via load mode.


 * Structure Name
 * Enter the name of the structure. Case sensitive. The player must enter a file name in order to export.


 * Relative Position
 * Enter the X, Y, and Z values for the structure here, based on the position of the structure block. Sets the origin of the structure outline.
 * Maximum allowed distance from the structure block is 64 blocks in any direction.


 * Structure Size
 * Enter the X, Y, and Z values to set the distance from the Relative Position coordinates. This sets the opposite corner of the structure, and defines its size.
 * Maximum structure size is 64×256×64.


 * Remove Blocks
 * While exporting the structure, doesn't include any blocks within saved structure.

Ender Dragon
Structure blocks cannot be destroyed by the ender dragon.

ID




Block states
Export Structure Block

Block data
A structure block also has a block entity associated with it.




 * See Bedrock Edition level format/Block entity format.
 * See Bedrock Edition level format/Block entity format.