指令/teleport

teleport

別名	/tp
限制條件	是操作員
加入版本	1.10（1.10-pre1） PE Alpha 0.16.0（攜帶版Alpha 0.16.0 build 1）

傳送實體（玩家、生物、物品等）。

大多數指令只能影響已經生成的區塊，但是/teleport可以將實體傳送到尚未生成的區塊中。若被傳送的目標是玩家，則傳送後玩家所在的區塊及附近的區塊會自動開始生成。

語法

• Java版

teleport [目標實體] [目的地實體]

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

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

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

• 基岩版

teleport <目的地：目标>

teleport <目的地：x y z> [y旋转角度：角度] [x旋转角度：角度]

teleport <传送目标：目标> <目的地：目标>

teleport <传送目标：目标> <目的地：x y z> [y旋转角度：角度] [x旋转角度：角度]

teleport <传送目标：目标> <目的地：x y z> facing <指定朝向坐标>

teleport <传送目标：目标> <目的地：x y z> facing <指定朝向实体>

參數

目標實體（基岩版：傳送目標：目標）

指定要傳送的實體。必須是玩家名稱或目標選擇器。

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）。可使用波浪號指定基於當前旋轉角度的相對偏移。

效果

指令	觸發條件	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)：tp @s 0 64 0或tp 0 64 0
• 將自己向上移動3格：tp @s ~ ~3 ~或tp ~ ~3 ~
• 將自己向前移動3格：tp @s ^ ^ ^3或tp ^ ^ ^3‌‌^[僅Java版]
• 將所有實體向上移動3格：execute as @e at @s run tp ~ ~3 ~‌‌^[僅Java版]
• 將所有實體向各自前方移動3格：execute as @e at @s run tp ^ ^ ^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 [編輯]