Minecraft:Commands/place: Difference between revisions
More actions
Fix template calls: add MC/ prefix |
Sync: updated from Minecraft |
||
| Line 1: | Line 1: | ||
{{for|the removed command with the same name {{ | {{for|the removed command with the same name {{in|education}}|Commands/place (Education)}} | ||
{{for|the command that places a structure template {{ | {{for|the command that places a structure template {{in|bedrock}}|Commands/structure}} | ||
{{Infobox command | {{Infobox command | ||
|name=place | |name=place | ||
|oplevel=2 | |oplevel=2 | ||
|others=Cheat only{{only|be|short=1}} | |others=[[Minecraft:Cheat]] only{{only|be|short=1}} | ||
}} | }} | ||
Places a configured feature, structure, structure template, or template pool if possible. | Places a [[Minecraft:configured feature]], [[Minecraft:Structure/JSON format|structure]], [[Minecraft:structure template]], or [[Minecraft:template pool]] if possible. | ||
== Syntax == | == Syntax == | ||
=== ''Java Edition'' === | === ''Java Edition'' === | ||
:<code>place feature <feature> [<pos>]</code> | :<code>place feature <feature> [<pos>]</code> | ||
::Place the configured feature. | ::Place the [[Minecraft:configured feature]]. | ||
:<code>place jigsaw <pool> <target> <max_depth> [<position>]</code> | :<code>place jigsaw <pool> <target> <max_depth> [<position>]</code> | ||
::Place a jigsaw structure starting with the specified template pool, starting jigsaw block and maximum depth. | ::Place a [[Minecraft:jigsaw structure]] starting with the specified [[Minecraft:template pool]], starting [[Minecraft:jigsaw block]] and maximum depth. | ||
:<code>place structure <structure> [<pos>]</code> | :<code>place structure <structure> [<pos>]</code> | ||
::Place the structure. | ::Place the [[Minecraft:Structure/JSON format|structure]]. | ||
:<code>place template <template> [<pos>] [<rotation>] [<mirror>] [<integrity>] [<seed>] [strict]</code> | :<code>place template <template> [<pos>] [<rotation>] [<mirror>] [<integrity>] [<seed>] [strict]</code> | ||
::Place the structure template. (Works like using the load button in the UI for a structure block.) | ::Place the [[Minecraft:structure template]]. (Works like using the load button in the UI for a [[Minecraft:structure block]].) | ||
=== ''Bedrock Edition'' === | === ''Bedrock Edition'' === | ||
| Line 27: | Line 27: | ||
:<code>place jigsaw <pool: filepath> <jigsawTarget: string> <maxDepth: int> [pos: x y z] [keepJigsaws: Boolean] [includeEntities: Bolean] [liquidSettings: LiquidSettings]</code> | :<code>place jigsaw <pool: filepath> <jigsawTarget: string> <maxDepth: int> [pos: x y z] [keepJigsaws: Boolean] [includeEntities: Bolean] [liquidSettings: LiquidSettings]</code> | ||
::Place a jigsaw structure starting with the specified template pool, starting jigsaw block and maximum depth. | ::Place a [[Minecraft:jigsaw structure]] starting with the specified [[Minecraft:template pool]], starting [[Minecraft:jigsaw block]] and maximum depth. | ||
:<code>place structure <structure: string> [pos: x y z] [ignoreStartHeight: Boolean] [keepJigsaws: Boolean] [includeEntities: Boolean] [liquidSettings: LiquidSettings]</code> | :<code>place structure <structure: string> [pos: x y z] [ignoreStartHeight: Boolean] [keepJigsaws: Boolean] [includeEntities: Boolean] [liquidSettings: LiquidSettings]</code> | ||
::Place the structure. | ::Place the [[Minecraft:Structure/JSON format|structure]]. | ||
:::Only {{ | :::Only {{EnvLink|Trail Ruins}} and {{EnvLink|Trial Chambers}} and custom jigsaw structures can be placed. | ||
== Arguments == | == Arguments == | ||
{{ | {{el|je|short=1}}: {{argument|feature|resource_key}} | ||
:Specifies the configured feature to place. See [[Minecraft:Feature]] for vanilla configured features. | :Specifies the [[Minecraft:configured feature]] to place. See [[Minecraft:Feature]] for vanilla configured features. | ||
:{{ | :{{arg desc|je=resource_key|registry=minecraft:worldgen/configured_feature}} | ||
{{ | {{argument|structure|resource_key|structure: string|basic_string}} | ||
:Specifies the structure. See [[Minecraft:Structure]] for vanilla structures. | :Specifies the [[Minecraft:Structure/JSON format|structure]]. See [[Minecraft:Structure]] for vanilla structures. | ||
:{{ | :{{arg desc|je=resource_key|registry=minecraft:worldgen/structure}} | ||
{{ | {{argument|pool|resource_key|pool: filepath|CommandFilePath}} | ||
:Specifies the start template pool to start generating a jigsaw. | :Specifies the start [[Minecraft:template pool]] to start generating a jigsaw. | ||
:{{ | :{{arg desc|je=resource_key|registry=minecraft:worldgen/template_pool}} | ||
{{ | {{argument|target|resource_location|jigsawTarget: string|basic_string}} | ||
:Specifies the jigsaw block that is connected to when generating the start structure pool. | :Specifies the [[Minecraft:jigsaw block]] that is connected to when generating the start structure pool. | ||
:{{ | :{{arg desc|je=resource_location}} | ||
{{ | {{argument|max_depth|integer|maxDepth|int}} | ||
:Specifies the max depth of the jigsaw. | :Specifies the max depth of the jigsaw. | ||
:{{ | :{{arg desc|je=integer|min=1|max=20}} | ||
{{ | {{el|be|short=1}}: {{argument|keepJigsaws: Boolean|enum}} | ||
:Specifies whether the jigsaws should be kept or not. If not specified, defaults to <code>false</code>. | :Specifies whether the jigsaws should be kept or not. If not specified, defaults to <code>false</code>. | ||
:{{ | :{{arg desc|je=bool}} | ||
{{ | {{el|je|short=1}}: {{argument|template|resource_location}} | ||
:Specifies the structure template to place. | :Specifies the [[Minecraft:structure template]] to place. | ||
:{{ | :{{arg desc|je=resource_location}} | ||
{{ | {{el|je|short=1}}: {{argument|pos|block_pos}} and {{argument|position|block_pos}}<br> | ||
{{ | {{el|be|short=1}}: {{argument|pos: x y z|CommandPosition}} | ||
:Specifies the start position of the placement. | :Specifies the start position of the placement. | ||
:{{ | :{{arg desc|je=block_pos}} | ||
{{ | {{el|be|short=1}}: {{argument|be=1|feature: features|enum}} | ||
:Specifies the feature. | :Specifies the feature. | ||
:{{ | :{{arg desc|be=enum}} | ||
{{ | {{el|be|short=1}}: {{argument|be=1|featurerule: featureRules|enum}} | ||
:Specifies the feature rule. | :Specifies the feature rule. | ||
:{{ | :{{arg desc|be=enum}} | ||
{{ | {{el|be|short=1}}: {{argument|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 <code>false</code>. | :Specifies whether the structure should start generating at the given Y coordinate or follow its set height placement rules. If not specified, defaults to <code>false</code>. | ||
:{{ | :{{arg desc|je=bool}} | ||
{{ | {{el|be|short=1}}: {{argument|includeEntities: Boolean|enum}} | ||
:Specifies whether the structure will include the entities saved in it or not. If not specified, defaults to <code>false</code>. | :Specifies whether the structure will include the entities saved in it or not. If not specified, defaults to <code>false</code>. | ||
:{{ | :{{arg desc|je=bool}} | ||
{{ | {{el|be|short=1}}: {{argument|liquidSettings: LiquidSettings|?}} | ||
:Specifies whether the structure will waterlog present blocks or not. | :Specifies whether the structure will waterlog present blocks or not. | ||
:Must be either {{ | :Must be either {{cd|ignore_waterlogging}}, or {{cd|apply_waterlogging}}. If omitted, defaults to {{cd|apply_waterlogging}}. | ||
{{ | {{el|je|short=1}}: {{argument|rotation|template_rotation}} | ||
:Specifies the rotation to apply to the placed template. | :Specifies the rotation to apply to the placed template. | ||
:Must be either {{ | :Must be either {{cd|none}}, {{cd|clockwise_90}}, {{cd|counterclockwise_90}}, or {{cd|180}}. If omitted, defaults to {{cd|none}}. | ||
{{ | {{el|je|short=1}}: {{argument|mirror|template_mirror}} | ||
:Specifies the mirroring to apply to the placed template. | :Specifies the mirroring to apply to the placed template. | ||
:Must be either {{ | :Must be either {{cd|none}}, {{cd|front_back}}, or {{cd|left_right}}. If omitted, defaults to {{cd|none}}. | ||
{{ | {{el|je|short=1}}: {{argument|integrity|float}} | ||
:Specifies the integrity value to apply to the placed template (how complete the template that gets placed is). If omitted, defaults to 1.0. | :Specifies the integrity value to apply to the placed template (how complete the template that gets placed is). If omitted, defaults to 1.0. | ||
:{{ | :{{arg desc|je=float|min=0.0|max=1.0}} | ||
{{ | {{el|je|short=1}}: {{argument|seed|integer}} | ||
:Specifies the seed to use for randomized degradation of the placed template when integrity is less than 1. If omitted, defaults to 0. | :Specifies the seed to use for randomized degradation of the placed template when integrity is less than 1. If omitted, defaults to 0. | ||
:{{ | :{{arg desc|je=integer}} | ||
{{ | {{el|je|short=1}}: {{cd|strict}} | ||
:Makes the command place blocks as-is without triggering block updates and shape updates. | :Makes the command place blocks as-is without triggering block updates and shape updates. | ||
| Line 129: | Line 129: | ||
== Output == | == Output == | ||
{{ | {{Output table}} | ||
{{ | {{Output table|edition=je|On fail|0|0|0}} | ||
{{ | {{Output table|On success|1|1|1}} | ||
{{ | {{Output table|On error|0|unchanged|unchanged}} | ||
{{ | {{Output table|edition=be|On fail|0|N/A|N/A}} | ||
{{ | {{Output table|On success|1|N/A|N/A}} | ||
{{ | {{Output table}} | ||
== History == | == History == | ||
=== ''Java Edition'' === | === ''Java Edition'' === | ||
{{HistoryTable | {{HistoryTable | ||
|{{ | |{{HistoryLine|java}} | ||
|{{HistoryLine||1.19|dev=22w18a|Added {{ | |{{HistoryLine||1.19|dev=22w18a|Added {{cd|/place}}, replacing {{cmd|placefeature}}.}} | ||
|{{HistoryLine|||dev=22w19a|{{ | |{{HistoryLine|||dev=22w19a|{{cd|/place}} can now place templates for structure blocks.}} | ||
|{{HistoryLine|||dev=Pre-release 1|{{ | |{{HistoryLine|||dev=Pre-release 1|{{cd|/place template}} can now be autocompleted.}} | ||
|{{HistoryLine||1.20.5|dev=24w07a|Now the limit of max depth in {{ | |{{HistoryLine||1.20.5|dev=24w07a|Now the limit of max depth in {{cd|/place}} is 20 instead of 7.<ref>{{bug|MC-267732|||fixed}}</ref>}} | ||
|{{HistoryLine|||dev=pre2|Now {{ | |{{HistoryLine|||dev=pre2|Now {{cmd|place jigsaw|link=none}} checks whether the position is unloaded or out of the world before placement.<ref>{{bug|MC-259355|||fixed}}</ref>}} | ||
|{{ | |{{HistoryLine||1.21.5|dev=25w02a|Accepts a new option: <code>strict</code>.|New syntax for commands to use the new strict option.}} | ||
}} | }} | ||
=== ''Bedrock Edition'' === | === ''Bedrock Edition'' === | ||
{{HistoryTable | {{HistoryTable | ||
|{{ | |{{HistoryLine|bedrock}} | ||
|{{HistoryLine||1.21.50|exp=Data-Driven Jigsaw Structures|dev=Preview 1.21.50.26|Added {{ | |{{HistoryLine||1.21.50|exp=Data-Driven Jigsaw Structures|dev=Preview 1.21.50.26|Added {{cd|/place}} behind the "Data-Driven Jigsaw Structures" [[Minecraft:experimental]] toggle.}} | ||
|{{HistoryLine||1.21.60|exp=Upcoming Creator Features|dev=Preview 1.21.60.23|Added {{ | |{{HistoryLine||1.21.60|exp=Upcoming Creator Features|dev=Preview 1.21.60.23|Added {{cd|feature}} and {{cd|featurerule}} subcommands behind the "Upcoming Creator Features" [[Minecraft:experimental]] toggle.}} | ||
|{{HistoryLine||1.21.70|dev=Preview 1.21.70.22|Moved the {{ | |{{HistoryLine||1.21.70|dev=Preview 1.21.70.22|Moved the {{cd|/place}} with the subcommands {{cd|feature}} and {{cd|featurerule}} out of the "Upcoming Creator Features" experiment.}} | ||
|{{HistoryLine||1.21.80|dev=Preview 1.21.80.22|Moved the subcommands {{ | |{{HistoryLine||1.21.80|dev=Preview 1.21.80.22|Moved the subcommands {{cd|structure}} and {{cd|jigsaw}} out of the "Data-Driven Jigsaw Structures" experiment.}} | ||
|{{HistoryLine||1.21.90|dev=Preview 1.21.90.21|Added subfield {{ | |{{HistoryLine||1.21.90|dev=Preview 1.21.90.21|Added subfield {{cd|[liquidSettings: LiquidSettings]}} to {{cmd|place jigsaw|link=none}} and {{cmd|place structure|link=none}} which controls whether the structure will apply [[Minecraft:waterlogged]] or ignore.}} | ||
}} | }} | ||
| Line 162: | Line 162: | ||
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.<ref>{{bug|MC-255097}}</ref> | 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.<ref>{{bug|MC-255097}}</ref> | ||
{{ | {{issue list}} | ||
== References == | == References == | ||
{{ | {{Reflist}} | ||
== External links == | == External links == | ||
| Line 172: | Line 172: | ||
== Navigation == | == Navigation == | ||
{{ | {{Navbox commands}} | ||
de:Befehl/place | [[Minecraft:de:Befehl/place]] | ||
es:Comandos/place | [[Minecraft:es:Comandos/place]] | ||
ja:コマンド/place | [[Minecraft:fr:Commandes/place]] | ||
pt:Comandos/place | [[Minecraft:ja:コマンド/place]] | ||
ru:Команды консоли/place | [[Minecraft:pt:Comandos/place]] | ||
zh:命令/place | [[Minecraft:ru:Команды консоли/place]] | ||
[[Minecraft:zh:命令/place]] | |||
Latest revision as of 11:03, 19 May 2026
Template:For Template:For Template:Infobox command
Places a Minecraft:configured feature, structure, Minecraft:structure template, or Minecraft:template pool if possible.
Syntax
Java Edition
place feature <feature> [<pos>]- Place the Minecraft:configured feature.
place jigsaw <pool> <target> <max_depth> [<position>]- Place a Minecraft:jigsaw structure starting with the specified Minecraft:template pool, starting Minecraft:jigsaw block and maximum depth.
place structure <structure> [<pos>]- Place the structure.
place template <template> [<pos>] [<rotation>] [<mirror>] [<integrity>] [<seed>] [strict]- Place the Minecraft:structure template. (Works like using the load button in the UI for a Minecraft:structure block.)
Bedrock Edition
place feature <feature: features> [position: x y z]place featurerule <featurerule: featureRules> [position: x y z]- Place the Minecraft:feature.
place jigsaw <pool: filepath> <jigsawTarget: string> <maxDepth: int> [pos: x y z] [keepJigsaws: Boolean] [includeEntities: Bolean] [liquidSettings: LiquidSettings]- Place a Minecraft:jigsaw structure starting with the specified Minecraft:template pool, starting Minecraft:jigsaw block and maximum depth.
place structure <structure: string> [pos: x y z] [ignoreStartHeight: Boolean] [keepJigsaws: Boolean] [includeEntities: Boolean] [liquidSettings: LiquidSettings]- Place the structure.
- Only Template:EnvLink and Template:EnvLink and custom jigsaw structures can be placed.
- Place the structure.
Arguments
Template:El: Template:Argument
- Specifies the Minecraft:configured feature to place. See Minecraft:Feature for vanilla configured features.
- Template:Arg desc
- Specifies the structure. See Minecraft:Structure for vanilla structures.
- Template:Arg desc
- Specifies the start Minecraft:template pool to start generating a jigsaw.
- Template:Arg desc
- Specifies the Minecraft:jigsaw block that is connected to when generating the start structure pool.
- Template:Arg desc
- Specifies the max depth of the jigsaw.
- Template:Arg desc
Template:El: Template:Argument
- Specifies whether the jigsaws should be kept or not. If not specified, defaults to
false. - Template:Arg desc
Template:El: Template:Argument
- Specifies the Minecraft:structure template to place.
- Template:Arg desc
Template:El: Template:Argument and Template:Argument
Template:El: Template:Argument
- Specifies the start position of the placement.
- Template:Arg desc
Template:El: Template:Argument
- Specifies the feature.
- Template:Arg desc
Template:El: Template:Argument
- Specifies the feature rule.
- Template:Arg desc
Template:El: Template:Argument
- 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. - Template:Arg desc
Template:El: Template:Argument
- Specifies whether the structure will include the entities saved in it or not. If not specified, defaults to
false. - Template:Arg desc
Template:El: Template:Argument
- Specifies whether the structure will waterlog present blocks or not.
- Must be either Template:Cd, or Template:Cd. If omitted, defaults to Template:Cd.
Template:El: Template:Argument
- Specifies the rotation to apply to the placed template.
- Must be either Template:Cd, Template:Cd, Template:Cd, or Template:Cd. If omitted, defaults to Template:Cd.
Template:El: Template:Argument
- Specifies the mirroring to apply to the placed template.
- Must be either Template:Cd, Template:Cd, or Template:Cd. If omitted, defaults to Template:Cd.
Template:El: Template:Argument
- Specifies the integrity value to apply to the placed template (how complete the template that gets placed is). If omitted, defaults to 1.0.
- Template:Arg desc
Template:El: Template:Argument
- Specifies the seed to use for randomized degradation of the placed template when integrity is less than 1. If omitted, defaults to 0.
- Template:Arg desc
- Makes the command place blocks as-is without triggering block updates and shape updates.
Result
Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table
Output
Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table
History
Java Edition
Bedrock Edition
Issues
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.<ref>Template:Bug</ref>
References
External links
Minecraft:de:Befehl/place Minecraft:es:Comandos/place Minecraft:fr:Commandes/place Minecraft:ja:コマンド/place Minecraft:pt:Comandos/place Minecraft:ru:Команды консоли/place Minecraft:zh:命令/place