Commands/tp
< Commands
tp
| Restrictions | |
|---|---|
| First introduced |
Java Edition Alpha v1.0.16_01 |
This article is about the Teleports entities (players, mobs, items, etc.).
In the Java edition, 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, /teleport is merely a synonym for /tp.
Although most commands can only 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 will be 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> [yRot: value] [xRot: value]tp <destination: x y z> facing <lookAtPosition: x y z>tp <destination: x y z> facing <lookAtEntity: target>tp <victim: target> <destination: x y z> [yRot: value] [xRot: value]tp <victim: target> <destination: x y z> facing <lookAtPosition: x y z>tp <victim: target> <destination: x y z> facing <lookAtEntity: target>tp <destination: target>tp <victim: target> <destination: target>
- 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.
/teleportcan be used to teleport relative to executor of the command.
- 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.
- 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.
- 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), or if destination player fails to resolve to a single entity (a named player must be online). Fails individually for each entity referenced by target player that is not in the same dimension as the destination player, if specified.
- On success, teleports the targets to the specified destination.
- Examples
- To teleport yourself to Alice:
tp Alice
- To teleport all players to yourself:
tp @a @p
- To teleport yourself to x=100 and z=100, but three blocks above your current position:
tp 100 ~3 100
- To rotate the nearest player 10 degrees to the right without changing their position:
tp @p ~ ~ ~ ~10 ~
