/place
/place
Permission level required |
2 |
---|---|
Restrictions |
{ "title": "<code>/place</code>", "rows": [ { "field": "2", "label": "(link to Permission level article, displayed as Permission level<br>required)" }, { "field": "(link to Option article, displayed as Cheat) only<sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Bedrock Edition\">(link to Bedrock Edition article, displayed as BE) only</span></i>]</sup>", "label": "(link to Commands#Restrictions article, displayed as Restrictions)" } ], "invimages": [], "images": [] }
Places a configured feature, structure, structure template, or template pool if possible.
Syntax[edit | edit source]
Java Edition[edit | edit source]
place feature <feature> [<pos>]
- Place the configured feature.
place jigsaw <pool> <target> <max_depth> [<position>]
- Place a jigsaw structure starting with the specified template pool, starting jigsaw block and maximum depth.
place structure <structure> [<pos>]
- Place the structure.
place template <template> [<pos>] [<rotation>] [<mirror>] [<integrity>] [<seed>] [strict]
- Place the structure template. (Works like using the load button in the UI for a structure block.)
Bedrock Edition[edit | edit source]
place feature <feature: features> [position: x y z]
place featurerule <featurerule: featureRules> [position: x y z]
- Place the feature.
place jigsaw <pool: filepath> <jigsawTarget: string> <maxDepth: int> [pos: x y z] [keepJigsaws: Boolean]
[only "Data-Driven Jigsaw Structures" Experiment]- Place a jigsaw structure starting with the specified template pool, starting jigsaw block and maximum depth.
place structure <structure: string> [pos: x y z] [ignoreStartHeight: Boolean] [keepJigsaws: Boolean]
[only "Data-Driven Jigsaw Structures" Experiment]- Place the structure.
Arguments[edit | edit source]
JE: <feature>
: resource_key
- Specifies the configured feature to place. See Feature for vanilla configured features.
- Must be a resource location, which resolves during command execution into a registry entry in
minecraft:worldgen/configured_feature
registry.
JE: <structure>
: resource_key
BE: structure: string
: basic_string
- Specifies the structure. See Structure for vanilla structures.
- Must be a resource location, which resolves during command execution into a registry entry in
minecraft:worldgen/structure
registry.
JE: <pool>
: resource_key
BE: pool: filepath
: CommandFilePath
- Specifies the start template pool to start generating a jigsaw.
- Must be a resource location, which resolves during command execution into a registry entry in
minecraft:worldgen/template_pool
registry.
JE: <target>
: resource_location
BE: jigsawTarget: string
: basic_string
- Specifies the jigsaw block that is connected to when generating the start structure pool.
- Must be a resource location for an unregistered content.
JE: <max_depth>
: integer
BE: maxDepth
: int
- Specifies the max depth of the jigsaw.
- Must be a [Int]32-bit integer number (from -2147483648 (-231) to 2147483647 (231-1) ). And it must be between 1 and 20 (inclusive).
BE: <keepJigsaws: Boolean>
: enum
- Specifies whether the jigsaws should be kept or not. If not specified, defaults to
false
. - Must be a [Boolean]Boolean (either
true
orfalse
).
JE: <template>
: resource_location
- Specifies the structure template to place.
- Must be a resource location for an unregistered content.
JE: <pos>
: block_pos and <position>
: block_pos
BE: <pos: x y z>
: CommandPosition
- Specifies the start position of the placement.
- Must be a block position composed of
<X>
,<Y>
and<Z>
, each of which must be an integer or a tilde and caret notation.
- Specifies the feature.
- Must be a string. And it must be a single word that has no space or a double-quoted string (When quoted,
\
can be used to escape characters).
BE: featurerule: featureRules
: enum
- Specifies the feature rule.
- Must be a string. And it must be a single word that has no space or a double-quoted string (When quoted,
\
can be used to escape characters).
BE: <ignoreStartHeight: Boolean>
: enum
- Specifies whether the structure should start generating at the given Y coordinate or follow its set height placement rules. If not specified, defaults to
false
. - Must be a [Boolean]Boolean (either
true
orfalse
).
JE: <rotation>
: template_rotation
- Specifies the rotation to apply to the placed template.
- Must be either
none
,clockwise_90
,counterclockwise_90
, or180
. If omitted, defaults tonone
.
JE: <mirror>
: template_mirror
- Specifies the mirroring to apply to the placed template.
- Must be either
none
,front_back
, orleft_right
. If omitted, defaults tonone
.
- Specifies the integrity value to apply to the placed template (how complete the template that gets placed is). If omitted, defaults to 1.0.
- Must be a [Float]Single-precision floating-point number (from -(2-2-23)×2127 (≈-3.4×1038) to (2-2-23)2×127 (≈3.4×1038) ). And it must be between 0.0 and 1.0 (inclusive).
- Specifies the seed to use for randomized degradation of the placed template when integrity is less than 1. If omitted, defaults to 0.
- Must be a [Int]32-bit integer number (from -2147483648 (-231) to 2147483647 (231-1) ).
JE: strict
- Makes the command place blocks as-is without triggering block updates and shape updates.
Result[edit | edit source]
Command | Trigger | Java Edition |
---|---|---|
Any | The command is incomplete, or any argument is not specified correctly. | Unparseable |
/place feature ... | Any of 3×3 chunks around the start position is unloaded or out of the world. | Failed |
/place template ... | Any of chunks that the template would be in before rotation is unloaded or out of the world. | |
/place jigsaw ... | The start position is unloaded or out of the world. | |
/place structure ... | Any of chunks to place in is unloaded or out of the world.[1] | Failed or Error |
/place structure <structure> <pos> | The specified <pos> is unloaded or out of world. | Failed |
/place feature ... | There's no configured feature with the provided ID. | |
The configured feature could not generate - depends on the configured feature. | ||
/place jigsaw ... | There's no structure pool with the provided ID. | |
The specified start pool has no element.[2] | Error | |
Tries to generate an empty element (empty_pool_element ) in the start pool. | Failed | |
Jigsaw block with the specified ID is not found in the start pool. | ||
/place structure ... | There is no structure with the provided ID. | |
There is no valid position in this chunk to place the specified structure - depends on the structure. | ||
There is no valid biome in this chunk to place the specified structure - depends on the structure. | ||
/place template ... | There is no template with the provided ID. | |
There's no block and entity in this template file. | ||
Any | Otherwise | Successful |
Output[edit | edit source]
Command | Edition | Situation | Success Count | /execute store success ... | /execute store result ... |
---|---|---|---|---|---|
Any | Java Edition | On fail | 0 | 0 | 0 |
On success | 1 | 1 | 1 | ||
On error | 0 | unchanged | unchanged | ||
Bedrock Edition | On fail | 0 | N/A | N/A | |
On success | 1 | N/A | N/A |
History[edit | edit source]
[hide]Java Edition | |||||||
---|---|---|---|---|---|---|---|
1.19 | 22w18a | Added /place , replacing /placefeature . | |||||
22w19a | /place can now place templates for structure blocks. | ||||||
Pre-release 1 | /place template can now be autocompleted. | ||||||
1.20.5 | 24w07a | Now the limit of max depth in /place is 20 instead of 7.[3] | |||||
pre2 | Now /place jigsaw checks whether the position is unloaded or out of the world before placement.[4] | ||||||
1.21.5 | 25w02a | Accepts a new option: strict . | |||||
New syntax for commands to use the new strict option. | |||||||
[hide]Bedrock Edition | |||||||
1.21.50 Experiment | Preview 1.21.50.26 | Added /place behind the "Data-Driven Jigsaw Structures" experimental toggle. | |||||
1.21.60 Experiment | Preview 1.21.60.23 | Added feature and featurerule subcommands behind the "Upcoming Creator Features" experimental toggle. |
Issues[edit | edit source]
The check to ensure that the target position is loaded works by testing if blocks are placeable at Y=0 in the target chunk. If this check is made in a custom dimension where Y=0 is out of the world, it will always fail, preventing the command from ever succeeding.[5]
Issues relating to "Commands/place" are maintained on the bug tracker. Issues should be reported and viewed there.