Commands/summon

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> [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[]

JE: <entity>: resource
BE: entityType: EntityType: enum

Specifies the entity to be summoned.

In Java Edition, must be an existing registered resource location in minecraft:entity_type registry. In Bedrock Edition, must be an ID of an entity type (without namespace).

JE: <pos>: vec3
BE: spawnPos: x y z: CommandPositionFloat

Specifies the position to summon the entity. If not specified, defaults to the position of the command's execution.

Must be a three-dimensional coordinates with floating-point number elements. Accepts tilde and caret notations.

JE: <nbt>: nbt_compound_tag

Specifies the data tag for the entity.

Must be a compound NBT in SNBT format.

BE: yRot: value: RelativeFloat and xRot: value: RelativeFloat

Specifies the rotation of the summoned entity.

Must be a rotation with float number elements, including yaw and pitch, measured in degrees.

For the horizontal rotation (yaw), -180.0 for due north, -90.0 for due east, 0.0 for due south, 90.0 for due west, to 179.9 for just west of due north, before wrapping back around to -180.0.
For the vertical rotation (pitch), -90.0 for straight up to 90.0 for straight down.

Tilde notation can be used to specify a rotation relative to the execution rotation.

BE: lookAtEntity: target: CommandSelector<Actor>

Specifies the entity to make the summoned entity facing to.

Must be a player name or a target selector.

BE: lookAtPosition: x y z: CommandPositionFloat

Specifies the coordinates to make the summoned entity facing to.

Must be a three-dimensional coordinates with floating-point number elements. Accepts tilde and caret notations.

BE: spawnEvent: string: basic_string

Specifies the in-game event for the entity. Should be a spawn event (event name for entities in behavior pack).

Must be a string. And it must be a single word that has no space or a quoted string.

BE: nameTag: string: basic_string

Specifies the name of the entity.

Must be a string. And it must be a single word that has no space or a quoted string.

Result[]

Command	Trigger	Java Edition	Bedrock Edition
any	the arguments are not specified correctly	Unparseable	Unparseable
	specified position is unloaded	Failed	Failed
	trying to summon hostiles in peaceful difficulty.	Successful	Failed
	attempting to summon an entity with a duplicate UUID.	Failed	N/A
	designated position's <x> or <z> exceeds the range of [-30000000, 30000000), or <y> exceeds the range of [-20000000, 20000000)	Failed	Successful
	Otherwise	Successful

Output[]

Command	Edition	Situation	Success Count	`/execute store success ...`	`/execute store result ...`
any	Java Edition	On fail	0	0	0
	Java Edition	On success	1	1	1
	Bedrock Edition	On fail	0	N/A	N/A
	Bedrock Edition	On success	1	N/A	N/A

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:1b,CustomName:'{"text":"Powered Creeper"}'}
  - NOTE: CustomName is a raw JSON text.
- To summon a spider jockey:
  - summon spider ~ ~ ~ {Passengers:[{id:"minecraft:skeleton",HandItems:[{id:"minecraft:bow",Count:1b}]}]}
- To summon a villager that trades 1 dirt block in exchange for 1 diamond:
  - summon villager ~ ~ ~ {Offers:{Recipes:[{buy:{id:dirt,Count:1},sell:{id:diamond,Count:1},rewardExp:false}]}}
Bedrock Edition:
- To summon a patrol captain pillager at the current position:
  - summon pillager ~ ~ ~ minecraft:promote_to_patrol_captain
- To summon a dolphin with the name "Dolphin" in a golden color:
  - summon dolphin §6Dolphin ~ ~ ~
- To summon a red dyable wolf:
  - summon wolf ~ ~ ~ minecraft:on_tame

History[]

This section needs expansion.

You can help by expanding it.

Java Edition
1.7.2	13w36a	Added `/summon`.
1.8	14w30a	`/summon` can now spawn lightning.
1.16	20w06a	`/summon` 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)
1.16	20w11a	`/summon` now gives permission to summon Fireball.
1.19.3	22w42a	`<entity>` now accepts a `resource` argument, instead of `entity_summon`.
Pocket Edition Alpha
v0.16.0	build 1	Added `/summon`.
Bedrock Edition
1.19.40	beta 1.19.40.21	Added new overload to the `/summon` command that adds rotation arguments.
1.19.40	beta 1.19.40.23	Temporarily disabled the rotation for the `/summon` command while a bug is worked on.
1.19.70	beta 1.19.70.23	Re-added the rotation arguments.
1.19.80	beta 1.19.80.20	Added `facing` argument.

Commands