/teleport

/teleport

Aliases	/tp
Permission level required	2 ‌ 1 ‌
Restrictions	Cheat only‌

{
    "title": "<code>/teleport</code>",
    "rows": [
        {
            "field": "<!-- Command --><code ><span>/tp</span></code><!-- /Command -->",
            "label": "Aliases"
        },
        {
            "field": "\n* 2 ‌<sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Java Edition\">(link to Java Edition article, displayed as JE)  only</span></i>]</sup>\n* 1 ‌<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 Permission level article, displayed as Permission level<br>required)"
        },
        {
            "field": "(link to Options 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": []
}

Teleports entities (players, mobs, etc.).

Although most commands can affect only chunks that have already been generated, /teleport can send entities into chunks that have yet to be generated. Right before teleporting, the game generates the destination chunk.

Syntax

• Java Edition

teleport <destination>

teleport <targets> <destination>

Teleports the executor or the specified entity(s) to the position of an entity, and makes its rotation the same as the specified entity's.

teleport <location>

Teleports the executor to a certain position (and changes its rotation to the command's execution rotation).

teleport <targets> <location>

Teleports the entity(s) to a certain position (without changing their rotation).

teleport <targets> <location> <rotation>

teleport <targets> <location> facing <facingLocation>

teleport <targets> <location> facing entity <facingEntity> [<facingAnchor>]

Teleports the entity(s) to a certain position and changes their rotation to the specified rotation.

• Bedrock Edition

teleport <destination: target>

teleport <victim: target> <destination: target> [checkForBlocks: Boolean]

Teleports the executor or the specified entity(s) to the position of an entity, and makes it face horizontally, and make its horizontal rotation the same as the specified entity's.

teleport <destination: x y z> [checkForBlocks: Boolean]

teleport <victim: target> <destination: x y z> [checkForBlocks: Boolean]

Teleports the executor or the specified entity(s) to a certain position (without changing its rotation).

teleport <destination: x y z> [yRot: value] [xRot: value] [checkForBlocks: Boolean]

teleport <destination: x y z> facing <lookAtPosition: x y z> [checkForBlocks: Boolean]

teleport <destination: x y z> facing <lookAtEntity: target> [checkForBlocks: Boolean]

teleport <victim: target> <destination: x y z> [yRot: value] [xRot: value] [checkForBlocks: Boolean]

teleport <victim: target> <destination: x y z> facing <lookAtPosition: x y z> [checkForBlocks: Boolean]

teleport <victim: target> <destination: x y z> facing <lookAtEntity: target> [checkForBlocks: Boolean]

Teleports the executor or the specified entity(s) to a certain position and changes their rotation to the specified rotation.

Arguments

JE: <targets>: entity
BE: victim: target: CommandSelector<Actor>

Specifies the entity(s) to be teleported. If not specified, defaults to the command's executor.

Must be a player name, a target selector or a UUID‌.

JE: <location>: vec3
BE: destination: x y z: CommandPositionFloat

Specifies the coordinates to teleport the target(s) to.

Must be three-dimensional coordinates with double-precision floating-point number‌ or single-precision floating-point number‌ elements. Accepts tilde and caret notations.

JE: <destination>: entity
BE: destination: target: CommandSelector<Actor>

Specifies the entity to teleport the target(s) to.

Must be a player name, a target selector or a UUID‌. In Java Edition, the target selector must be in single type.

JE: <rotation>: rotation
BE: yRot: value: RelativeFloat and <xRot: value>: RelativeFloat

Specifies the rotation.

Must be a rotation consisting of two double‌ or 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.

JE: <facingLocation>: vec3
BE: lookAtPosition: x y z: CommandPositionFloat

Specifies the coordinates to make the target(s) facing to.

Must be three-dimensional coordinates with double-precision floating-point number‌ or single-precision floating-point number‌ elements. Accepts tilde and caret notations.

JE: <facingEntity>: entity
BE: lookAtEntity: target: CommandSelector<Actor>

Specifies the entity to make the target(s) facing to.

Must be a player name, a target selector or a UUID‌.

JE: <facingAnchor>: entity_anchor

Specifies whether the entity'eyes or feet to make the target(s) facing to. If not specified, defaults to feet. In Java Edition, the anchor of the targets can be changed with /execute anchored. In Bedrock Edition, always facing the entity's feet from the targets' feet.

Must be either eyes or feet.

BE: checkForBlocks: Boolean: enum

Must be a [Boolean]Boolean (either true or false).

If set to true, teleports the target(s) only if the target(s) would not collide with a block it cannot be inside (Note: this allows teleporting into flowers as well as midair). If false or not specified, the default behavior applies (do no check; just teleport the target(s)).

Result

Command	Trigger	Java Edition	Bedrock Edition
Any	The command is incomplete, or any argument is not specified correctly.	Unparseable	Unparseable
	<targets> or player: target fails to resolve to one or more entities (named players must be online).	Failed	Failed
	<destination>, <facingEntity>, destination: target, or lookAtEntity: target fails to resolve to a single entity (named player must be online).
	Destinated position's <x> or <z> exceeds the range of [-30000000, 30000000), or <y> exceeds the range of [-20000000, 20000000).		Successful
	checkForBlocks: Boolean is true and the specified position is obscured.	N/A	Failed
	Otherwise	Successful

Output

Command	Edition	Situation	Success Count	/execute store success ...	/execute store result ...
Any	Java Edition	On fail	0	0	0
		On success	1	1	the number of the specified entities
	Bedrock Edition	On fail	0	N/A	N/A
/teleport <destination: x y z> ...		On success	1	N/A	N/A
/teleport <victim: target> <destination: x y z> ...		On success	the number of targeted victim entities	N/A	N/A
/teleport <destination: target> ...		On success	2	N/A	N/A
/teleport <victim: target> <destination: target> ...		On success	the number of victims plus 1	N/A	N/A

Examples

• To teleport the executing player to Alice: teleport Alice

• To teleport all players to the executing player: teleport @a @s

• To teleport the executing player to x=100 and z=100, but three blocks above their current position: teleport 100 ~3 100
• To teleport the executing player 1 block forward teleport ^ ^ ^1

• To rotate the nearest player 10 degrees to the right without changing their position: execute as @p at @s run teleport @s ~ ~ ~ ~10 ~

• When used via the execute command, can teleport between the Overworld, the Nether and the End:
  • To teleport the executing player to the same coordinates, but in the Nether:
    • execute in minecraft:the_nether run teleport ~ ~ ~‌
    • execute in nether run teleport ~ ~ ~‌
  • To teleport all players to x=84 y=57 z=79 in the End:
    • execute as @a in minecraft:the_end run teleport 84 57 79‌
    • execute as @a in the_end run teleport 84 57 79‌
  • To teleport Alex to x=251 y=64 z=-160 in the Overworld:
    • execute as Alex in minecraft:overworld run teleport 251 64 -160‌
    • execute as Alex in overworld run teleport 251 64 -160‌

History

[hide]Java Edition
1.10			pre1				Added /teleport, which is like /tp, except that the target parameter is mandatory, the 'teleport to other player' usage is unavailable, and the use of relative coordinates is relative to the executor of the command, rather than relative to the target.
1.13			17w45a				/tp is no longer different from /teleport now, and became an alias of /teleport.
			18w01a				Added facing to /teleport, which causes the target entity to face an entity or a location.
			18w02a				/teleport has been simplified a bit and players can now teleport to entities in other dimensions.
1.16			20w06a				/teleport now cannot teleport an entity to a position where <x> or <z> exceeds the range of [-30000000, 30000000), or <y> exceeds the range of [-20000000, 20000000)
[hide]Pocket Edition Alpha
v0.16.0			build 1				Added /teleport.
							The coordinates have a maximum of 999,999,999 althrough it's possible to teleport beyond the maximum by using relative coordinates.
[hide]Bedrock Edition
1.2.0			beta 1.2.0.2				Added facing mode.
							The maximum coordinates for /teleport have been increased from 999,999,999 to ~3.402824e+38 (2128).
1.2.5			beta 1.2.5.15				The maximum coordinates for /teleport have been reduced to 30,000,000.
							Attempting to teleport beyond the maximum coordinates no longer outputs an error message.
							Exceeding the maximum coordinates is no longer possible.
1.13.0			beta 1.13.0.13				Added checkForBlocks: Boolean.
1.19.40			Preview 1.19.40.23				Players can now teleport to entities in other dimensions, with the "Upcoming Creator Features" experimental toggle enabled.
1.19.50			Preview 1.19.50.23				Teleporting to entities in other dimension no longer requires the "Upcoming Creator Features" experimental toggle to be enabled.
1.19.70			Preview 1.19.70.20				Rotation in the teleport command is now relative to the executor of the command instead of the target. Old usage of rotations in commands remain relative to the target mob for backward compatibility.