命令/teleport

teleport

别名

/tp

需要的权限等级

Java版：2
基岩版：1

限制条件

启用作弊^{[仅基岩版]}

传送实体（玩家、生物等）到指定的地点，并修改其旋转角度。

不像大多数只能影响已经生成的区块的命令，/teleport可以将实体传送到尚未生成的区块中，传送前游戏会生成目标位置所在区块。

语法[编辑 | 编辑源代码]

Java版

teleport <destination>

teleport <targets> <destination>

将执行者或指定的实体传送到另一个实体所在的位置，并使其旋转角度与该实体一致。

teleport <location>

将执行者传送到指定的坐标，并使其旋转角度与命令执行角度一致。

teleport <targets> <location>

将指定的实体传送到一个确定的坐标位置，但不会修改其旋转角度。

teleport <targets> <location> <rotation>

teleport <targets> <location> facing <facingLocation>

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

将指定的实体传送到一个确定的坐标位置，并使其旋转角度与指定的一致。

基岩版

teleport <destination: target> [checkForBlocks: Boolean]

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

将执行者或指定的实体传送到另一个实体所在的位置，并使其水平旋转角度与该实体一致，视角水平（垂直旋转角度为零）。

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

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

将指定的实体传送到一个确定的坐标位置，但不会修改其旋转角度。

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]

将指定的实体传送到一个确定的坐标位置，并使其旋转角度与指定的一致。

参数[编辑 | 编辑源代码]

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

指定要被传送的实体。如果未指定，默认为命令执行者。

必须为玩家名、目标选择器或UUID^[仅Java版]。

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

指定要被传送到的坐标。

必须为三维坐标，元素为双精度^[仅Java版]或单精度^{[仅基岩版]}浮点数。允许相对坐标（~ ~ ~）或局部坐标（^ ^ ^）。

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

指定要被传送到的实体。

必须为玩家名、目标选择器或UUID^[仅Java版]。在Java版中，目标选择器必须为单一数量，否则此命令将无法解析。

JE：<rotation>：rotation
BE：yRot: value：RelativeFloat、xRot: value：RelativeFloat

指定实体传送后的旋转角度。

必须由两个双精度浮点数^[仅Java版]或单精度浮点数^{[仅基岩版]}组成，分别表示绕Y轴旋转和绕X轴旋转，以度为单位。分别对应实体数据

Rotation的两个元素。

绕Y轴旋转时，-180.0表示北，-90.0表示东，0.0表示南，90.0表示西。
绕X轴旋转时，竖直上方为-90.0，至竖直下方90.0。

加上波浪号前缀将相对于执行朝向进行旋转。

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

指定实体传送后朝向的坐标。

必须为三维坐标，元素为双精度^[仅Java版]或单精度^{[仅基岩版]}浮点数。允许相对坐标（~ ~ ~）或局部坐标（^ ^ ^）。

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

指定实体传送后朝向的实体。

必须为玩家名、目标选择器或UUID^[仅Java版]。

JE：<facingAnchor>：entity_anchor

指定实体传送后应朝向实体的眼睛还是足部。如果未指定，默认为眼睛。在基岩版中，总是朝向眼睛。

必须为实体锚点（eyes或feet）。

BE：checkForBlocks: Boolean：bool

必须为

布尔值（true或false）。

如果为true，只当目的地不会被方块碰撞箱阻挡时，传送才会生效。如果为false或未指定，则不进行该检查，直接进行传送。

结果[编辑 | 编辑源代码]

命令	触发条件	Java版	基岩版
任意	命令不完整或参数未正确指定	无法解析	无法解析
	`<targets>`或`victim: target`未能选中至少一个实体（指定的玩家必须在线上）	执行失败	执行失败
	`<destination>`、`<facingEntity>`、`destination: target`或`lookAtEntity: target`未能选出单个实体（指定的玩家必须在线上）		执行失败
	目的地坐标的<x>或<z>超出[-30000000, 30000000)或<y>超出(-20000000, 20000000]		执行成功
	`checkForBlocks: Boolean`为`true`且目标位置被方块阻挡	N/A	执行失败
	不符合以上所有条件	执行成功

输出[编辑 | 编辑源代码]

命令	版本	条件	成功次数	`/execute store success ...`	`/execute store result ...`
任意	Java版	执行失败	0	0	0
任意	Java版	执行成功	1	1	传送的实体数目
任意	基岩版	执行失败	0	N/A	N/A
`/teleport <destination: x y z> ...`		执行成功	1	N/A	N/A
`/teleport <victim: target> <destination: x y z> ...`		执行成功	传送目标的数目	N/A	N/A
`/teleport <destination: target> ...`		执行成功	2	N/A	N/A
`/teleport <victim: target> <destination: target> ...`		执行成功	传送目标的数目+1	N/A	N/A

示例[编辑 | 编辑源代码]

将执行实体传送到Alice：teleport Alice
将所有玩家传送到命令执行实体：teleport @a @s
将执行实体传送到x=100、z=100的位置，且高于其现在所在位置三格方块：teleport 100 ~3 100
使最近玩家向右转向10度，但不改变他的位置：execute as @p at @s run teleport @s ~ ~ ~ ~10 ~
通过/execute in命令，还可以将实体传送到指定的维度中（如主世界、下界和末地）。
- 将执行实体传送到下界中坐标与其目前所在主世界坐标相同的位置（X和Z坐标将自动除以8）：
  - execute in minecraft:the_nether run teleport ~ ~ ~^[仅Java版]
  - execute in nether run teleport ~ ~ ~^{[仅基岩版]}
- 将所有玩家传送到末地中x=84、y=57、z=79的位置：
  - execute as @a in minecraft:the_end run teleport 84 57 79^[仅Java版]
  - execute as @a in the_end run teleport 84 57 79^{[仅基岩版]}
- 将Alice传送到主世界中x=251、y=64、z=-160的位置：
  - execute as Alice in minecraft:overworld run teleport 251 64 -160^[仅Java版]
  - execute as Alice in overworld run teleport 251 64 -160^{[仅基岩版]}

历史[编辑 | 编辑源代码]

Java版
1.10	pre1	加入了`/teleport`，其与`/tp`相似，但`/teleport`中一定要指定将被传送的实体，而“传送至其他玩家”的用法是不可用的，并且相对坐标的使用是相对于命令的执行位置而言，而不是相对于目标而言。
1.13	17w45a	`/tp`现在用法与`/teleport`没有任何区别，作为`/teleport`的别名。
	18w01a	加入了`facing`模式，用于指定传送后目标的朝向。
	18w02a	简化了`/teleport`的语法，并且命令现在能将实体传送至其他维度中。
1.16	20w06a	`/teleport`现在当目的地坐标的<x>或<z>超出[-30000000, 30000000)或<y>超出(-20000000, 20000000]时不会进行传送。
携带版Alpha
0.16.0	build 1	加入了`/tp`。
?		加入了`facing`模式。
?		加入了`checkForBlocks: Boolean`参数。
基岩版
1.2.5	1.2.5.15	`/teleport`能指定的坐标最大值从999,999,999被缩减为30,000,000。
1.2.5	1.2.5.15	试图传送到大于最大坐标的位置不再输出一个错误信息。
1.13.0	beta 1.13.0.13	加入了`checkForBlocks: Boolean`参数。
1.19.40	1.19.40.23	现在开启实验性玩法后，`/teleport`命令能将实体传送至其他维度中。
1.19.50	1.19.50.23	`/teleport`命令将实体传送至其他维度的特性不再属于实验性玩法。
1.19.70	1.19.70.20	`/teleport`命令的旋转角度现在相对于命令执行者，而不是目标。

导航[编辑 | 编辑源代码]