Commands/structure
< Commands
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.
Contents
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
ornamespace:name
. If namespace is unspecified, defaults tomystructure:
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
andmemory
.
includesEntities: Boolean
: bool
- Specifies whether including entities or not. If unspecified, defaults to
true
. - Must be a boolean (either
true
orfalse
).
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
, and270_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
, andnone
.
animationMode: StructureAnimationMode
- Specifies the animation to generate structures.
- Must be one of
block_by_block
andlayer_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
orfalse
).
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]
Command | Trigger | Bedrock Edition |
---|---|---|
any | the 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 ... | the specified structure does not exist | |
any | On success | Saves or loads blocks, or deletes saved structure files. |
Output[edit]
Command | Edition | Situation | Success Count |
---|---|---|---|
any | Bedrock Edition | On fail | 0 |
On success | 1 |
History[edit]
Bedrock Edition | |||||
---|---|---|---|---|---|
1.16.100 | beta 1.16.100.52 | Added /structure . | |||
beta 1.16.100.60 | Added the ability to animate the placement of a structure. | ||||
Upcoming Bedrock Edition | |||||
1.16.210 | beta 1.16.210.54 | /structure now have the ability to delete saved structure files. |