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

Keeps a player out of a wall, out of the void and out of lava, looking for somewhere to stand within that many blocks above or below instead. Maximum radius 16.

How much of it applies depends on what the player could actually survive:

That is what stops an admin in creative being refused a teleport to a world spawn buried in netherrack.

Water counts as ground, so a warp or a home on a coast or a river is not refused. So does a block that is not a full cube — a slab, a stair, a carpet, a layer of snow: those are somewhere to stand, not something to be lifted off, and a home saved on one lands exactly where it was saved.

Typed coordinates are never moved. /tp and /tppos go exactly where they were told. Safe landing is for places that were saved once and may not be what they were: homes, warps, spawn, /back.

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.