Commands/tp

tp

Restrictions	Operator
First introduced	Java Edition Alpha v1.0.16_01 PE Alpha 0.16.0 (PE Alpha 0.16.0 build 1)

This article is about the /tp command before 1.13. For the main command in 1.13, see ../teleport.

Teleports entities (players, mobs, items, etc.).

In Java Edition (prior to 1.13), the primary difference between this command and the /teleport command is that /tp uses coordinates relative to the teleported targets, while /teleport uses coordinates relative to the command's execution. In Bedrock Edition and Java Edition 1.13, /teleport is merely a synonym for /tp.

Although most commands can affect chunks that have already been generated, /tp can send entities into chunks that have yet to be generated. If this happens to a player, then the chunks around and including that player's destination are newly generated.

Syntax

• Java Edition

tp <destination>

tp <location> [<rotation>]

tp <targets> <destination>

tp <targets> <entity>

tp <targets> <location> facing <facingLocation>

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

tp <targets> <location> [<rotation>]

• Bedrock Edition

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

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

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

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

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

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

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

tp <destination: target> [checkForBlocks: Boolean]

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

Arguments

target player (BE: victim: target) (optional)

Specifies the entity(s) to be teleported. Must be either a player name or a target selector. If not specified, defaults to the player who executed the command. Not optional in command blocks.

destination player (BE: destination: target)

Specifies the entity to teleport the target(s) to. Must be either a player name or a target selector.

x y z (BE: destination: x y z)

Specifies the coordinates to teleport the target(s) to. x and z must fall within the range -30,000,000 to 30,000,000 (exclusive, without the commas), and y must be within the range -4096 to 4096, inclusive. May use tilde notation to specify a position relative to the target's current position‌^{[Java Edition only]} – an exception to tilde notation's usual rule of being relative to the executor of the command. /teleport can be used to teleport relative to executor of the command.

yaw (BE: yRot: value) (optional)

Specifies the horizontal rotation (-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). Tilde notation can be used to specify a rotation relative to the target's previous rotation.

pitch (BE: xRot: value) (optional)

Specifies the vertical rotation (-90.0 for straight up to 90.0 for straight down). Tilde notation can be used to specify a rotation relative to the target's previous rotation.

(BE: checkForBlocks: Boolean) (optional) ‌^{[Bedrock Edition only]}

If set to true, teleports the entity only if the entity 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 player).

Result

Fails if the arguments are not specified correctly, if target player fails to resolve to one or more entities (named players must be online), if destination player fails to resolve to a single entity (a named player must be online), or if checkForBlocks ‌^{[Bedrock Edition only]} is true and the destination is obscured. Fails individually for each entity referenced by target player that is not in the same dimension as the destination player ‌^{[Java Edition only]}, if specified.

On success, teleports the targets to the specified destination.

Examples

To teleport all players to Steve: tp @a Steve

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

To teleport the executing entity to X=100 and Z=100, but three blocks above their current position: tp 100 ~3 100

To rotate the nearest player 10 degrees to the right without changing their position: tp @p ~ ~ ~ ~10 ~ (BE: execute @p[rm=0.01] ~ ~ ~ tp ~ ~ ~ ~10 ~)

When used via the execute command, it can be used to teleport an entity between the Overworld, the Nether and the End:

To teleport the executing entity to the same coordinates, but in the Nether: execute as @s in minecraft:the_nether run tp ~ ~ ~

To teleport all players to X=84 Y=57 Z=79 in the End: execute as @a in minecraft:the_end run tp 84 57 79

To teleport Steve to X=251 Y=64 Z=−160 in the Overworld: execute as Steve in minecraft:overworld run tp 251 64 -160

History

Java Edition Classic
0.0.15a (Multiplayer Test 3)					Added /tp.
Java Edition Indev
0.31					Removed all commands.
Java Edition Alpha
v1.0.16_01					Re-added /tp.
Java Edition
1.8		14w03a			Added rotation arguments to /tp.
1.9.3		pre1			/tp no longer teleports the player to a y-coordinate outside the range -512 to 512.
1.10		16w21b			The y-coordinate range of /tp is increased to −4096 to 4096.
Pocket Edition Alpha
0.16.0		build 1			Added /tp.

Commands

View at: Template:Commands/content [edit]