Structure Block

Structure Block

Rarity	Epic
Renewable	No
Stackable	Yes (64)
Tool	None
Blast resistance	3,600,000
Hardness	-1
Luminant	No
Transparent	No
Flammable	No
Catches fire from lava	No

Structure Void

Renewable	No
Stackable	Yes (64)
Tool	None
Blast resistance	0
Hardness	0
Luminant	No
Transparent	Yes
Flammable	No
Catches fire from lava	No

	“	It's a block for map makers, similar to the command blocks. But this one can [take] 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

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

Structure blocks and structure voids are available only using the /setblock, /fill, or /give commands, meanwhile it can be obtained in the creative inventory in Education Edition. Structure blocks when placed are unbreakable in survival and have the same blast resistance as bedrock. This is similar to the command block.

Usage

Info

When placed, use 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").‌^{[Java Edition only]}

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, but can move a structure void‌^{[JE only]}.

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.

Block loot

Namespaced ID	Source	Drops
		Default
Structure_Block	Structure Block	Nothing (100%)
Structure_Void	Structure Void	Nothing (100%)

Save

Save Mode GUI for Java Edition

Save Mode GUI for Bedrock Edition

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‌^{[JE only]} 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 32‌^{[JE only][until JE 1.16]}/64‌^{[BE only]} blocks in any direction.

Show invisible blocks ‌^{[JE only]}

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.‌^{[JE only][until JE 1.16]} or 64x64x64.‌^{[BE only]}

When successful, generates a white outline surrounding the structure.‌^{[JE only]} In Bedrock Edition, 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 ‌^{[JE only]}

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.

Remove blocks ‌^{[BE only]}

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 only be saved to a file on disk 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 will clear any structures stored in memory. In Bedrock Edition, 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 minecraft namespace. This can be changed by prefixing the structure name with <namespace>: in the structure block.

In Java Edition, structures are saved in .minecraft/saves/(WorldName)/generated/(namespace)/structures.

In Bedrock Edition, structures are saved together with other world data rather than a standalone file.

Export ‌^{[BE only]}

Used to export a structure into a .mcstructure file, which can be used to load from the structures 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.

Load

Load Mode GUI for Java Edition

Load Mode GUI for Bedrock Edition

Load mode 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
• pillager_outpost
• woodland_mansion
• coral_crust‌^{[BE only][more information needed]}
• ruined_portal

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‌^{[JE only][until JE 1.16]}/-64 and 64‌^{[BE only]}.

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.

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). At 0° rotation <> mirrors across the X-axis and ^v mirrors across the Z-axis.

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 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 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 GUI

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

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

Export Mode GUI

3D Export mode‌^{[Bedrock Edition only]}, 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 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.^{[until JE 1.16]}

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.

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

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

Structure void 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 overridden. For example, if a player saves a 2 block high structure with air at the top and a structure void at the bottom, and loads it into a 2 block high area of stone, the top block becomes air but the bottom stays 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 ‌^{[Java Edition only]}/when held by the player ‌^{[Bedrock Edition only]}

As there is no collision box, entities can pass through, although liquids cannot.

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

Sounds

Java Edition:

Sound	Subtitle	Source	Description	Namespaced ID	Translation key	Volume	Pitch	Attenuation distance
	Block broken	Blocks	Breaking the block	block.stone.break	subtitles.block.generic.break	1.0	0.8	16
	None	Blocks	Falling on the block with fall damage	block.stone.fall	None	0.5	0.75	16
	Block breaking	Blocks	Mining the block	block.stone.hit	subtitles.block.generic.hit	0.25	0.5	16
	Block placed	Blocks	Placing the block	block.stone.place	subtitles.block.generic.place	1.0	0.8	16
	Footsteps	Blocks	Walking on the block	block.stone.step	subtitles.block.generic.footsteps	0.15	1.0	16

Bedrock Edition: ^{[needs in-game testing]}

Sound	Description	Namespaced ID	Volume	Pitch
	Breaking the block	dig.stone	?	0.8
	Falling on the block with fall damage	fall.stone	?	?
	Mining the block	hit.stone	?	0.5
?	Jumping from the block	jump.stone	?	?
?	Falling on the block without fall damage	land.stone	?	?
	Walking on the block	step.stone	?	?
	Placing the block	use.stone	?	0.8

Data values

ID

Java Edition:

Name	Namespaced ID	Translation key
Structure Block	structure_block	block.minecraft.structure_block
Structure Void	structure_void	block.minecraft.structure_void

Name	Namespaced ID
Block entity	structure_block

Bedrock Edition:

Name	Namespaced ID	Numeric ID	Translation key
Structure Block	structure_block	252	tile.structure_block.name
Structure Void	structure_void	217	tile.structure_void.name

Name	Savegame ID
Block entity	?

Block data

See also: Data values

In Bedrock Edition, structure blocks uses the following data values:

	DV	Description
	0	Inventory model
	1	Data
	2	Save
	3	Load
	4	Corner
	5	Export

Block states

See also: Block states

Java Edition:
Structure block

Name	Default value	Allowed values	Description
mode	data	corner	Corner Structure Block
		data	Data Structure Block
		load	Load Structure Block
		save	Save Structure Block

Bedrock Edition:
Structure block

Name	Default value	Allowed values	Description
mode	data	corner	Corner Structure Block
		data	Data Structure Block
		export	Export Structure Block
		invalid	Inventory Structure Block
		load	Load Structure Block
		save	Save Structure Block

Structure void

Name	Default value	Allowed values	Description
structure_void_type	void	air void	[check the code]

Block entity

See also: Block entity format

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

• Block entity data
  • Tags common to all block entities see Template:Nbt inherit/blockentity/template
  •  name: Name of the structure.
  •  author: Author of the structure; only set to "?" for normal structures
  •  metadata: Custom data for the structure
  •  posX: X-position of the structure
  •  posY: Y-position of the structure
  •  posZ: Z-position of the structure
  •  sizeX: X-size of the structure, its length
  •  sizeY: Y-size of the structure, its height
  •  sizeZ: Z-size of the structure, its depth
  •  rotation: Rotation of the structure, one of "NONE", "CLOCKWISE_90", "CLOCKWISE_180", or "COUNTERCLOCKWISE_90"
  •  mirror: How the structure is mirrored, one of "NONE", "LEFT_RIGHT", or "FRONT_BACK"
  •  mode: The current mode of this structure block, one of "SAVE", "LOAD", "CORNER", or "DATA"
  •  integrity: How complete the structure is that gets placed
  •  seed: The seed to use for the structure integrity, 0 means random
  •  ignoreEntities: 1 or 0 (true/false): Whether entities should be ignored in the structure
  •  showboundingbox: 1 or 0 (true/false): Whether to show the structure's bounding box to players in creative mode
  •  powered: 1 or 0 (true/false): Whether this structure block is being powered by redstone

Video

Note: These videos are made using Education Edition.

(Advanced)

History

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.
					He later asks if players would like an unobtainable block whose effects to the world are "visible and exciting."
		April 14, 2015			Searge tweets another cryptic image, with the dark block visible in the hotbar and in the upper-right corner.
					Bright dots cover a mysterious floating structure in the upper-left corner, which Searge "clarified" in a later tweet.
		June 24, 2015			Searge explains that the mysterious block is 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 are currently available only with the /setblock command.
					Structure blocks currently do not have an interface and are used only internally by the developers.
1.10		May 3, 2016			Jens Bergensten tweets a screenshot of the new structure block textures.
					He was instructed to make structure blocks "feel mysterious."
		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			The textures of structure blocks have been changed.
					Structure blocks are now obtainable using /give command and usable in-game.
					Added structure voids. Originally, developers used barrier blocks for their purpose.
		16w21a			Structure blocks no longer emit light (was previously light-level 15).
					Added "Structure Integrity and Seed" to load mode.
		pre1			Structure voids are no longer indestructible.
					Structure void blast resistance has been reduced to 0 (was 18,000,003).
1.11		16w32a			The block entity ID has been 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.
					Saved structures are now stored in .minecraft/saves/(WorldName)/generated/minecraft/structures.
					Due to The Flattening, structure blocks are now broken and no longer work unless the structure was created in 1.12 and earlier.
1.14		18w43a			The texture of structure voids has been changed.
Upcoming Java Edition
1.16		20w16a			The maximum size per axis has been increased from 32 to 48.
Pocket Edition
1.0.0		alpha 0.17.0.1			"Added" structure blocks. While fully implemented, they have no assigned block ID and are completely unobtainable.
					"Added" structure void. Similarly to structure blocks, they have no assigned block ID and cannot be obtained in-game.
Bedrock Edition
1.2.0		beta 1.2.0.2			Structure blocks now have a block ID and can be obtained with /give and /setblock.
					Structure blocks now have a new mode called "3D Export" with a new texture. However, it's possible to use them only in Windows 10 and "3D Export" is the only mode.
1.5.0		beta 1.5.0.0			Structure blocks can now be obtained in iOS and Android, but cannot be used yet.
1.9.0		beta 1.9.0.0			The option to export using Remix3D has been removed from structure blocks. Instead, structures now export locally.
1.13.0		beta 1.13.0.1			Structure blocks are now usable, with save and load mode available only through Experimental Gameplay.
					Added structure voids, which are available only through Experimental Gameplay.
Upcoming Bedrock Edition
1.16.0		beta 1.15.0.51			A detect button for save mode has now been added to structure blocks.
		beta 1.16.0.57			Structure Voids and Structure Block functionality are no longer behind Experimental Gameplay.

Issues

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

Gallery

• 

  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 Java Edition 1.9 and Java Edition 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.

Bedrock Edition

• 

  The UI Interface for Bedrock Edition (Classic UI)

See also

• Jigsaw Block

References

Redstone

View at: Template:Redstone/content [edit]

Blocks

View at: Template:Blocks/content [edit]