手冊:/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]的執行效果，傳送到原地並面對一隻豬。