手册:/tp

tp

命令

权限等级

1

命令旗标

用法旗标

普通命令（0）

可见性旗标

可见（0）

同步旗标

同步命令（0）

执行旗标

允许执行（0）

类型旗标

无类型（0）

作弊旗标

作弊命令（0）

游戏内描述

“

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

”

限制条件

无

/tp（或/teleport)命令用于传送实体。

语法

以下是不带有目标选择器的传送命令用法：

传送到一个实体上

tp <destination: target> [checkForBlocks: Boolean]

传送到特定位置上

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

以特定的实体旋转角度传送

tp <destination: x y z> [yRot: value] [xRot: value] [checkForBlocks: Boolean]

tp <destination: x y z> facing <lookAtEntity: target> [checkForBlocks: Boolean]

tp <destination: x y z> facing <lookAtPosition: x y z> [checkForBlocks: Boolean]

以下是带有目标选择器的传送命令用法：

传送到一个实体上

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

传送到特定位置上

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

以特定的实体旋转角度传送

tp <victim: target> <destination: x y z> [yRot: value] [xRot: value] [checkForBlocks: Boolean]

tp <victim: target> <destination: x y z> facing <lookAtEntity: target> [checkForBlocks: Boolean]

tp <victim: target> <destination: x y z> facing <lookAtPosition: x y z> [checkForBlocks: Boolean]

参数

victim

target类型，指定传送哪个实体。

destination

target类型，目标选择器或玩家名，指定要传送到哪个实体的位置上，最多只能为一个实体。

x y z类型，指定要传送到的坐标点。

yRot、xRot

value类型，指定实体传送后的旋转角度。

必须为单精度浮点数组成的朝向，分别表示绕Y轴旋转和绕X轴旋转，以度为单位。

绕Y轴旋转时，-180.0表示北，-90.0表示东，0.0表示南，90.0表示西。

绕X轴旋转时，竖直上方为-90.0，至竖直下方90.0。

lookAtTarget

target类型，目标选择器或玩家名，指定传送后面向哪一个实体，最多只能为一个实体。

lookAtPosition

x y z类型，指定传送后面向哪个坐标。

checkForBlocks

Boolean类型，指定传送时是否检查对应坐标有方块阻挡。如果是true，则有方块阻挡时不会进行传送。默认为false。

效果

命令	触发条件	执行结果
任意	参数未正确指定	失败
	指定的[victim: target]不存在
	[lookAtTarget: target]指定了超过1个的实体
	[checkForBlocks: Boolean]为True且待传送坐标处于未加载区块或被阻挡
	执行成功	将实体以特定旋转角度传送到特定的坐标。

输出

命令	执行结果	成功次数增量
任意	失败	0
/teleport <destination: x y z> ...	成功	1
/teleport <victim: target> <destination: x y z> ...	成功	传送目标的数目
/teleport <destination: target> ...	成功	2
/teleport <victim: target> <destination: target> ...	成功	传送目标的数目+1

示例

以下是没有victim: target参数的命令示例：

/tp 0 1 0 - 将命令执行者传送至坐标(0,1,0)。

/tp 0 1 0 true - 将命令执行者传送至坐标(0,1,0)，如果该位置有方块阻挡则阻止传送。

/tp 0 1 0 0 - 将命令执行者传送至坐标(0,1,0)，且看向水平偏转为0的位置。

/tp 0 1 0 ~ 0 - 将命令执行者传送至坐标(0,1,0)，且看向竖直偏转为0的位置。

/tp 0 1 0 90 90 - 将命令执行者传送至坐标(0,1,0)，且看向水平偏转和竖直偏转均为90的位置。

/tp 0 1 0 facing 10 1 10 - 将命令执行者传送至坐标(0,1,0)，且看向(10,1,10)的位置。

/tp 0 1 0 facing @e[type=zombie,c=1] - 将命令执行者传送至坐标(0,1,0)，且看向一只僵尸。

以下是有victim:target参数的命令示例：

/tp @a 0 1 0 - 将所有玩家传送至坐标(0,1,0)。

/tp @e 0 1 0 true - 将所有实体传送至坐标(0,1,0)，如果该位置有方块阻挡则阻止传送。

/tp @p 0 1 0 0 - 将最近玩家传送至坐标(0,1,0)，且看向水平偏转为0的位置。

/tp @r 0 1 0 ~ 0 - 将随机玩家传送至坐标(0,1,0)，且看向竖直偏转为0的位置。

/tp @e[type=zombie] 0 1 0 90 90 - 将所有僵尸传送至坐标(0,1,0)，且看向水平偏转和竖直偏转均为90的位置。

/tp @a[l=10,lm=10] 0 1 0 facing 10 1 10 - 将10级的玩家传送至坐标(0,1,0)，且看向(10,1,10)的位置。

/tp @a[m=survival] 0 1 0 facing @e[type=zombie,c=1] - 将所有生存模式的玩家传送至坐标(0,1,0)，且看向一只僵尸。

响应

WebSocket

• ：根对象
  •  header：报文消息的头。
    •  messagePurpose：该条报文消息的发送目的，对于命令响应恒为commandResponse。
    •  requestId：造成该响应的请求报文的UUID。
    •  version：该报文的版本。
  •  body：报文消息的内容。
    •  statusCode：该响应的状态码。
    •  statusMessage：该响应的状态消息，对于命令响应为该命令的执行反馈文本。

脚本API

主页面：Manual:@minecraft/server.Dimension.runCommand

• ：根对象
  •  statusCode：该响应的状态码。
  •  statusMessage：该响应的状态消息，对于命令响应为该命令的执行反馈文本。

历史

携带版（Alpha）
0.16.0		build 1			加入了/tp命令。
？					加入了facing模式
					加入了checkForBlocks: Boolean参数。
基岩版
？					/teleport能指定的坐标最大值从999,999,999被缩减为30,000,000。
					试图传送到大于最大坐标的位置不再输出一个错误信息。

画廊

• 
  命令/tp的帮助页面。
• 
  命令tp 0 4 0的执行效果，直接传送玩家到（0，4，0）。
• 
  命令tp 10000 40 10000 true的执行效果，因区块未加载而未能传送。
• 
  命令tp 10000 40 10000的执行效果，此时直接传送。
• 
  命令tp @s ~~~ facing @e[type=pig,c=1]的执行效果，传送到原地并面对一只猪。