Minecraft:Commands/summon: Difference between revisions
More actions
Fix template calls: add MC/ prefix |
Sync: updated from Minecraft Tag: Manual revert |
||
| Line 4: | Line 4: | ||
* 2 {{only|java|short=1}} | * 2 {{only|java|short=1}} | ||
* 1 {{only|bedrock|short=1}} | * 1 {{only|bedrock|short=1}} | ||
| others = Cheat only{{only|bedrock|short=1}} | | others = [[Minecraft:Cheat]] only{{only|bedrock|short=1}} | ||
}} | }} | ||
Summons an entity. | Summons an [[Minecraft:entity]]. | ||
==Syntax== | ==Syntax== | ||
| Line 22: | Line 22: | ||
==Arguments== | ==Arguments== | ||
{{ | {{argument|entity|resource|entityType: EntityType|enum}} | ||
: Specifies the entity to be summoned. | : Specifies the entity to be summoned. | ||
: {{ | : {{arg desc|je=resource|registry=minecraft:entity_type|be=enum}} | ||
: {{ | : {{IN|java}}, player and [[Minecraft:fishing bobber]] entity cannot be summoned. Commands trying to summon them always fail. | ||
: {{ | : {{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. | ||
{{ | {{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. | ||
: {{ | : {{arg desc|je=vec3|be=CommandPositionFloat}} | ||
{{ | {{el|je|short=1}}: {{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 [[Minecraft:NBT format|NBT]] in [[Minecraft:Entity format#Entity format|Entity format]]. | ||
: {{ | : {{arg desc|je=nbt_compound_tag}} | ||
{{ | {{el|be|short=1}}: {{Argument|be=1|yRot: value|RelativeFloat}} and {{Argument|be=1|xRot: value|RelativeFloat}} | ||
: Specifies the rotation of the summoned entity. | : Specifies the rotation of the summoned entity. | ||
: {{ | : {{arg desc|be=RelativeFloat}} | ||
{{ | {{el|be|short=1}}: {{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. | ||
: {{ | : {{arg desc|be=CommandSelector<Actor>}} | ||
{{ | {{el|be|short=1}}: {{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. | ||
: {{ | : {{arg desc|be=CommandPositionFloat}} | ||
{{ | {{el|be|short=1}}: {{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). | ||
: {{ | : {{arg desc|be=basic_string}} | ||
{{ | {{el|be|short=1}}: {{argument|be=1|nameTag: string|basic_string}} | ||
: Specifies the name of the entity. | : Specifies the name of the entity. | ||
: {{ | : {{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 {{code|minecraft:player}} or {{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}} | ||
{{ | {{Output table|edition=je|On fail|0|0|0}} | ||
{{ | {{Output table|On success|1|1|1}} | ||
{{ | {{Output table|edition=be|On fail|0}} | ||
{{ | {{Output table|On success|1}} | ||
{{ | {{Output table}} | ||
==Examples== | ==Examples== | ||
| Line 84: | Line 84: | ||
* ''Java Edition'': | * ''Java Edition'': | ||
** To summon a charged creeper at the current position named "Powered Creeper": | ** To summon a [[Minecraft:charged creeper]] at the current position named "Powered Creeper": | ||
*** <code> summon creeper ~ ~ ~ {powered:true,CustomName:'"Powered Creeper"'}</code> | *** <code> summon creeper ~ ~ ~ {powered:true,CustomName:'"Powered Creeper"'}</code> | ||
*** NOTE: CustomName is a raw JSON text. | *** NOTE: CustomName is a [[Minecraft:raw JSON text]]. | ||
**To summon an unbreakable [[Minecraft:Diamond Pickaxe|diamond pickaxe]]: | **To summon an unbreakable [[Minecraft:Diamond Pickaxe|diamond pickaxe]]: | ||
***<code><nowiki> summon item ~ ~ ~ {Item:{id:"minecraft:diamond_pickaxe",count:1,components:{"minecraft:unbreakable":{}}}}</nowiki></code> | ***<code><nowiki> summon item ~ ~ ~ {Item:{id:"minecraft:diamond_pickaxe",count:1,components:{"minecraft:unbreakable":{}}}}</nowiki></code> | ||
** To summon a spider jockey: | ** To summon a [[Minecraft:spider jockey]]: | ||
***<code>summon spider ~ ~ ~ {Passengers:[{id:"minecraft:skeleton",HandItems:[{id:"minecraft:bow",count:1}]}]}</code> | ***<code>summon spider ~ ~ ~ {Passengers:[{id:"minecraft:skeleton",HandItems:[{id:"minecraft:bow",count:1}]}]}</code> | ||
** To summon an evoker rotated -90° to face east without AI: | ** To summon an [[Minecraft:evoker]] rotated -90° to face east without AI: | ||
*** <code>summon evoker ~ ~ ~ {Rotation:[-90f,0f],NoAI:1}</code> | *** <code>summon evoker ~ ~ ~ {Rotation:[-90f,0f],NoAI:1}</code> | ||
** To summon a [[Minecraft:villager]] that trades 1 dirt block in exchange for 5 diamonds: | ** To summon a [[Minecraft:villager]] that trades 1 dirt block in exchange for 5 diamonds: | ||
***<code><nowiki>summon villager ~ ~ ~ {Offers:{Recipes:[{buy:{id:"minecraft:dirt",count:1},sell:{id:"minecraft:diamond",count:5},rewardExp:false}]}}</nowiki></code> | ***<code><nowiki>summon villager ~ ~ ~ {Offers:{Recipes:[{buy:{id:"minecraft:dirt",count:1},sell:{id:"minecraft:diamond",count:5},rewardExp:false}]}}</nowiki></code> | ||
** To summon a baby [[Minecraft:zombie]] that has the Speed II mob effect with infinite duration: | ** To summon a baby [[Minecraft:zombie]] that has the Speed II [[Minecraft:mob effect]] with infinite duration: | ||
***<code>summon zombie ~ ~ ~ {IsBaby:true,active_effects:[{id:"minecraft:speed",amplifier:1b,duration:-1,show_particles:true}]}</code> | ***<code>summon zombie ~ ~ ~ {IsBaby:true,active_effects:[{id:"minecraft:speed",amplifier:1b,duration:-1,show_particles:true}]}</code> | ||
** 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: | ** To summon a glowing [[Minecraft:Primed TNT]] 5 blocks forward, that will explode in 30 seconds but will not deal any damage to blocks or entities: | ||
***<code>summon tnt ^ ^ ^5 {Glowing:true,fuse:600s,explosion_power:0.0f}</code> | ***<code>summon tnt ^ ^ ^5 {Glowing:true,fuse:600s,explosion_power:0.0f}</code> | ||
* ''Bedrock Edition'': | * ''Bedrock Edition'': | ||
** To summon a patrol captain pillager at the current position: | ** To summon a [[Minecraft:patrol]] captain pillager at the current position: | ||
*** <code>summon pillager ~ ~ ~ ~ ~ minecraft:spawn_as_patrol_captain</code> | *** <code>summon pillager ~ ~ ~ ~ ~ minecraft:spawn_as_patrol_captain</code> | ||
** To summon a dolphin with the name "Dolphin" in a golden color: | ** To summon a [[Minecraft:dolphin]] with the name "Dolphin" in a golden color: | ||
*** <code>summon dolphin §6Dolphin ~ ~ ~</code> | *** <code>summon dolphin §6Dolphin ~ ~ ~</code> | ||
** To summon a [[Minecraft:boat]] rotated 180 degrees: | ** To summon a [[Minecraft:boat]] rotated 180 degrees: | ||
| Line 108: | Line 108: | ||
==History== | ==History== | ||
{{ | {{Expand section}} | ||
===''Java Edition''=== | ===''Java Edition''=== | ||
{{HistoryTable | {{HistoryTable | ||
|{{ | |{{HistoryLine|java}} | ||
|{{HistoryLine||1.7.2|dev=13w36a|Added {{ | |{{HistoryLine||1.7.2|dev=13w36a|Added {{cmd|summon|link=none}}.}} | ||
|{{HistoryLine||1.8|dev=14w30a|{{ | |{{HistoryLine||1.8|dev=14w30a|{{cmd|summon|link=none}} can now spawn [[Minecraft:lightning]].}} | ||
|{{HistoryLine||1.16|dev=20w06a|{{ | |{{HistoryLine||1.16|dev=20w06a|{{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|{{cmd|summon|link=none}} now gives permission to summon [[Minecraft:Fireball]].}} | ||
|{{HistoryLine||1.19.3|dev=22w42a|{{ | |{{HistoryLine||1.19.3|dev=22w42a|{{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.}}}} | ||
===''Bedrock Edition''=== | ===''Bedrock Edition''=== | ||
{{HistoryTable | {{HistoryTable | ||
|{{ | |{{HistoryLine|pocket alpha}} | ||
|{{HistoryLine||v0.16.0|dev=build 1|Added {{ | |{{HistoryLine||v0.16.0|dev=build 1|Added {{cmd|summon|link=none}}.}} | ||
|{{ | |{{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 {{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 {{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.}} | ||
|{{ | |{{HistoryLine||1.19.80|dev=Preview 1.19.80.20|Added <code>facing</code> argument.}} | ||
}} | }} | ||
| Line 134: | Line 134: | ||
== Navigation == | == Navigation == | ||
{{ | {{Navbox commands}} | ||
de:Befehl/summon | [[Minecraft:de:Befehl/summon]] | ||
es:Comandos/summon | [[Minecraft:es:Comandos/summon]] | ||
fr:Commandes/summon | [[Minecraft:fr:Commandes/summon]] | ||
ja:コマンド/summon | [[Minecraft:ja:コマンド/summon]] | ||
uk:Команди_консолі/summon | [[Minecraft:uk:Команди_консолі/summon]] | ||
pt:Comandos/summon | [[Minecraft:pt:Comandos/summon]] | ||
ru:Команды консоли/summon | [[Minecraft:ru:Команды консоли/summon]] | ||
zh:命令/summon | [[Minecraft:zh:命令/summon]] | ||
Latest revision as of 11:05, 6 May 2026
Summons an Minecraft: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
- Specifies the entity to be summoned.
- Template:Arg desc
- Template:IN, player and Minecraft:fishing bobber entity cannot be summoned. Commands trying to summon them always fail.
- Template:IN, 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.
- Specifies the position to summon the entity. If not specified, defaults to the position of the command's execution.
- Template:Arg desc
Template:El: Template:Argument
- Specifies the data tag for the entity, this can include any NBT in Entity format.
- Template:Arg desc
Template:El: Template:Argument and Template:Argument
- Specifies the rotation of the summoned entity.
- Template:Arg desc
Template:El: Template:Argument
- Specifies the entity to make the summoned entity facing to.
- Template:Arg desc
Template:El: Template:Argument
- Specifies the coordinates to make the summoned entity facing to.
- Template:Arg desc
Template:El: Template:Argument
- Specifies the in-game event for the entity. Should be a Minecraft:spawn event (event name for entities in behavior pack).
- Template:Arg desc
Template:El: Template:Argument
- Specifies the name of the entity.
- Template:Arg desc
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
Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table
Examples
- To summon lightning 10 blocks west of the current position of the executing player:
summon lightning_bolt ~-10 ~ ~
- Java Edition:
- To summon a Minecraft:charged creeper at the current position named "Powered Creeper":
summon creeper ~ ~ ~ {powered:true,CustomName:'"Powered Creeper"'}- NOTE: CustomName is a Minecraft:raw JSON text.
- To summon an unbreakable diamond pickaxe:
summon item ~ ~ ~ {Item:{id:"minecraft:diamond_pickaxe",count:1,components:{"minecraft:unbreakable":{}}}}
- To summon a Minecraft:spider jockey:
summon spider ~ ~ ~ {Passengers:[{id:"minecraft:skeleton",HandItems:[{id:"minecraft:bow",count:1}]}]}
- To summon an Minecraft: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 Minecraft: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 Minecraft: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 Minecraft:charged creeper at the current position named "Powered Creeper":
- Bedrock Edition:
- To summon a Minecraft:patrol captain pillager at the current position:
summon pillager ~ ~ ~ ~ ~ minecraft:spawn_as_patrol_captain
- To summon a Minecraft: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 Minecraft:patrol captain pillager at the current position:
History
Java Edition
Bedrock Edition
External links
Minecraft:de:Befehl/summon Minecraft:es:Comandos/summon Minecraft:fr:Commandes/summon Minecraft:ja:コマンド/summon Minecraft:uk:Команди_консолі/summon Minecraft:pt:Comandos/summon Minecraft:ru:Команды консоли/summon Minecraft:zh:命令/summon