Minecraft:Commands/summon: Difference between revisions
More actions
Remove broken links to missing pages |
Fix template calls: add MC/ prefix |
||
| Line 22: | Line 22: | ||
==Arguments== | ==Arguments== | ||
{{ | {{MC/Argument|entity|resource|entityType: EntityType|enum}} | ||
: Specifies the entity to be summoned. | : Specifies the entity to be summoned. | ||
: {{ | : {{MC/Arg desc|je=resource|registry=minecraft:entity_type|be=enum}} | ||
: {{ | : {{MC/In|java}}, player and fishing bobber entity cannot be summoned. Commands trying to summon them always fail. | ||
: {{ | : {{MC/In|bedrock}}, only certain entity types are allowed to be summoned. Entity types that are allowed to be summoned are listed in the auto-completion suggestion list. Commands trying to summon an entity that cannot be summoned are unparseable. | ||
{{ | {{MC/Argument|pos|vec3|spawnPos: x y z|CommandPositionFloat}} | ||
: Specifies the position to summon the entity. If not specified, defaults to the position of the command's execution. | : Specifies the position to summon the entity. If not specified, defaults to the position of the command's execution. | ||
: {{ | : {{MC/Arg desc|je=vec3|be=CommandPositionFloat}} | ||
{{ | {{MC/El|je|short=1}}: {{MC/Argument|nbt|nbt_compound_tag}} | ||
: Specifies the [[Minecraft:Commands#Data tags|data tag]] for the entity, this can include any NBT in Entity format. | : Specifies the [[Minecraft:Commands#Data tags|data tag]] for the entity, this can include any NBT in Entity format. | ||
: {{ | : {{MC/Arg desc|je=nbt_compound_tag}} | ||
{{ | {{MC/El|be|short=1}}: {{MC/Argument|be=1|yRot: value|RelativeFloat}} and {{MC/Argument|be=1|xRot: value|RelativeFloat}} | ||
: Specifies the rotation of the summoned entity. | : Specifies the rotation of the summoned entity. | ||
: {{ | : {{MC/Arg desc|be=RelativeFloat}} | ||
{{ | {{MC/El|be|short=1}}: {{MC/Argument|be=1|lookAtEntity: target|CommandSelector<Actor>}} | ||
: Specifies the entity to make the summoned entity facing to. | : Specifies the entity to make the summoned entity facing to. | ||
: {{ | : {{MC/Arg desc|be=CommandSelector<Actor>}} | ||
{{ | {{MC/El|be|short=1}}: {{MC/Argument|be=1|lookAtPosition: x y z|CommandPositionFloat}} | ||
: Specifies the coordinates to make the summoned entity facing to. | : Specifies the coordinates to make the summoned entity facing to. | ||
: {{ | : {{MC/Arg desc|be=CommandPositionFloat}} | ||
{{ | {{MC/El|be|short=1}}: {{MC/Argument|be=1|spawnEvent: string|basic_string}} | ||
: Specifies the in-game event for the entity. Should be a [[Minecraft:spawn event]] (event name for entities in behavior pack). | : Specifies the in-game event for the entity. Should be a [[Minecraft:spawn event]] (event name for entities in behavior pack). | ||
: {{ | : {{MC/Arg desc|be=basic_string}} | ||
{{ | {{MC/El|be|short=1}}: {{MC/Argument|be=1|nameTag: string|basic_string}} | ||
: Specifies the name of the entity. | : Specifies the name of the entity. | ||
: {{ | : {{MC/Arg desc|be=basic_string}} | ||
==Result== | ==Result== | ||
| Line 61: | Line 61: | ||
{{Result table|The command is incomplete, or any argument is not specified correctly.|unparseable|unparseable}} | {{Result table|The command is incomplete, or any argument is not specified correctly.|unparseable|unparseable}} | ||
{{Result table|<code>entityType: EntityType</code> is not an entity type that is allowed to be summoned.|N/A|unparseable}} | {{Result table|<code>entityType: EntityType</code> is not an entity type that is allowed to be summoned.|N/A|unparseable}} | ||
{{Result table|<code><entity></code> is {{ | {{Result table|<code><entity></code> is {{MC/Code|minecraft:player}} or {{MC/Code|minecraft:fishing_bobber}}.|fail|N/A}} | ||
{{Result table|Specified position is unloaded.||fail}} | {{Result table|Specified position is unloaded.||fail}} | ||
{{Result table|Trying to summon hostiles in peaceful difficulty.|success}} | {{Result table|Trying to summon hostiles in peaceful difficulty.|success}} | ||
| Line 71: | Line 71: | ||
== Output == | == Output == | ||
{{Output table}} | {{MC/Output table}} | ||
{{Output table|edition=je|On fail|0|0|0}} | {{MC/Output table|edition=je|On fail|0|0|0}} | ||
{{Output table|On success|1|1|1}} | {{MC/Output table|On success|1|1|1}} | ||
{{Output table|edition=be|On fail|0}} | {{MC/Output table|edition=be|On fail|0}} | ||
{{Output table|On success|1}} | {{MC/Output table|On success|1}} | ||
{{Output table}} | {{MC/Output table}} | ||
==Examples== | ==Examples== | ||
| Line 108: | Line 108: | ||
==History== | ==History== | ||
{{Expand section}} | {{MC/Expand section}} | ||
===''Java Edition''=== | ===''Java Edition''=== | ||
{{HistoryTable | {{HistoryTable | ||
|{{HistoryLine|java}} | |{{MC/HistoryLine|java}} | ||
|{{HistoryLine||1.7.2|dev=13w36a|Added {{ | |{{HistoryLine||1.7.2|dev=13w36a|Added {{MC/Cmd|summon|link=none}}.}} | ||
|{{HistoryLine||1.8|dev=14w30a|{{ | |{{HistoryLine||1.8|dev=14w30a|{{MC/Cmd|summon|link=none}} can now spawn lightning.}} | ||
|{{HistoryLine||1.16|dev=20w06a|{{ | |{{HistoryLine||1.16|dev=20w06a|{{MC/Cmd|summon|link=none}} now cannot summon an entity with a position where <x> or <z> exceeds the range of [-30000000, 30000000), or <y> exceeds the range of [-20000000, 20000000)}} | ||
|{{HistoryLine|||dev=20w11a|{{ | |{{HistoryLine|||dev=20w11a|{{MC/Cmd|summon|link=none}} now gives permission to summon Fireball.}} | ||
|{{HistoryLine||1.19.3|dev=22w42a|{{ | |{{HistoryLine||1.19.3|dev=22w42a|{{MC/Cd|<entity>}} now accepts a [[Minecraft:argument types|<code>resource</code> argument]], instead of <code>entity_summon</code>.}} | ||
|{{HistoryLine||1.21.9|dev=25w31a|The command now fails when trying to summon monsters while the difficulty is set to Peaceful.}}}} | |{{MC/HistoryLine||1.21.9|dev=25w31a|The command now fails when trying to summon monsters while the difficulty is set to Peaceful.}}}} | ||
===''Bedrock Edition''=== | ===''Bedrock Edition''=== | ||
{{HistoryTable | {{HistoryTable | ||
|{{HistoryLine|pocket alpha}} | |{{MC/HistoryLine|pocket alpha}} | ||
|{{HistoryLine||v0.16.0|dev=build 1|Added {{ | |{{HistoryLine||v0.16.0|dev=build 1|Added {{MC/Cmd|summon|link=none}}.}} | ||
|{{HistoryLine|bedrock}} | |{{MC/HistoryLine|bedrock}} | ||
|{{HistoryLine||1.19.40|dev=Preview 1.19.40.21|Added new overload to the {{ | |{{HistoryLine||1.19.40|dev=Preview 1.19.40.21|Added new overload to the {{MC/Cmd|summon|link=none}} command that adds rotation arguments.}} | ||
|{{HistoryLine|||dev=Preview 1.19.40.23|Temporarily disabled the rotation for the {{ | |{{HistoryLine|||dev=Preview 1.19.40.23|Temporarily disabled the rotation for the {{MC/Cmd|summon|link=none}} command while a bug is worked on.}} | ||
|{{HistoryLine||1.19.70|dev=Preview 1.19.70.23|Re-added the rotation arguments.}} | |{{MC/HistoryLine||1.19.70|dev=Preview 1.19.70.23|Re-added the rotation arguments.}} | ||
|{{HistoryLine||1.19.80|dev=Preview 1.19.80.20|Added <code>facing</code> argument.}} | |{{MC/HistoryLine||1.19.80|dev=Preview 1.19.80.20|Added <code>facing</code> argument.}} | ||
}} | }} | ||
| Line 134: | Line 134: | ||
== Navigation == | == Navigation == | ||
{{Navbox commands}} | {{MC/Navbox commands}} | ||
de:Befehl/summon | de:Befehl/summon | ||
Latest revision as of 20:14, 9 April 2026
Summons an entity.
Syntax
- Java Edition
summon <entity> [<pos>] [<nbt>]
- Bedrock Edition
summon <entityType: EntityType> [spawnPos: x y z] [yRot: value] [xRot: value] [spawnEvent: string] [nameTag: string]summon <entityType: EntityType> <nameTag: string> [spawnPos: x y z]summon <entityType: EntityType> [spawnPos: x y z] facing <lookAtEntity: target> [spawnEvent: string] [nameTag: string]summon <entityType: EntityType> [spawnPos: x y z] facing <lookAtPosition: x y z> [spawnEvent: string] [nameTag: string]
Arguments
Template:El: <entity>: resource
Template:El: entityType: EntityType: enum
- Specifies the entity to be summoned.
- {{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|resource}}{{#vardefine:be-arg|{{#var:je-arg}}}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}
- in Template:Editions, player and fishing bobber entity cannot be summoned. Commands trying to summon them always fail.
- in Template:Editions, only certain entity types are allowed to be summoned. Entity types that are allowed to be summoned are listed in the auto-completion suggestion list. Commands trying to summon an entity that cannot be summoned are unparseable.
Template:El: <pos>: vec3
Template:El: spawnPos: x y z: CommandPositionFloat
- Specifies the position to summon the entity. If not specified, defaults to the position of the command's execution.
- {{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|vec3}}{{#vardefine:be-arg|vec3}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}
- REDIRECT Template:Edition
Template:Rcat: <nbt>: nbt_compound_tag
- Specifies the data tag for the entity, this can include any NBT in Entity format.
- {{#vardefine:onlyje|}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|nbt_compound_tag}}{{#vardefine:be-arg|}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}
- REDIRECT Template:Edition
Template:Rcat: yRot: value: RelativeFloat and xRot: value: RelativeFloat
- Specifies the rotation of the summoned entity.
- {{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|relativefloat}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}
- REDIRECT Template:Edition
Template:Rcat: lookAtEntity: target: CommandSelector<Actor>
- Specifies the entity to make the summoned entity facing to.
- {{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|inapplicability}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}
- REDIRECT Template:Edition
Template:Rcat: lookAtPosition: x y z: CommandPositionFloat
- Specifies the coordinates to make the summoned entity facing to.
- {{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|vec3}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}
- REDIRECT Template:Edition
Template:Rcat: spawnEvent: string: basic_string
- Specifies the in-game event for the entity. Should be a Minecraft:spawn event (event name for entities in behavior pack).
- {{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|string}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}
- REDIRECT Template:Edition
Template:Rcat: nameTag: string: basic_string
- Specifies the name of the entity.
- {{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|string}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}
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
Output
{{#vardefine:output-table-lines|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:output-table-lines|-2}}{{#vardefine:output-table-lines-now|}}{{#vardefine:command-num-now|}}{{#vardefine:command-line-now|}}{{#vardefine:commands-num|}}{{#vardefine:output-edition-num-now|}}{{#vardefine:output-edition-line-now|}}{{#vardefine:output-editions-num|}}{{#vardefine:je-outputs-dis|}}
{{#vardefine:output-table-lines|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:situation-{{#var:output-table-lines}}|On fail}}{{#vardefine:output1-{{#var:output-table-lines}}|0}}{{#vardefine:output2-{{#var:output-table-lines}}|0}}{{#vardefine:output3-{{#var:output-table-lines}}|0}}{{#vardefine:command-row-{{#var:commands-num}}|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:output-editions-num|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:output-edition-{{#var:output-editions-num}}|je}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|1}} {{#vardefine:output-table-lines|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:situation-{{#var:output-table-lines}}|On success}}{{#vardefine:output1-{{#var:output-table-lines}}|1}}{{#vardefine:output2-{{#var:output-table-lines}}|1}}{{#vardefine:output3-{{#var:output-table-lines}}|1}}{{#vardefine:command-row-{{#var:commands-num}}|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|Expression error: Unrecognized punctuation character "{".}} {{#vardefine:output-table-lines|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:situation-{{#var:output-table-lines}}|On fail}}{{#vardefine:output1-{{#var:output-table-lines}}|0}}{{#vardefine:output2-{{#var:output-table-lines}}|N/A}}{{#vardefine:output3-{{#var:output-table-lines}}|N/A}}{{#vardefine:command-row-{{#var:commands-num}}|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:output-editions-num|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:output-edition-{{#var:output-editions-num}}|be}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|1}} {{#vardefine:output-table-lines|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:situation-{{#var:output-table-lines}}|On success}}{{#vardefine:output1-{{#var:output-table-lines}}|1}}{{#vardefine:output2-{{#var:output-table-lines}}|N/A}}{{#vardefine:output3-{{#var:output-table-lines}}|N/A}}{{#vardefine:command-row-{{#var:commands-num}}|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|Expression error: Unrecognized punctuation character "{".}}
{{#vardefine:output-table-lines|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:output-table-lines|-2}}{{#vardefine:output-table-lines-now|}}{{#vardefine:command-num-now|}}{{#vardefine:command-line-now|}}{{#vardefine:commands-num|}}{{#vardefine:output-edition-num-now|}}{{#vardefine:output-edition-line-now|}}{{#vardefine:output-editions-num|}}{{#vardefine:je-outputs-dis|}}
Examples
- To summon lightning 10 blocks west of the current position of the executing player:
summon lightning_bolt ~-10 ~ ~
- Java Edition:
- To summon a charged creeper at the current position named "Powered Creeper":
summon creeper ~ ~ ~ {powered:true,CustomName:'"Powered Creeper"'}- NOTE: CustomName is a raw JSON text.
- To summon an unbreakable diamond pickaxe:
summon item ~ ~ ~ {Item:{id:"minecraft:diamond_pickaxe",count:1,components:{"minecraft:unbreakable":{}}}}
- To summon a spider jockey:
summon spider ~ ~ ~ {Passengers:[{id:"minecraft:skeleton",HandItems:[{id:"minecraft:bow",count:1}]}]}
- To summon an evoker rotated -90° to face east without AI:
summon evoker ~ ~ ~ {Rotation:[-90f,0f],NoAI:1}
- To summon a Minecraft:villager that trades 1 dirt block in exchange for 5 diamonds:
summon villager ~ ~ ~ {Offers:{Recipes:[{buy:{id:"minecraft:dirt",count:1},sell:{id:"minecraft:diamond",count:5},rewardExp:false}]}}
- To summon a baby Minecraft:zombie that has the Speed II mob effect with infinite duration:
summon zombie ~ ~ ~ {IsBaby:true,active_effects:[{id:"minecraft:speed",amplifier:1b,duration:-1,show_particles:true}]}
- To summon a glowing Primed TNT 5 blocks forward, that will explode in 30 seconds but will not deal any damage to blocks or entities:
summon tnt ^ ^ ^5 {Glowing:true,fuse:600s,explosion_power:0.0f}
- To summon a charged creeper at the current position named "Powered Creeper":
- Bedrock Edition:
- To summon a patrol captain pillager at the current position:
summon pillager ~ ~ ~ ~ ~ minecraft:spawn_as_patrol_captain
- To summon a dolphin with the name "Dolphin" in a golden color:
summon dolphin §6Dolphin ~ ~ ~
- To summon a Minecraft:boat rotated 180 degrees:
summon boat ~ ~ ~ 180 180
- To summon a patrol captain pillager at the current position:
History
Template:Message boxTemplate:Article other
Java Edition
Bedrock Edition
External links
de:Befehl/summon es:Comandos/summon fr:Commandes/summon ja:コマンド/summon uk:Команди_консолі/summon pt:Comandos/summon ru:Команды консоли/summon zh:命令/summon