{{About|the block in [[Minecraft]]|the block in [[Minecraft: Story Mode]]|MCSM:Structure Block}} {{distinguish|Structure Void}} {{Infobox block | image = Structure Block.png | invimage = Structure Block | transparent = No | light = No | tool = None | renewable = No | stackable = Yes (64) | flammable = No | lavasusceptible = No | rarity = * Epic {{only|java|short=1}} * Common {{only|bedrock|short=1}} }} 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 {{cmd|setblock}}, {{cmd|fill}}, or {{cmd|give}} commands, and are available in the [[Creative inventory]] {{in|Java}}. When placed, structure blocks are unbreakable in [[Survival]] and have the same blast resistance as [[bedrock]]. {{IN|be}}, only save-mode structure blocks are obtainable through commands. == Usage == Cannot be placed in [[Survival]]. When placed, {{control|use}} the structure block to open its GUI. The GUI opens only if the player is in [[Creative]] mode, and has [[permission level]] 2 or higher. Once a structure is named, its name appears above the structure block when highlighted, preceded by the block mode (e.g. "Save:House").{{only|je}} Switching between modes preserves the settings of the structure block wherever possible. 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 piston]]s. Structure blocks cannot be destroyed by the [[ender dragon]]. === Save === [[File:StructureSaveGUI.png|thumb|250px|Save mode GUI for Java Edition]] [[File:Structure Block Bedrock ClassicUI.png|thumb|250px|Save mode GUI for Bedrock Edition]] {{BlockSprite|Structure Block Save}} '''Save''' mode allows the player to highlight a structure in the world and save it to memory, level file{{only|be}}, or a separate file. ;Structure Name :The name of the structure is entered into this text box. Capital letters{{only|je|short=1}} and special characters are not allowed. Underscores (_) and hyphens (-) are allowed. {{IN|bedrock}}, 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 {{in|je}} is 48 blocks in any direction and 64 on horizontal direction and 384 on vertical direction {{in|be}}. [[File:Shown Invisible Blocks.png|thumb|right|All invisible blocks shown by structure blocks]] ;Show invisible blocks {{only|je|short=1}} {{info needed section|What color was used for structure voids prior to 21w20a? And were there any other changers since their introduction in 1.10 (ignoring the old dark outlines)?}} :Displays [[invisible block]]s as small colored cubes. 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 ! Color ! Notes |- ! {{BlockLink|Air}}
minecraft:air
{{BlockLink|Cave Air}}
minecraft:cave_air
{{BlockLink|Void Air}}
minecraft:void_air | [[File:Air (shown).png|96px]] | {{Color|rgb(127.5, 127.5, 255)}} | All air types look the same by design.{{bug|MC-221834|||Invalid}} |- ! {{BlockLink|Structure Void}}
minecraft:structure_void | [[File:Structure Void (shown) JE3.png|96px]] | {{Color|rgb(255, 191.25, 191.25)}} | |- ! {{BlockLink|Barrier}}
minecraft:barrier | [[File:Barrier (shown).png|96px]] | {{Color|rgb(255, 0, 0)}} | |- ! {{BlockLink|Light Block}}
minecraft:light | [[File:Light (shown).png|96px]] | {{Color|rgb(255, 255, 0)}} | |} ;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 {{In|je}} and 64x384x64 {{In|be}}. :When successful, generates a white outline surrounding the structure.{{only|je|short=1}} {{IN|be}}, 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 {{only|be|short=1}} :While saving the structure and when enabled, this doesn't include any [[block]]s within the structure. ;Include entities :While saving the structure and when enabled, this 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. :{{IN|java}}, this saves the structure to a file. The name of the structure is the name of the file. ::Structures can be saved to a file 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. This is for unspecified security reasons.{{bug|MC-105595|||WAI}} ::By default, structure blocks are saved in the minecraft namespace. This can be changed by prefixing the structure name with : in the structure block. ::Structures are saved in .minecraft/saves/(WorldName)/generated/(namespace)/structures. Structures created in versions before [[Java Edition 1.13|1.13]] are saved in .minecraft/saves/(WorldName)/structures. :{{IN|be}}, this saves the structure into level database file rather than a standalone file. And the player can set up the structure block so that it can save into the memory or the disk (level file) when automated with redstone. ;Export {{only|be|short=1}} :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. This option is available only on Android and Windows 10 devices. === Load === [[File:StructureLoadGUI.png|thumb|250px|Load Mode GUI for Java Edition]] [[File:Structure Block Bedrock ClassicUI Load.png|thumb|250px|Load Mode GUI for Bedrock Edition]] {{BlockSprite|Structure Block Load}} '''Load''' mode allows the player to load and rotate saved structures. ;Structure Name :The name of the structure to load. :{{IN|java}}, it can load structures saved to memory or a file (.minecraft/saves/''<World Name>''/generated/''<namespace>''/structures/), structures in data pack and in [[minecraft.jar]]. ::To load a structure from a file, simply type ''<namespace>'':''<structure_path>''. ::Structures saved only to memory have a higher priority than structures of the same name that were saved to a file. Structures saved to a file have a higher priority than structures of the same name that is in data pack, which have a higher priority than structures in [[minecraft.jar]]. :{{IN|bedrock}}, it can load structures saved to memory or disk (level database), and structures in behavior pack. ::Structures saved only to memory have a higher priority than structures of the same name that were saved to disk. Structures saved to disk have a higher priority than structures of the same name that is in behavior pack. ::Vanilla NBT structure files cannot be loaded with structure block. ;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 {{IN|je}}, or between -64 and 64 {{IN|be}}. ;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{{only|je|short=1}} / 100.00{{only|be|short=1}}. ;Include entities :Include any entities saved in the structure file when loading the structure. Off by default. ;Waterlog blocks {{only|be|short=1}} :While loading the structure in water, it allows the blocks to be [[waterlogged]] instead of being replaced with air. ;Remove blocks {{only|be|short=1}} :While loading the structure, doesn't include any [[block]]s 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 (^ v). At 0° rotation < > mirrors across the X-axis and ^ v mirrors across the Z-axis. :{{IN|be}}, the options are x and z, which can be toggled to set mirroring. ;Animation mode {{only|be|short=1}} :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. :Once the loading has started, breaking the structure block can not stop the loading process. :Loading with animation may break blocks in structures that contain multiple parts (such as beds, doors, or tall grass), or need to be attached to other blocks (such as torches), and may cause water, lava, and fire to spread out. ;Animation time {{only|be|short=1}} :Adjust the animation time for loading the structure. ;Load :Load the structure. :{{IN|java}}, press this button once to prepare the outline preview of the structure. When satisfied with the position, press again to generate the structure. :Structures may also be loaded with the use of redstone. === Corner === [[File:StructureCornerGUI.png|thumb|250px|Corner Mode GUI for Java Edition.]] [[File:StructureCorner_BedrockGUI.jpg|thumb|250px|Corner Mode GUI for Bedrock Edition.|link=Special:FilePath/StructureCorner_BedrockGUI.jpg]] {{BlockSprite|Structure Block 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 bounding 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 === [[File:StructureDataGUI.png|thumb|250px|Data mode GUI]] {{BlockSprite|Structure Block Data}} '''Data''' mode is a deprecated mode, which is superseded by jigsaw block, but still used in some certain vanilla structures (igloo, end city, woodland mansion, ocean ruin, shipwreck). Structure block in data mode can be used only during natural generation. They mark the location to run a specified hardcoded function, which can be used only for relevant structures. {{IN|java}}, this mode is hidden unless the {{key|Alt}} key is held while switching from Corner mode. {{IN|bedrock}}, data mode structure block cannot be obtained with commands. ;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. ::"Group of Allays" - Creates a group of [[allay]]s at the location of the structure block. :;[[Ocean ruins]] ::"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. :;[[Shipwreck]] ::"map_chest" - Sets the loot table for a chest that replaces the structure block to "chests/shipwreck_map" and sets the loot table seed dependent on the world seed. ::"treasure_chest" - Sets the loot table for a chest that replaces the structure block to "chests/shipwreck_treasure" and sets the loot table seed dependent on the world seed. ::"supply_chest" - Sets the loot table for a chest that replaces the structure block to "chests/shipwreck_supply" and sets the loot table seed dependent on the world seed. === 3D Export === [[File:ExportModeBedrock.png|thumb|250px|Export Mode GUI]] {{BlockSprite|Structure Block Export}} '''3D Export''' mode{{only|BE}}{{Note|Only available on Windows 10}}, is similar to [[#Save|save mode]], but the structure is saved as a 3D render in the format of .glb rather than as an actual structure.{{ytl|OKIfw1fjSlY|How to Use Structure Blocks in Minecraft: Education Edition|Minecraft: Education Edition|August 2, 2018}} Therefore, structures saved this way can be viewed with 3D Viewerhttps://apps.microsoft.com/store/detail/3d-viewer/9NBLGGH42THS or Paint 3Dhttps://apps.microsoft.com/store/detail/paint-3d/9NBLGGH5FV99, but cannot be generated via [[#Load|load mode]]. The 3D file exported is basically the same as the real-time rendering in the preview. End portal blocks, nether portal blocks, etc. in .glb file have only a static texture. Some blocks cannot be displayed properly, such as piston arms, chests, beds, etc. Including entities is not supported in this mode. Structure blocks in 3D output mode cannot be activated by redstone. ;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×384×64. ;Remove Blocks :While exporting the structure, doesn't include any blocks within saved structure. == Sounds == {{Sound table/Block/Normal}} == Data values == === ID === {{el|je}}: {{ID table |edition=java |showblocktags=y |showforms=y |generatetranslationkeys=y |displayname=Structure Block |spritetype=block |nameid=structure_block |blocktags=dragon_immune, wither_immune |foot=1}} {{ID table |displayname=Block entity |spritename=structure-block |spritetype=block |nameid=structure_block |foot=1}} {{el|be}}: {{ID table |edition=bedrock |shownumericids=y |showforms=y |generatetranslationkeys=y |displayname=Structure Block |spritetype=block |nameid=structure_block |id=252 |foot=1}} {{ID table |notnamespaced=y |displayname=Block entity |spritename=structure-block |spritetype=block |nameid=StructureBlock |foot=1}} === Block states === Export Structure Block {{see also|Block states}} {{/BS}} === Block data === A structure block also has a block entity associated with it. {{el|java}}: {{see also|Block entity format}} {{/BE}} {{el|bedrock}}: :See [[Bedrock Edition level format/Block entity format]]. == Video == {{yt|iZVT-ac0i-s}} == History == {{HistoryTable |{{HistoryLine|java}} |{{HistoryLine||1.9|dev=March 18, 2015|slink={{tweet|SeargeDP|578219322373496832}}|[[File:Structure Block JE1.png|32px]] [[Searge]] tweets an image of a then-mysterious dark [[block]].}} |{{HistoryLine|||dev=April 08, 2015|slink={{tweet|SeargeDP|585838892999380992}}|Searge tweets a cryptic message containing another screenshot of the mysterious dark block. |He later asks if [[player]]s would like an unobtainable block whose effects to the world are "visible and exciting."{{tweet|SeargeDP|585863978636681216|How about a block that players can't get, can't be found in the world, but it's effect to the world is visible and exciting?|April 8, 2015}}}} |{{HistoryLine|||dev=April 14, 2015|slink={{tweet|SeargeDP|588002295750721540}}|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.{{tweet|SeargeDP|588014450118098944|I once met a small bright dot that enjoyed nothing more in his life than protecting big dark secrets by being painted over them in images.|April 14, 2015}}}} |{{HistoryLine|||dev=June 24, 2015|slink={{tweet|SeargeDP|613699145069654017}}|Searge explains that the mysterious [[block]] is a technical block used internally for world generation.}} |{{HistoryLine|||dev=July 5, 2015|slink=https://www.twitch.tv/mojang/v/6949826?t=13h40m25s|[[File:Structure Block Save JE1.png|32px]] [[File:Structure Block Load JE1.png|32px]] [[File:Structure Block Corner JE1.png|32px]] [[File:Structure Block Data JE1.png|32px]] The usage of structure blocks was detailed in a live stream during [[MINECON 2015]].}} |{{HistoryLine|||dev=15w31a|[[File:Structure Block JE1.png|32px]] [[File:Structure Block Save JE1.png|32px]] [[File:Structure Block Load JE1.png|32px]] [[File:Structure Block Corner JE1.png|32px]] [[File:Structure Block Data JE1.png|32px]] Added structure blocks. |Structure blocks are currently available only with the {{cmd|setblock}} [[command]]. |Structure blocks currently do not have an interface and are used internally by the developers.}} |{{HistoryLine||1.10|dev=May 3, 2016|slink={{tweet|jeb_|727476558621872128}}|[[File:Structure Block Save JE2 BE1.png|32px]] [[File:Structure Block Load JE2 BE1.png|32px]] [[File:Structure Block Corner JE2 BE1.png|32px]] [[File:Structure Block Data JE2 BE1.png|32px]] [[Jens Bergensten]] tweets a screenshot of the new structure block textures. |Jeb was instructed to make structure blocks "feel mysterious."{{tweet|jeb_|727479748344033280|The instructions I got was to make them "feel mysterious" ;)|May 3, 2016}}}} |{{HistoryLine|||dev=May 13, 2016|slink={{tweet|ProfMobius|731048441015631872}}|[[ProfMobius]] tweets an image of the new structure blocks in action, generating what appears to be a [[fossil]] made of [[quartz block]]s.}} |{{HistoryLine|||dev=16w20a|[[File:Structure Block JE2 BE1.png|32px]] [[File:Structure Block Save JE2 BE1.png|32px]] [[File:Structure Block Load JE2 BE1.png|32px]] [[File:Structure Block Corner JE2 BE1.png|32px]] [[File:Structure Block Data JE2 BE1.png|32px]] The textures of structure blocks have been changed. |Structure blocks are now obtainable using {{cmd|give}} [[command]] and usable in-game.}} |{{HistoryLine|||dev=16w21a|Structure blocks no longer emit [[light]] (was previously light-level 15). |"Structure Integrity and Seed" to load mode have been added to structure blocks.}} |{{HistoryLine||1.11|dev=16w32a|The [[block entity]] ID has been changed from Structure to structure_block.}} |{{HistoryLine||1.13|dev=17w47a|Prior to [[Java Edition 1.13/Flattening|''The Flattening'']], this [[block]]'s numeral ID was 255. |The saved structures of structure blocks are now stored in /generated//structures/.nbt. |Due to [[Java Edition 1.13/Flattening|''The Flattening'']], structures saved before this version are now broken and don't load in any blocks who's previous ID is not a valid ID in current versions, such as planks.}} |{{HistoryLine||1.16|dev=20w16a|The maximum size per axis of structure blocks has been increased from 32 to 48.}} |{{HistoryLine||1.17|dev=20w46a|Default mode of structure blocks is now "Load". "Data" is now hidden by default. |"Data" can be accessed by clicking the mode button while holding the {{key|Alt}} key.}} |{{HistoryLine||1.19.3|dev=22w45a|Structure blocks are now available in the Creative inventory, but only if cheats are enabled and the "Operator Items Tab" option in the controls menu is turned on.{{bug|MC-257102||Missing Structure Block in creative tab|Fixed}}}} |{{HistoryLine|pocket}} |{{HistoryLine||1.0.0|dev=alpha 0.17.0.1|"Added" structure blocks. While fully implemented, they have no assigned [[block]] ID and are completely unobtainable.}} |{{HistoryLine|bedrock}} |{{HistoryLine||1.2.0|dev=beta 1.2.0.2|[[File:Structure Block JE2 BE1.png|32px]] [[File:Structure Block Save JE2 BE1.png|32px]] [[File:Structure Block Load JE2 BE1.png|32px]] [[File:Structure Block Corner JE2 BE1.png|32px]] [[File:Structure Block Data JE2 BE1.png|32px]] Structure blocks now have a [[block]] ID and can be obtained with {{cmd|give}} and {{cmd|setblock}}. |[[File:Structure Block Export BE1.png|32px]] Structure blocks now have a new mode called "3D Export" with a new texture. However, it's possible to use them only in [[wikipedia:Windows 10|Windows 10]] and "3D Export" is the only mode.}} |{{HistoryLine||1.5.0|dev=beta 1.5.0.0|Structure blocks can now be obtained in [[wikipedia:iOS|iOS]] and [[wikipedia:Android|Android]], but cannot be used yet.}} |{{HistoryLine||1.9.0|dev=beta 1.9.0.0|The option to export using Remix3D has been removed from structure blocks. Instead, structures now export locally.}} |{{HistoryLine||1.13.0|dev=beta 1.13.0.1|Structure blocks are now usable, with save and load mode available only through [[Experimental Gameplay]].}} |{{HistoryLine||1.16.0|dev=beta 1.15.0.51|A detect button for save mode has been added to structure blocks.}} |{{HistoryLine|||dev=beta 1.16.0.57|Structure block functionality with save and load mode are now available outside of [[Experimental Gameplay]].}} |{{HistoryLine||1.17.0|dev=beta 1.16.230.54|The structure placement block now has placement animation options similar to {{cmd|structure}} command.}} |{{HistoryLine||1.17.30|dev=beta 1.17.20.21|Added corner mode to structure blocks.}} }} Darkblock.png|The first image of the then-mysterious structure block, as posted by [[Michael Stoyke]]. SeargeMysteryImage.png|Another cryptic image by Searge; the structure block can be seen in the center of the image, as well as the hotbar. SeargeMysteryImageBrightened.png|The previous image, brightened for clarity. SeargeMysteryImageDots.png|Yet another of the cryptic images posted by Searge; note the structure block in the hotbar and several in the upper-right corner. SeargeDotsSecretMessage.png|The secret message uncovered in the previous image with the use of an image-editing program. SeargeMysteryImageDoor.png|Another mystery image. SeargeMysteryImageBook.png|Yet another mystery image. SeargeMysteryImages.png|The mystery images in sequence. SeargeMysteryImageSideQuest.png|A "side quest" mystery image. Structure_Block_1.png|Highlighting of the [[end city]] structures. Structure_Block_2.png|The structure block on the data mode in 1.9. Structure_Block_3.png|The interface in 1.9. Structure_Block_4.png|Highlighting of end city structures in save mode. Structure_Block_5.png|Highlighting of structures. New_block_1.10.jpg|Teaser screenshot of the 1.10 structure block textures. ProfMobiusFossil.jpg|An image, tweeted by ProfMobius, of a structure block generating a fossil-like structure made of quartz. == Issues == {{issue list}} == Gallery == === Textures === Structureblockcomparison.png|Comparison of [[Java Edition 1.9]] and [[Java Edition 1.10]] blank structure block textures. === Screenshots === StructureTree1.png|Selecting a [[tree]] on an island using Save and Corner structure blocks. StructureTree2.png|Preparing to load the saved tree structure into an empty [[sunflower plains]]. StructureTree3.png|Structure loaded. InvisibleBlock1.17.png|A structure block showing invisible blocks. Structure Block UIs.jpg|The UIs of different structure block types. Structure_Block_Bedrock_ClassicUI.png|The UI Interface for Bedrock Edition (Classic UI) Structure_Block_Bedrock_PocketUI.png|The UI Interface for Bedrock Edition (Pocket UI) == See also == *[[Jigsaw block]] == Notes == {{Reflist|group=note}} == References == {{reflist}} == Navigation == {{Navbox redstone|components}} {{Navbox blocks|creative}} [[Category:Mechanisms]] [[Category:Block entities]] [[Category:Creative or commands only blocks]] [[Category:Blocks with GUI]] [[de:Konstruktionsblock]] [[es:Bloque estructural]] [[fr:Bloc de structure]] [[it:Blocco strutture]] [[ja:ストラクチャーブロック]] [[pl:Blok struktur]] [[pt:Gerador de estruturas]] [[ru:Структурный блок]] [[zh:结构方块]]