Teleport

Teleport the action's targeted entity with absolute coordinates, coordinates relative to its current location, or a named destination.

Coordinate destinations

All three coordinate axes are required. Numeric values are absolute and remain compatible with existing configurations.

teleport:
  x: 100
  y: 64
  z: -50

Prefix a quoted coordinate with ~ to make it relative to the entity being teleported. "~" keeps the current coordinate, while "~10" adds 10 and "~-2.5" subtracts 2.5.

teleport:
  x: "~10"
  y: "~"
  z: "~-2.5"

Absolute and relative axes can be mixed:

teleport:
  x: 100
  y: "~5"
  z: "~-2"

Relative coordinates always use the current location of the targeted entity, not the player who triggered the action. Blank, malformed, NaN, and infinite values are rejected.

Named destinations

Use destination instead of x, y, and z. Coordinates and a named destination cannot be combined.

World spawn

teleport:
  destination: world_spawn

world_spawn uses the targeted entity's current world. Set world to use another loaded world's spawn:

teleport:
  destination: world_spawn
  world: "world_nether"

Player respawn

teleport:
  destination: respawn

respawn uses the triggering player's respawn location, including beds and respawn anchors. If the player has no valid respawn location, it falls back to the configured world's spawn, or the player's current-world spawn when world is omitted.

The action still teleports the targeted entity. The triggering player is used only to find the respawn location.

Optional parameters

yaw and pitch

Absolute rotation values. With coordinates, omitted values preserve the targeted entity's current rotation. With a named destination, omitted values preserve that destination's rotation.

teleport:
  destination: respawn
  yaw: 90.0
  pitch: 0.0

world

With coordinates or world_spawn, defaults to the targeted entity's current world. With respawn, it is used only as the fallback world when the player has no respawn location. A configured world must be loaded and exist.