命令/teleport

teleport

别名	/tp
需要的权限等级	op
限制条件	无

传送实体（玩家、生物、物品等）。

大多数命令只能影响已经生成的区块，但是/teleport可以将实体传送到尚未生成的区块中。若被传送的目标是玩家，则传送后玩家所在的区块及附近的区块会自动开始生成。

语法

• Java版

teleport <x> <y> <z>

teleport <目标实体> <x> <y> <z> [<y-旋转角度> <x-旋转角度>]

teleport <目标实体> <x> <y> <z> facing <指定朝向坐标>

teleport <目标实体> <x> <y> <z> facing entity <指定朝向实体> <指定朝向锚>

• 基岩版

teleport <目的地：x y z> [检查方块：布尔值]

teleport <目的地：x y z> [y旋转角度：角度] [x旋转角度：角度] [检查方块：布尔值]

teleport <目的地：x y z> facing <指定朝向坐标：x y z> [检查方块：布尔值]

teleport <目的地：x y z> facing <指定朝向实体：目标> [检查方块：布尔值]

teleport <目的地：目标> [检查方块：布尔值]

teleport <传送目标：目标> <目的地：x y z> [检查方块：布尔值]

teleport <传送目标：目标> <目的地：x y z> [y旋转角度：角度] [x旋转角度：角度] [检查方块：布尔值]

teleport <传送目标：目标> <目的地：x y z> facing <指定朝向坐标：x y z> [检查方块：布尔值]

teleport <传送目标：目标> <目的地：x y z> facing <指定朝向实体：目标> [检查方块：布尔值]

teleport <传送目标：目标> <目的地：目标> [检查方块：布尔值]

参数

目标实体（基岩版：传送目标：目标）

指定要传送的实体。必须是玩家名称或目标选择器。

x y z（基岩版：目的地：x y z）

指定传送的目的地坐标。x 和 z必须是在-30,000,000和30,000,000之间（含，不输入逗号）的整数，且y必须在-4096和4096之间（含）。可以使用波浪号来指定基于命令执行位置的相对坐标（使用/execute来进行基于传送目标当前位置的传送）。

目的地：目标 ^{[仅基岩版]}

指定传送的目的地实体。必须为一个玩家名或目标选择器。

y-旋转角度（基岩版：y-旋转角度：角度）（可选）

指定水平旋转角度（正北方为-180.0，正东为-90.0，正南为0.0，正西为90.0，正北以西为179.9，之后回到-180.0）。可使用波浪号指定基于当前旋转角度的相对偏移。

x-旋转角度（基岩版：x-旋转角度：角度）（可选）

指定垂直旋转角度（竖直上方为-90.0，至竖直下方90.0）。可使用波浪号指定基于当前旋转角度的相对偏移。

指定朝向坐标（基岩版：指定朝向坐标：x y z）

指定使目标传送后应面向的坐标。

指定朝向实体（基岩版：指定朝向实体：目标）

指定使目标传送后应面向的实体。必须是玩家名称或目标选择器。

指定朝向锚^[仅Java版]

指定使目标传送后应面向实体眼睛或脚。若未指定，则默认是眼睛。必须为eyes或feet。

检查方块：布尔值^{[仅基岩版]}

如果设置为true，则仅当目标不与目的地方块的位置发生冲突时才传送（允许传送至花和空气中）；如果设置为false，则无论是否发生冲突，都会传送目标。若未指定，默认为false。

效果

命令	触发条件	Java版	基岩版
任意	参数不正确	无法解析	执行失败
	<目标实体>或传送目标：目标未能解析出至少一个实体（指定的玩家必须在线）	执行失败
	<目的地实体>、<指定朝向实体>或目的地：目标未能解析出单个实体（指定的玩家必须在线）
	目的地坐标<x>或<z>超出[-30000000, 30000000)或<y>超出(-20000000, 20000000]		执行成功
	checkForBlocks: Boolean为真且目标位置被阻挡	N/A	执行失败
	执行成功时	将目标传送至指定位置。

输出

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

示例

• 将自己传送至(0, 64, 0)：teleport @s 0 64 0或teleport 0 64 0
• 将自己向上移动3格：teleport @s ~ ~3 ~或teleport ~ ~3 ~
• 将自己向前移动3格：teleport @s ^ ^ ^3或teleport ^ ^ ^3^[仅Java版]
• 将所有实体向上移动3格：execute as @e at @s run teleport ~ ~3 ~^[仅Java版]
• 将所有实体向各自前方移动3格：execute as @e at @s run teleport ^ ^ ^3^[仅Java版]
• 在Java版中，利用/execute命令可以使玩家在不同维度之间传送。
  • 将自己传送至下界的相同坐标：execute in minecraft:the_nether run teleport ~ ~ ~
  • 将所有玩家传送至末地x=84 y=57 z=79的位置：execute as @a in minecraft: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版
1.10		pre1			加入了/teleport。命令和/tp相似，但目标参数是必需的，而“传送至其他玩家”的用法是不可用的，并且相对坐标的使用是相对于命令的执行者而言，而不是相对于目标而言。
1.13		18w01a			加入了facing参数，用于指定传送后目标的朝向。
		18w02a			简化了/teleport的语法，并且命令现在能将实体传送至其他维度中。
携带版Alpha
0.16.0		build 1			加入了/teleport。

命令

参见：Template:Commands/content [编辑]