teleport
|
2[JE only] |
Cheat only[BE only] |
This article is about the command in the current version (since Java Edition 1.13 (17w45a)). For the command in former game versions, see Commands/tp/Before Java Edition 17w45a.
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. If this happens to a player, then the chunks around and including that player's destination are newly generated.
Contents
- 1 Syntax
- 2 Arguments
- 3 Result
- 4 Output
- 5 Examples
- 6 History
Syntax[]
- Java Edition
- Bedrock Edition
Arguments[]
JE:<targets>: entity
BE: victim: target: CommandSelector<Actor>
JE:<location>: vec3
BE: destination: x y z: CommandPositionFloat
JE:<destination>: entity
BE: destination: target: CommandSelector<Actor>
JE: <rotation>: rotation
BE: yRot: value: RelativeFloat and <xRot: value>: RelativeFloat
- 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.
JE:<facingLocation>: vec3
BE: lookAtPosition: x y z: CommandPositionFloat
JE:<facingEntity>: entity
BE: lookAtEntity: target: CommandSelector<Actor>
JE: <facingAnchor>: entity_anchor
Specifies whether the entity'eyes or feet to make the target(s) facing to. If not specified, defaults to eyes. In Bedrock Edition, always facing eyes. Must be either eyes or feet.BE: checkForBlocks: Boolean: enum
Must be a 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[]
any | the arguments are 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 | |
On success | Teleports the targets to the specified destination. |
Output[]
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 rotate the nearest player 10 degrees to the right without changing their position:
- execute @p ~ ~ ~ teleport @s ~ ~ ~ ~10 ~[Bedrock Edition only]
- execute as @p at @s run teleport @s ~ ~ ~ ~10 ~[Java Edition only]
- In Java Edition, 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 ~ ~ ~
- 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
- To teleport Alice to x=251 y=64 z=-160 in the Overworld: execute as Alice in minecraft:overworld run teleport 251 64 -160
History[]
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. |
/tp is no longer different from /teleport now, and became an alias of /teleport. |
Added facing to /teleport, which causes the target entity to face an entity or a location. |
/teleport has been simplified a bit and players can now teleport to entities in other dimensions. |
Added /teleport. |
Added facing mode. |
Added checkForBlocks: Boolean. |
The maximum coordinates for /teleport have been reduced from 999,999,999 to 30,000,000. |
Attempting to teleport beyond the maximum coordinates no longer outputs an error message. |
Commands
View at: Template:Commands/content [edit]