Structure Block

Type	Solid Block
Requirements	None
Physics	No
Transparency	No
Luminance	0
Blast resistance	18,000,000
Hardness	-1
Tool	None
Renewable	No
Stackable	Yes (64)
Flammable	No
Drops	No
Block Entity ID	structure_block
Data value	dec: 255 hex: FF bin: 11111111
Name	structure_block

Structure Void

Transparent	Yes
Luminance	0
Blast resistance	0
Tool	None
Renewable	No
Stackable	Yes (64)
Flammable	No
Drops	No
Data value	dec: 217 hex: D9 bin: 11011001
Name	structure_void‌^{[Java Edition only]}

Java Edition and Bedrock Edition only

	“	It's a block for map makers, similar to the command blocks. But this one can save a structure that you build in the world, for example a house, and save it. It is then possible to place it in the world multiple times. So it's basically saving templates and then copying them back into the world at any position. The nice feature is that every structure can be rotated or mirrored when it's placed.	„
		— Searge on structure blocks^[1]

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

Obtaining[edit]

Structure blocks and structure voids are only available using the /setblock, /fill, or /give commands. Structure blocks when placed are unbreakable in survival and have the same blast resistance as bedrock. This is like a similar block, the command block.

Usage[edit]

When placed, use the structure block to open the structure block GUI. 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 not used when on a placed block.

A piston cannot move a structure block, but can move a structure void.

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

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

Save[edit]

Save Mode GUI

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 are allowed.

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 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 32×32×32.; 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. The name of the structure will be the name of the file.; This process may also be automated with the use of redstone, but saves triggered by redstone are saved only to memory, not to disk.; Structures in 1.13 are saved in .minecraft/saves/(WorldName)/generated/minecraft/structures.; Structures created in versions before 1.13 are saved in .minecraft/saves/(WorldName)/structures.

Load[edit]

Load Mode GUI

Load mode‌^{[Java Edition only]} allows the player to load and rotate saved structure files.

Structure Name

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

Name is case sensitive; it must match exactly with the name of the saved structure.

This may be a file found in the /data/minecraft/structures/<folder_name> folders in minecraft.jar. To load from a folder, simply type <folder_name>/<structure_name>. The following folders exist:

end_city
fossil
igloo
underwater_ruin
shipwreck
village‌^{[upcoming: JE 1.14]}
pillager_outpost‌^{[upcoming: JE 1.14]}
woodland_mansion

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, as long as the coordinates are within -32 and 32.

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 value must be 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° counter-clockwise).

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[edit]

Corner Mode GUI

Corner mode‌^{[Java Edition only]} 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[edit]

Data Mode GUI

Data mode‌^{[Java Edition only]} can only be used during natural generation. They mark the location to run a function specified by its metadata input, which can only be used for relevant structures. The structure block is removed afterwards. This mode is the default mode when a structure block is first placed.

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.

3D Export[edit]

Export Mode GUI

3D Export mode‌^{[Bedrock Edition only]} is a mode where structures can be exported locally.

Structure Name: The name of the structure is entered into this text box. Case sensitive.

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.

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 32×32×32.

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.

Include players: While saving the structure, saves any players within the structure as well.

Structure void[edit]

The difference between air (left) and structure void (right) when "show invisible blocks" is enabled.

Structure void‌^{[Java Edition only]} can be placed as part of a structure and are ignored when the structure file is saved.

This results in the blocks at the location where the structure is placed being maintained and not being overriden. 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.

Blocks can replace structure voids as they would do with snow layers or grass.

Data values[edit]

Entity data[edit]

Block states[edit]

Block entity[edit]

Video[edit]

Note: These videos are made using Education Edition.

(Advanced)

History[edit]

Java Edition
1.9	March 18, 2015	Searge tweets an image of a then-mysterious dark block.
	April 08, 2015	Searge tweets a cryptic message containing another screenshot of the mysterious dark block.
	April 08, 2015	He later asks if players would like an unobtainable block whose effects to the world are "visible and exciting."^[2]
	April 14, 2015	Searge tweets another cryptic image, with the dark block visible in the hotbar and in the upper-right corner.
	April 14, 2015	Bright dots cover a mysterious floating structure in the upper-left corner, which Searge "clarified" in a later tweet.^[3]
	June 24, 2015	Searge explains that the mysterious block will be a technical block used internally for world generation.
	July 5, 2015	The usage of structure blocks was detailed in a live stream during MineCon 2015.
	15w31a	Added structure blocks, which were only available with the `/setblock` command.
	15w31a	Structure blocks had no interface at the time, and were only used internally by the developers.
1.10	May 3, 2016	Jens Bergensten tweets a screenshot of the new structure block textures.
	May 3, 2016	He was instructed to make structure blocks "feel mysterious."^[4]
	May 13, 2016	ProfMobius tweets an image of the new structure blocks in action, generating what appears to be a fossil made of quartz blocks.
	16w20a	Structure blocks are now obtainable using `/give` command and usable in-game, and have new textures.
	16w20a	Added structure void. Originally developers used barrier blocks for its purpose.
	16w21a	Structure blocks will no longer emit light (was previously light-level 15).
	16w21a	Added "Structure Integrity and Seed" to load mode.
	pre1	Structure voids are now no longer indestructible.
	pre1	Structure void blast resistance reduced to 0 (was 18,000,003).
1.11	16w32a	The block entity ID is changed from `Structure` to `structure_block`.
1.13	17w47a	Prior to The Flattening, the structure void and structure block's numeral ID were 217 and 255 respectively.
1.13	17w47a	Saved structures are now stored in in `.minecraft/saves/(WorldName)/generated/minecraft/structures`.
Pocket Edition
1.0	alpha 0.17.0.1	"Added" structure blocks. While fully implemented, they have no assigned block ID and are completely unobtainable.
1.0	alpha 0.17.0.1	"Added" structure void. Similarly to structure blocks, they have no assigned block ID and cannot be obtained in-game.
Bedrock Edition
1.2	beta 1.2.0.2	Structure blocks now have a block ID and can be obtained with `/give` and `/setblock`.
1.2	beta 1.2.0.2	Structure blocks now have a new mode called "3D Export" with a new texture. However, it's only possible to use them in Windows 10 and "3D Export" is the only mode.
1.5	beta 1.5.0.0	Structure blocks can now be used in iOS and Android.^[verify]
1.9	beta 1.9.0.0	Structure blocks can now be used in Xbox One.
1.9	beta 1.9.0.0	Removed the option to export using Remix3D, instead structures now exports locally.

Issues[edit]

Issues relating to "Structure Block" are maintained on the bug tracker. Report issues there.

Gallery[edit]

The first image of the then-mysterious structure block, as posted by Michael Stoyke.
Another cryptic image by Searge; the structure block can be seen in the center of the image, as well as the hotbar.
The previous image, brightened for clarity.
Yet another of the cryptic images posted by Searge; note the structure block in the hotbar and several in the upper-right corner.
The secret message uncovered in the previous image with the use of an image-editing program.
Highlighting of the end city structures
The structure block on the data mode in 1.9
The interface in 1.9
Highlighting of end city structures in save mode
Highlighting of structures
Teaser screenshot of the 1.10 structure block textures.
An image, tweeted by ProfMobius, of a structure block generating a fossil-like structure made of quartz.
Comparison of 1.9 and 1.10 blank structure block textures.
Selecting a tree on an island using Save and Corner structure blocks.
Preparing to load the saved tree structure into an empty sunflower plains.
Structure loaded.