Commands/structure

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

1

Restrictions

Cheat only

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.
structure delete <name: string>
Deletes saved structure file.

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)

Specifies any two opposing corner blocks of the region to be saved.
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.

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

Specifies the lower northwest corner of the destination region.
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.

saveMode: StructureSaveMode

Specifies the storage location.
Must be one of disk and memory.
disk saves the structure to the world itself. When leaving and rejoining the world, the structure save files will still be saved.
memory only saves the structure locally. When leaving and rejoining the world, the structure save files will be gone.

includesEntities: Boolean: bool

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

rotation: Rotation

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

mirror: Mirror

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

animationMode: StructureAnimationMode

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

animationSeconds: float: float

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

includesBlocks: Boolean: bool

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

integrity: float: float

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.
Must be a Single-precision floating-point format number. Must be between 0 and 100 (inclusive).

seed: string: basic_string

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

Result[edit]

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

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.
1.16.210beta 1.16.210.54/structure now have the ability to delete saved structure files.