指令/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

指定要被傳送到的座標。

必須為三維座標，元素為浮點數。允許波浪號與脫字號標記。

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

指定要被傳送到的實體。

必須為玩家名、目標選擇器或UUID^[僅Java版]。在Java版中，目標選擇器只允許1個實體。

Java版：<rotation>：rotation
基岩版：yRot: value：RelativeFloat、xRot: value：RelativeFloat

指定實體傳送後的旋轉角度。

必須為兩個倍精度浮點數^[僅Java版]或單精度浮點數^{[僅基岩版]}組成的朝向，分別表示繞Y軸旋轉和繞X軸旋轉，以度為單位。

繞Y軸旋轉時，-180.0表示北，-90.0表示東，0.0表示南，90.0表示西。
繞X軸旋轉時，豎直上方為-90.0，至豎直下方90.0。

波浪號將相對於執行者進行旋轉。

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

指定實體傳送後朝向的座標。

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

指定實體傳送後朝向的實體。

必須為玩家名、目標選擇器或UUID^[僅Java版]。

Java版：<facingAnchor>：entity_anchor

指定實體傳送後應朝向實體的眼睛還是足部。如果未指定，預設為眼睛。在基岩版中，總是朝向眼睛。

必須為eyes或feet。

基岩版：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`為真且目標位置被阻擋	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`的語法，並且指令現在能將實體傳送至其他維度中。
攜帶版Alpha
0.16.0	build 1	加入了`/tp`。
?		加入了`facing`模式。
?		加入了`checkForBlocks: Boolean`參數。
基岩版
?		`/teleport`能指定的座標最大值從999,999,999被縮減為30,000,000。
?		試圖傳送到大於最大座標的位置不再輸出一個錯誤資訊。
1.19.40	1.19.40.23	現在開啟實驗性玩法後，`/teleport`指令能將實體傳送至其他維度中。
1.19.50	1.19.50.23	`/teleport`指令將實體傳送至其他維度的特性不再屬於實驗性玩法。
1.19.70	1.19.70.20	`/teleport`指令的旋轉角度現在相對於指令執行者，而不是目標。

指令

語言

Minecraft Wiki