Minecraft:Commands/tp/Before Java Edition 17w45a: Difference between revisions
More actions
Fix template calls: add MC/ prefix |
Sync: updated from Minecraft |
||
| Line 1: | Line 1: | ||
{{about|the {{ | {{about|the {{cmd|tp|link=none}} command before [[Minecraft:Java Edition 1.13]]|the main command in Java Edition 1.13 and Bedrock Edition|Commands/teleport}} | ||
{{outdated feature}} | {{move|Commands/tp/Before Java Edition 1.13}} | ||
{{outdated feature|edition=java}} | |||
{{Infobox command | {{Infobox command | ||
|name=tp | |name=tp | ||
| Line 8: | Line 9: | ||
Teleports entities (players, mobs, items, etc.). | Teleports entities (players, mobs, items, etc.). | ||
The primary difference between this command and the {{ | The primary difference between this command and the {{cmd|teleport}} command is that {{cmd|tp|link=none}} uses coordinates relative to the teleported targets, while {{cmd|teleport}} uses coordinates relative to the command's execution. | ||
Although most commands can only affect chunks that have already been generated, {{ | Although most commands can only affect chunks that have already been generated, {{cmd|tp|link=none}} 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 == | |||
: <code>tp <destination player></code> | : <code>tp <destination player></code> | ||
: <code>tp <x> <y> <z> [<yaw> <pitch>]</code> | : <code>tp <x> <y> <z> [<yaw> <pitch>]</code> | ||
| Line 19: | Line 19: | ||
: <code>tp <target player> <x> <y> <z> [<yaw> <pitch>]</code> | : <code>tp <target player> <x> <y> <z> [<yaw> <pitch>]</code> | ||
==Arguments== | == Arguments == | ||
<code><target player></code> | <code><target player></code> | ||
: Specifies the entity(s) to be teleported. Must be a player name, a target selector, or a [[Minecraft:UUID]]. | : Specifies the entity(s) to be teleported. Must be a player name, a [[Minecraft:target selector]], or a [[Minecraft:UUID]]. | ||
: Permits entities other than players. | : Permits entities other than players. | ||
<code><x> <y> <z></code> (BE: <code>destination: x y z</code>) | <code><x> <y> <z></code> (BE: <code>destination: x y z</code>) | ||
: Specifies the coordinates to teleport the target(s) to. <code><x></code> and <code><z></code> must fall within the range -30,000,000 to 30,000,000 (exclusive, without the commas), and <code><y></code> must be within the range -4096 to 4096, inclusive. May use tilde and caret notation to specify a position relative to the target's current position – an exception to tilde notation's usual rule of being relative to the executor of the command. {{ | : Specifies the coordinates to teleport the target(s) to. <code><x></code> and <code><z></code> must fall within the range -30,000,000 to 30,000,000 (exclusive, without the commas), and <code><y></code> must be within the range -4096 to 4096, inclusive. May use [[Minecraft:tilde notation|tilde]] and [[Minecraft:caret notation]] to specify a position relative to the target's current position – an exception to tilde notation's usual rule of being relative to the executor of the command. {{cmd|teleport}} can be used to teleport relative to executor of the command. | ||
<code><destination player></code> | <code><destination player></code> | ||
: Specifies the entity to teleport the target(s) to. Must be a player name, a target selector, or a [[Minecraft:UUID]]. | : Specifies the entity to teleport the target(s) to. Must be a player name, a [[Minecraft:target selector]], or a [[Minecraft:UUID]]. | ||
: Permits entity other than players. | : Permits entity other than players. | ||
| Line 38: | Line 37: | ||
: Tilde notation can be used to specify a rotation relative to the target's previous rotation. | : Tilde notation can be used to specify a rotation relative to the target's previous rotation. | ||
==Result== | == Result == | ||
Fails if the arguments are not specified correctly, if <code><target player></code> fails to resolve to one or more entities (named players must be online), or if <code><destination player></code> fails to resolve to a single entity (a named player must be online). Fails individually for each entity referenced by <code><target player></code> that is not in the same dimension as the <code><destination player></code>, if specified. | Fails if the arguments are not specified correctly, if <code><target player></code> fails to resolve to one or more entities (named players must be online), or if <code><destination player></code> fails to resolve to a single entity (a named player must be online). Fails individually for each entity referenced by <code><target player></code> that is not in the same dimension as the <code><destination player></code>, if specified. | ||
On success, teleports the targets to the specified destination. | On success, teleports the targets to the specified destination. | ||
==Examples== | == Examples == | ||
* To teleport yourself to Alice: <code>tp Alice</code> | * To teleport yourself to Alice: <code>tp Alice</code> | ||
* To teleport all players to yourself: <code>tp @a @s</code> | * To teleport all players to yourself: <code>tp @a @s</code> | ||
| Line 52: | Line 49: | ||
== History == | == History == | ||
{{HistoryTable | {{HistoryTable | ||
|{{ | |{{HistoryLine|java classic}} | ||
|{{HistoryLine||0.0.18a|Added {{ | |{{HistoryLine||0.0.18a|Added {{cmd|teleport|link=none}}.}} | ||
|{{HistoryLine||server 1.7|Added {{ | |{{HistoryLine||server 1.7|Added {{cmd|tp|link=none}}, an alias for {{cmd|teleport|link=none}}.}} | ||
|{{ | |{{HistoryLine|java indev}} | ||
|{{ | |{{HistoryLine||0.31|dev=20091223-0040|Removed all commands.}} | ||
|{{ | |{{HistoryLine|java alpha}} | ||
|{{HistoryLine||v1.0.16_01|Re-added {{ | |{{HistoryLine||v1.0.16_01|Re-added {{cmd|tp|link=none}}.}} | ||
|{{ | |{{HistoryLine|java}} | ||
|{{ | |{{HistoryLine||1.3.1|dev=12w25a|Can now be used to teleport to any coordinates rather than just another player.}} | ||
|{{HistoryLine||1.8|dev=14w03a|Added rotation arguments to {{ | |{{HistoryLine||1.8|dev=14w03a|Added rotation arguments to {{cmd|tp|link=none}}.}} | ||
|{{HistoryLine||1.9.3|dev=pre1|{{ | |{{HistoryLine||1.9.3|dev=pre1|{{cmd|tp|link=none}} no longer teleports the player to a y-coordinate outside the range -512 to 512.}} | ||
|{{HistoryLine||1.10|dev=16w21b|The y-coordinate range of {{ | |{{HistoryLine||1.10|dev=16w21b|The y-coordinate range of {{cmd|tp|link=none}} is increased to −4096 to 4096. | ||
|Now the specified destination is relative to executor of the command, instead of the target's current position.}} | |Now the specified destination is relative to executor of the command, instead of the target's current position.}} | ||
|{{ | |{{HistoryLine|||dev=pre1|Behavior is reverted back to 16w20a and previous versions.}} | ||
|{{HistoryLine||1.13|dev=17w45a|{{ | |{{HistoryLine||1.13|dev=17w45a|{{cmd|tp|link=none}} is no longer different from {{cmd|teleport}} now, and become an alias of {{cmd|teleport}}.}} | ||
}} | }} | ||
== Navigation == | == Navigation == | ||
{{ | {{Navbox commands}} | ||
ja:コマンド/tp/Java Edition 17w45a以前 | [[Minecraft:ja:コマンド/tp/Java Edition 17w45a以前]] | ||
zh:命令/tp/Java版17w45a前 | [[Minecraft:zh:命令/tp/Java版17w45a前]] | ||
Latest revision as of 11:05, 26 April 2026
|
For the {{{Description}}} of the same name, see [[{{{Destination}}}]]. |
Template:Move Template:Outdated feature Template:Infobox command
Teleports entities (players, mobs, items, etc.).
The primary difference between this command and the Template:Cmd command is that Template:Cmd uses coordinates relative to the teleported targets, while Template:Cmd uses coordinates relative to the command's execution.
Although most commands can only affect chunks that have already been generated, Template:Cmd 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
tp <destination player>tp <x> <y> <z> [<yaw> <pitch>]tp <target player> <destination player>tp <target player> <x> <y> <z> [<yaw> <pitch>]
Arguments
<target player>
- Specifies the entity(s) to be teleported. Must be a player name, a Minecraft:target selector, or a Minecraft:UUID.
- Permits entities other than players.
<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 and Minecraft:caret notation to specify a position relative to the target's current position – an exception to tilde notation's usual rule of being relative to the executor of the command. Template:Cmd can be used to teleport relative to executor of the command.
<destination player>
- Specifies the entity to teleport the target(s) to. Must be a player name, a Minecraft:target selector, or a Minecraft:UUID.
- Permits entity other than players.
<yaw> and <pitch>
- Specifies the rotation.
- 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.
- For the horizontal rotation (
- 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 @s - 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 ~
History
Minecraft:ja:コマンド/tp/Java Edition 17w45a以前 Minecraft:zh:命令/tp/Java版17w45a前