Structure Block

Structure blocks are blocks that are used to manually generate structures. They can also be used to save and load structures, along side structure void blocks.

Obtaining
Structure blocks and structure voids are only available using the or  commands. Both blocks when placed are unbreakable in survival and have the same blast resistance as bedrock.

Usage
When placed, use the control on the structure block to open the structure block GUI (graphical user interface). The GUI will only open if the player is in creative mode, and has the proper permissions. Once a structure is named, its name will be displayed 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 which is currently not used when on a placed block.

Save


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


 * Structure Name
 * The name of the structure is entered into this text box. Case sensitive.
 * Currently the only method of adding special characters (such as ) into this text box is to copy-and-paste them.


 * 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 32 blocks in any direction.


 * Show invisible blocks
 * Displays air and structure void blocks as small colored cubes. Red cubes signify structure void, while blue cubes signify air. Off by default.


 * Structure Size
 * Enter the X, Y, and Z coordinates 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 32x32x32.
 * When successful, generates a white outline surrounding the structure.


 * 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 size calculation will fail.


 * 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 in . The name of the structure will be the name of the file.
 * This process may also be automated with the use of redstone.

Load


Load mode [L] allows the player to load and rotate saved structure files.


 * Structure Name
 * The name of the structure file to load from.
 * Name is case sensitive; it must match exactly with the name of the saved structure.


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


 * 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 will result in more blocks being removed. The integrity must be comprised between 0.0 and 1.0.


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


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


 * Mirror (¦, <>, ^v)
 * Sets the mirroring of the structure to none (¦), left to right (<>), or front to back (^v).


 * Load
 * 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 [C] 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 will appear.


 * 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 [D] preserves data within block entities, such as chests and furnaces. Useful when transferring structures with loot, such as dungeons.
 * Place directly next to any block entity you wish to save.
 * This mode is the default mode when a structure block is first placed.


 * Custom Data Tag Name
 * The name of the block entity.

Structure void


Structure voids can be placed as part of the structure to allow empty spaces in a structure.


 * Unlike air, they will not overwrite blocks at the location when the structure is placed. For example, if you save a 2 block high structure with air at the top and a structure void at the bottom, and load it into a 2 block high area of stone, the top block will become air but the bottom will stay stone.


 * Structure void blocks have no collision box but have a small hitbox. Additionally, they are invisible, but are displayed as red cubes when "Show invisible blocks" is turned on in Save mode.

Data values
The structure block has an ID name of  and an ID number of 255. It also contains an additional data field which determines which variant is used.

Structure void has an ID name of  and an ID number of 217. It has no additional data.

Block entity
A structure block also has a block entity associated with it. Its ID is.