Minecraft:Structure Block
More actions
 |
For the {{{Description}}} of the same name, see [[{{{Destination}}}]]. |
Template:Hatnote Template:Infobox 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
- REDIRECT Template:Command
- REDIRECT Template:Command
Template:Redr, or
- REDIRECT Template:Command
Template:Redr commands, or the Minecraft:Creative inventory in Template:Editions through the "Operator Utilities" tab. When placed, structure blocks are unbreakable in Survival and have the same blast resistance as Minecraft:bedrock. in Template:Editions, only save-mode structure blocks are obtainable through commands in the inventory.
Usage
When placed, {{#vardefine: control | right click on mouse or left trigger on gamepad }}use the structure block to open its GUI. The GUI opens only if the player is in Creative mode, and has Minecraft: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:minecraft:example").Template:Only
Switching between modes preserves the settings of the structure block wherever possible.
In item form, the structure block uses a "blank" texture, a texture that is not used when on a placed block.
Structure blocks can't be moved by Minecraft:pistons, and can't be destroyed by the ender dragon.
Save
- redirect Template:BlockSprite
Template:Redr Save mode allows the player to highlight a structure in the world and save it to memory, level file, or a separate file.Template:Only
- Structure Name
- A text box for entering the resource location of the structure to be saved. Only some characters are allowed. in Template:Editions, it has a "mystructure:" prefix by default.
- Relative Position / Offset
- The X, Y, and Z offsets of the structure, relative to the bottom north-west corner of the structure block. Sets the origin of the structure outline.
- in Template:Editions, the origin must be at most 48 blocks away in all directions. in Template:Editions, the origin must be at most 64 blocks away horizontally, and 384 blocks vertically.
- Show invisible blocksTemplate:Only
- REDIRECT Template:Incomplete section
- Displays invisible blocks as small colored cubes. Off by default.
- Invisible blocks as shown by the "Show invisible blocks" option
Block Appearance Color Notes - redirect Template:blockLink
Template:Redr
minecraft:air
- redirect Template:blockLink
Template:Redr
minecraft:cave_air
- redirect Template:blockLink
Template:Redr
minecraft:void_airFile:Air (shown).png Template:Color All air types look the same by design.<ref>Template:Bug</ref> - redirect Template:blockLink
Template:Redr
minecraft:structure_voidFile:Structure Void (shown) JE3.png Template:Color - redirect Template:blockLink
Template:Redr
minecraft:barrierFile:Barrier (shown).png Template:Color - redirect Template:blockLink
Template:Redr
minecraft:lightFile:Light (shown).png Template:Color
.png){kind=link}
_JE3.png){kind=link}
.png){kind=link}
.png){kind=link}
- Structure Size / Size
- X, Y, and Z offset from the Relative Position coordinates. This sets the opposite corner of the structure, and defines the structure's size.
- The maximum structure size is 48×48×48 in Template:Editions and 64×384×64 in Template:Editions.
- When successful, generates an outline surrounding the structure that's mostly white except for the red, green and blue lines that represent the X, Y and Z axis. in Template:Editions, the structure also gets previewed with a rotatable 3D model inside of the structure block's GUI.
- Detect structure size and position / Detect
- 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.
- Include entities
- When saving the structure, if this option is on, saves any entities within the structure as well.
- Remove blocksTemplate:Only
- When saving the structure, if enabled, no Minecraft:blocks are included in the structure.\
- Redstone Save ModeTemplate:Only
- Sets the save location for the structure file when the structure block gets activated by Minecraft:redstone. Save In Memory stores the structure in the game's loading memory, which will be lost after leaving the world, while Save To Disk stores the structure permanently in the level files.
- Show Bounding BoxTemplate:Only
- Toggles the outline of the structure, both in the preview and in the world.
- Save
- When all coordinates and a structure name have been entered, press this button to save the structure.
- in Template:Editions, 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 only saved in memory. 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.<ref>Template:Bug</ref>
- If no namespace is specified, a default value of
minecraftis used. This can be changed by prefixing the structure name with<namespace>:in the structure block. - Structures are saved in
.minecraft/saves/(WorldName)/generated/(namespace)/structures.<ref group="note" name="before1.13">Structures created in versions before 1.13 are saved in.minecraft/saves/(WorldName)/structures.</ref>
- in Template:Editions, this saves the structure into the level database file rather than a standalone file.
- ExportTemplate:Only
- Used to export a structure into a
.mcstructurefile, which can be used to load from thestructuresfolder of a Minecraft:behavior pack or import in a Load structure block. If the structure contains a custom block from a behavior pack, then the block is also saved on the structure block. This option is only available on Windows devices by default and Android with resource packs however, starting with version 1.21.130, the button becomes completely useless on Android, as exporting to unsupported platforms has been removed.
Load
- redirect Template:BlockSprite
Template:Redr Load mode allows the player to load and rotate saved structures.
- Structure Name
- The name of the structure to load.
- in Template:Editions, structures are searched in the following order:
- from memory
- from a file (
.minecraft/saves/<World Name>/generated/<namespace>/structures/) - from data packs
- built-in structures from minecraft.jar
- in Template:Editions, structures are searched for in the following order:
- from memory
- from disk (level database)
- from behavior packs
- in Template:Editions, vanilla NBT structure files cannot be loaded with structure block.
- Relative Position / Offset
- The X, Y, and Z offsets of the structure, relative to the bottom north-west corner of the structure block. Coordinates may be specified as numbers between -48 and 48 in Java Edition, or between -64 and 64 horizontally, and -384 and 384 vertically in Bedrock Edition.
- 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.0Template:Only or 100.00.Template:Only
- Strict PlacementTemplate:Only
- When on, the blocks of the structure do not emit block updates or run their post-placement code when the structure gets loaded.
- Include entities
- Include any entities saved in the structure file when loading the structure. Off by default.
- Waterlog BlocksTemplate:Only
- When loading the structure blocks that replace water become waterlogged instead of replacing blocks with air, creating air pockets.
- Remove BlocksTemplate:Only
- When loading the structure, don't include any Minecraft:blocks from the 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^ vmirrors across the Z-axis.<more information needed></more information needed> - in Template:Editions, the options are x and z, which can be toggled to set mirroring.
- Animation ModeTemplate:Only
- Select the animation to show how structure is loaded. Place by Layer makes structure loaded layer by layer, Place by Block makes 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 TimeTemplate:Only
- Adjust the animation time in seconds for loading the structure.
- Load
- Press to load the structure.
- in Template:Editions, press this button once to prepare the outline preview of the structure. When satisfied with the position, press again to generate the structure.
- A redstone signal will also activate the structure block and load the structure.
- ImportTemplate:Only
- Only available on Windows. Opens the file explorer and allows to select a
.mcstructurefile exported from a Save structure block. This imports the structure into the memory, allowing to use its save name to load (entered by default).
Corner
- redirect Template:BlockSprite
Template:Redr 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,Template:Only it must match exactly with the name provided by the complementary save or corner structure block.
3D Export
Script error: No such module "Exclusive".
- redirect Template:BlockSprite
Template:Redr 3D Export mode,Template:Note is similar to Save mode, but the structure is saved as a 3D render in the format of .glb rather than as an actual structure.<ref>
- redirect Template:YouTube link
Template:Redr</ref> Therefore, structures saved this way can be viewed with 3D Viewer<ref>https://apps.microsoft.com/store/detail/3d-viewer/9NBLGGH42THS</ref> or Paint 3D<ref>https://apps.microsoft.com/store/detail/paint-3d/9NBLGGH5FV99</ref>, but cannot be generated via load mode.
The 3D file exported is basically the same as the real-time rendering in the preview. Animated textures such as Nether portal blocks, liquids, magma, etc. only have 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 export mode cannot be activated by redstone.
3D export can't be used in Marketplace world templates.
- Structure Name
- Enter the name of the structure. Case sensitive. The player must enter a file name in order to export.
- 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.
- Offset
- 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.
- Remove Blocks
- While exporting the structure, doesn't include any blocks within saved structure.
- Show Bounding Box
- Toggles the outline of the structure, both in the preview and in the world.
Data
- redirect Template:BlockSprite
Template:Redr Data is a deprecated mode, which is superseded by the jigsaw block, but still used in some certain vanilla structures (igloo, end city, woodland mansion, ocean ruin, shipwreck). Structure blocks 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 Template:Editions, this mode is hidden unless the
- REDIRECT Template:Keys
Template:Redr key is held while switching from Corner mode. in Template:Editions, 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 Minecraft: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 allays 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.
- Show Bounding BoxTemplate:Only
- Toggles the outline of the structure, both in the preview and in the world.
Sounds
Data values
ID
- REDIRECT Template:Edition
Template:Rcat: Template:ID table Template:ID table
- REDIRECT Template:Edition
Template:Rcat: Template:ID table Template:ID table
Block states
{{#vardefine:params|0 }}Template:Hatnote
Block data
A structure block also has a block entity associated with it.
- REDIRECT Template:Edition
Template:Rcat: {{#vardefine:params|0 }}Template:Hatnote
<section begin="block data" />
- Template:Nbt/sprite Block entity data
- Template:Nbt inherit
- Template:Nbt/sprite author: Author of the structure; only set to "?" for most vanilla structures.
- Template:Nbt/sprite ignoreEntities: 1 or 0 (true/false): Whether entities should be ignored in the structure.
- Template:Nbt/sprite integrity: How complete the structure is that gets placed.
- Template:Nbt/sprite metadata: Value of the data structure block field.
- Template:Nbt/sprite mirror: How the structure is mirrored, one of "NONE", "LEFT_RIGHT" (mirrored over X axis when not rotated), or "FRONT_BACK" (mirrored over Z axis when not rotated).
- Template:Nbt/sprite mode: The current mode of this structure block, one of "SAVE", "LOAD", "CORNER", or "DATA".
- Template:Nbt/sprite name: Name of the structure.
- Template:Nbt/sprite posX: X-position of the structure.
- Template:Nbt/sprite posY: Y-position of the structure.
- Template:Nbt/sprite posZ: Z-position of the structure.
- Template:Nbt/sprite powered: 1 or 0 (true/false): Whether this structure block is being powered by redstone.
- Template:Nbt/sprite rotation: Rotation of the structure, one of "NONE", "CLOCKWISE_90", "CLOCKWISE_180", or "COUNTERCLOCKWISE_90".
- Template:Nbt/sprite seed: The seed to use for the structure integrity, 0 means random.
- Template:Nbt/sprite showboundingbox: 1 or 0 (true/false): Whether to show the structure's bounding box to players in Creative mode.
- Template:Nbt/sprite sizeX: X-size of the structure, its length.
- Template:Nbt/sprite sizeY: Y-size of the structure, its height.
- Template:Nbt/sprite sizeZ: Z-size of the structure, its depth.
<section end="block data" />
- REDIRECT Template:Edition
Videos
- REDIRECT Template:YouTube
History
Development
Java Edition
Bedrock Edition
Legacy Console Edition
Data history
Issues
Script error: No such module "Issue list".
Gallery
Textures
-
Comparison of Java Edition 1.9 and Java Edition 1.10 blank structure block textures.
Screenshots
-
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.
-
A structure block showing invisible blocks.
Development images
-
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.
-
Another mystery image.
-
Yet another mystery image.
-
The mystery images in sequence.
-
A "side quest" mystery image.
-
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.
-
The UIs of different structure block types.
See also
- Jigsaw block
Notes
<references group="note">
</references>
References
<references group="">
</references>
External links
| |||||||
|
| |||||||
Template:Article otherTemplate:Article other
de:Konstruktionsblock es:Bloque estructural fr:Bloc de structure it:Blocco strutture ja:ストラクチャーブロック ko:구조물 블록 pl:Blok struktur pt:Gerador de Estruturas ru:Структурный блок zh:结构方块