Commands/structure

From Minecraft Wiki
Jump to: navigation, search
Information icon.svg
This feature is exclusive to Bedrock Edition.
structure
Restrictions

Operator

First introduced

BE 1.16.100 (1.16.100.52)

Used to save and load structures without having to use structure blocks.

Syntax[edit]

structure save <name: string> <from: x y z> <to: x y z> [saveMode: StructureSaveMode]
structure save <name: string> <from: x y z> <to: x y z> [includesEntites: Boolean] [saveMode: StructureSaveMode] [includesBlocks: Boolean]
Saves a structure.
structure load <name: string> <to: x y z> [rotation: Rotation] [mirror: Mirror] [includesEntites: Boolean] [includesBlocks: Boolean] [integrity: float] [seed: string]
structure load <name: string> <to: x y z> [rotation: Rotation] [mirror: Mirror] [animationMode: StructureAnimationMode] [animationSeconds: float] [includesEntites: Boolean] [includesBlocks: Boolean] [integrity: float] [seed: string]
Loads a structure.

Arguments[edit]

name: string: basic_string

Must be a string. And it must be either a single word (no spaces) or a quoted string.
Should be in the format of name or namespace:name. If namespace is unspecified, defaults to mystructure:

from: x y z: CommandPosition and to: x y z: CommandPosition (in save mode)

It must be a three-dimensional coordinates composed of <x>, <y> and <z>, each of which must be a floating-point number or tilde and caret notation.
Specifies any two opposing corner blocks of the region to be saved.

to: x y z: CommandPosition (in load mode)

It must be a three-dimensional coordinates composed of <x>, <y> and <z>, each of which must be a floating-point number or tilde and caret notation.
Specifies the lower northwest corner of the destination region.

saveMode: StructureSaveMode

Must be one of disk and memory.
Specifies the storage location.

includesEntities: Boolean: bool

Must be a boolean (either true or false).
Specifies whether including entities or not. If unspecified, defaults to true.

rotation: Rotation

Must be one of 0_degrees, 90_degrees, 180_degrees, and 270_degrees.
Specifies the rotation when loading a structure. If unspecified, defaults to 0_degrees.

mirror: Mirror

Must be one of x, z, xz, and none.
Specifies the axis of mirror flip when loading a structure. If unspecified, defaults to none.

animationMode: StructureAnimationMode

Must be one of block_by_block and layer_by_layer.
Specifies the animation to generate structures.

animationSeconds: float: float

Must be a Single-precision floating-point format number.
Specifies the duration of the animation.

includesBlocks: Boolean: bool

Must be a boolean (either true or false).
Specifies whether including blocks or not. If unspecified, defaults to true.

integrity: float: float

Must be a Single-precision floating-point format number. Must be between 0 and 100 (inclusive).
Specifies the integrity (probability of each block being loaded). If 100, all blocks in the structure are loaded. If 0, no blocks are loaded. If unspecified, defaults to 100.

seed: string: basic_string

Must be a string.
Specifies the seed when calculating whether a block should be loaded according to integrity. If unspecified, a random seed is taken.

Result[edit]

CommandTriggerBedrock Edition
anythe arguments are not specified correctly Failed
if one or both specified regions are unloaded or out of the world
/structure save ...if the region is greater than 64 * 256 * 64 (the equivalent of 16 chunk sections)‌
/structure load ...if the specified structure does not exist
anyOn successSaves or loads blocks.

Output[edit]

CommandEditionSituationSuccess Count
anyBedrock EditionOn fail0
On success1

History[edit]

Bedrock Edition
1.16.100beta 1.16.100.52Added /structure.
beta 1.16.100.60Added the ability to animate the placement of a structure.