EssentialsC / Teleportation

Teleportation

Player teleport requests, back teleport, and force teleport commands.

TPA System

The TPA system lets players request to teleport to each other. Requests have a configurable timeout, cooldown, and warmup, and can be blocked per-world or cancelled by movement.

Command Description
/tpa <player> Request to teleport to a player.
/tpahere <player> Request a player to teleport to you.
/tpaccept [player] Accept an incoming teleport request.
/tpdeny [player] Deny an incoming teleport request.
/tpcancel [player] Cancel an outgoing teleport request you sent.
/tpatoggle Toggle whether you receive TPA requests.
/tpaignore <player> Ignore TPA requests from a specific player.
/tpaqueue View your pending incoming and outgoing teleport requests.
Teleport warmups can be configured per-command type. For TPA, accepting a request starts the warmup; if the sender moves during it, the teleport is cancelled and the sender's cooldown is still consumed.

Back & Death Back

Command Description
/back Return to your previous location after a teleport or death.
/dback Teleport to your last death location.

/back stores the location before every teleport (including TPA, warp, home, spawn) and on death. The death location is tracked separately so /dback always takes you to where you died, even if you've teleported since then.

/back has its own warmup and cooldown. Set back.cooldown to 0 to disable the cooldown and back.warmup to 0 to teleport instantly. /dback shares the back settings.

Teleport Commands

Command Description Permission
/tphere <player> Teleport a player to your current location. essentialsc.tphere
/tphereall Teleport all online players to your location. essentialsc.tphereall
/tpoffline <player> Teleport to an offline player's last known logout location. essentialsc.tpoffline
/top Teleport to the highest block directly above you. essentialsc.top
Force teleport commands (/tphere, /tphereall) bypass TPA entirely - the target player does not receive a request and cannot deny it.

Configuration

Teleport settings live in config.yml under the tpa and back sections.

Key Type Default Description
tpa.enabled Boolean true Fully disables the TPA request system and unregisters all eight /tpa* commands. See the Modules page - a restart is required.
tpa.cooldown Seconds 60 Cooldown between TPA requests.
tpa.warmup Seconds 3 Delay before the teleport executes.
tpa.timeout Seconds 60 How long a request stays valid before expiring.
tpa.max-pending Integer 5 Max incoming requests a player can have queued.
tpa.max-outgoing Integer 1 Max outgoing requests a player can send at once.
tpa.deny-movement Boolean true Cancel the teleport if the sender moves during the warmup.
tpa.particles Boolean true Play particles during the warmup.
tpa.sounds Boolean true Play sounds during TPA events.
tpa.blocked-worlds List [] Worlds where /tpa and /tpahere are blocked.
back.enabled Boolean true Fully disables back tracking and unregisters /back and /dback. See the Modules page - a restart is required.
back.warmup Seconds 3 Delay before /back executes.
back.cooldown Seconds 5 Cooldown for /back. Set to 0 to disable.
back.particles Boolean true Play particles on arrival.
back.sounds Boolean true Play sounds during the back teleport.
back.cancel-on-movement Boolean true Cancel the teleport if the player moves during the warmup.

Permissions

Permission Description Default
essentialsc.tpa Use /tpa. Everyone
essentialsc.tpahere Use /tpahere. Everyone
essentialsc.tpaccept Accept teleport requests. Everyone
essentialsc.tpdeny Deny teleport requests. Everyone
essentialsc.tpcancel Cancel outgoing teleport requests. Everyone
essentialsc.tpaignore Ignore teleport requests from a player. Everyone
essentialsc.tpatoggle Toggle incoming teleport requests on/off. Everyone
essentialsc.tpaqueue View your pending teleport requests. Everyone
essentialsc.tphere Force teleport a player to you. Operators
essentialsc.tphereall Teleport all players to you. Operators
essentialsc.tpoffline Teleport to an offline player's last location. Operators
essentialsc.top Use /top. Everyone
essentialsc.back Use /back. Everyone
essentialsc.dback Use /dback. Everyone
essentialsc.tpa.bypass.cooldown Skip the TPA request cooldown. Operators
essentialsc.tpa.bypasscost Bypass TPA cost. Operators
essentialsc.back.admin Bypass cooldowns and warmup for /back. Operators
essentialsc.dback.admin Bypass warmup and cooldown for /dback. Operators
essentialsc.tphere.bypass Prevents being teleported by others via /tphere. Operators
essentialsc.tphere.bypass.override Teleport players who have essentialsc.tphere.bypass. Operators
essentialsc.tphereall.bypass Teleport players who have TPA disabled. Operators