Teleporting

modules/teleport.yml

Ten commands, plus the settings that apply to every teleport in the plugin whichever command started it.

Requests#

/tpaccept and /tpdeny answer the most recent request when no name is given. /tpcancel with no name withdraws every request you sent.

requests:
  timeout-seconds: 60

How long a request stays open. Minimum 5.

/tptoggle turns incoming requests down without the sender having to be told twice, and is remembered between sessions. chorus.tpa.toggle.bypass reaches players who have it on.

/tpauto accepts every request the moment it arrives instead of asking, and turns /tptoggle off if it was on. Also remembered between sessions.

/tpaall asks everybody online to come to you. It ships with a 30-second cooldown.

Warmups#

teleport:
  cancel-on-move: true
  cancel-on-damage: true
  warmup-countdown: true

These apply to every warmup, wherever it came from. The length itself is per command:

commands:
  tpaccept:
    warmup-seconds: 5

The warmup on /tpaccept belongs to the player who travels, not to the one who typed the command — which is the sensible way round for a request.

warmup-countdown shows the seconds left in the action bar. A cancelled warmup charges nothing.

chorus.teleport.instant skips every warmup on the server.

Safe landing#

teleport:
  safe-landing: true
  safe-landing-radius: 5

Refuses to drop a player inside a wall, over a void or into lava, looking for somewhere to stand within that many blocks above or below instead. Maximum radius 16.

Turn it off if your warps are deliberately in mid-air — a warp above a drop is a warp this will try to helpfully move.

Arrival invulnerability#

teleport:
  invulnerable-seconds: 3

Seconds of not being hittable after arriving anywhere, so a warp into a PvP world is not a coin toss. Attacking somebody gives it up at once. 0 turns it off, maximum 30.

/back#

teleport:
  remember-previous-location: true
  history-size: 5

/back walks a trail rather than a single step. history-size says how deep it goes, up to 20. /back on its own goes to the most recent place; /back 3 goes three places down the trail and forgets the two it passed.

chorus.back.ondeath additionally lets /back return to a death point. Without it, dying is not remembered — which is the version most survival servers want.

remember-previous-location: false switches the whole thing off.

/tpoffline#

Goes to where somebody logged out, reading the position written down when they left. Somebody still online is simply where they are, so it answers for them too.

Config reference#

enabled: true

teleport:
  cancel-on-move: true
  cancel-on-damage: true
  remember-previous-location: true
  history-size: 5
  warmup-countdown: true
  safe-landing: true
  safe-landing-radius: 5
  invulnerable-seconds: 3

requests:
  timeout-seconds: 60

commands:
  defaults: ...
  tpa: ...
  tpahere: ...
  tpaccept: ...
  tpdeny: ...
  tpcancel: ...
  back: ...
  tptoggle: ...
  tpauto: ...
  tpoffline: ...
  tpaall: ...

Permissions#

A note on Folia#

Teleports go through Paper's own asynchronous teleport, which moves a player between regions properly. That is why /tpa across a whole world works on Folia without anything special — see Folia.