手册:/tp

来自Minecraft基岩版开发Wiki
tp
用法旗标
普通命令(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类型,指定要传送到的坐标点。
yRotxRot
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:该响应的状态消息,对于命令响应为该命令的执行反馈文本。

Manual:/clear/response

示例[编辑]

脚本API[编辑]

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

Manual:/someCommand/response

示例[编辑]

历史[编辑]

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

画廊[编辑]

Template:Commands