Module: Teleport - Module ID: teleport

Introduction

The Teleport module allows players to teleport to one another, with request based (/tpa, /tpahere) and standard (/tp, /tphere) teleportation methods. /tptoggle can be used by players to block most teleportations. A method to teleport players to specific points on the world is also available - /tppos.

Setting Warmups and Cooldowns

This can be achieved using the commands.conf file for the commands tpa, tpahere and teleport. The options are warmup and cooldown, and are specified in seconds. Note that each command has a specific warmup/cooldown, so /tpa can have a 1 second warmup, while a standard /tp can have a 3 second warmup.

If the player moves, runs a command or is attacked during the warmup, the teleport is cancelled. The player is then free to try again, a cooldown is only applied when the teleport is successful.

For /tpa and /tpahere, the warmup starts when the teleport request is accepted and acts on the player being teleported, sending the request is instantaneous.

Teleport Requests

Nucleus allows players to request to teleport to a specific player, or vice versa, using the commands /tpa and /tpahere. If a player receives a request, they are given 30 seconds to respond to the request, either by clicking on the “Accept” or “Deny” links, or by using the commands /tpaccept or /tpdeny. If the request is accepted, any warmup runs,

Overriding the Minecraft /tp command

By default, Nucleus overrides the /tp command with its own implementation, but provides ways to easily get the vanilla behaviour:

  • Use /tpn, which is an alias for the original Minecraft /tp command.
  • In commands.conf, set teleport.use-tp-command to false. /tp will return to the Vanilla version, while /teleport will still be the Nucleus version.

Using /tppos to teleport to chunk co-ordinates

/tppos has a -c flag, which, if specified, will let you teleport to a specified chunk. Note that the y co-ordinate is still required - all -c really does is multiply your co-ordinates by 16, as per the Minecraft chunk spec.

/teleport
Module: teleport
Teleports one player to another's location.

Aliases: teleport

Root command aliases: /tp /nteleport

Usage: /teleport [-q <quiet>] [-f] [-b|--border] <player to warp to>|<player to warp> <player to warp to>|<offline player to warp to>

Default Role: MOD

Basic Command Permission: nucleus.teleport.teleport.base

Permissions

  • nucleus.teleport.teleport.base - Default Role: MOD
    Allows the user to run the command /teleport
  • nucleus.teleport.teleport.exempt.warmup - Default Role: ADMIN
    Allows the user to bypass the warmup for /teleport
  • nucleus.teleport.teleport.exempt.cooldown - Default Role: ADMIN
    Allows the user to bypass the cooldown for /teleport
  • nucleus.teleport.teleport.exempt.bordercheck - Default Role: ADMIN
    If granted, allows the user to the use "-b" flag to attempt to warp outside of the border.
  • nucleus.teleport.teleport.others - Default Role: ADMIN
    Allows the user to target other players using the command "teleport".
  • nucleus.teleport.teleport.quiet - Default Role: ADMIN
    Allows the user to use the "-q" flag to override whether to tell the target player if a teleport is being performed.
  • nucleus.teleport.teleport.offline - Default Role: ADMIN
    Allows the user to teleport to the location of players who are offline.
  • nucleus.teleport.teleport.exempt.cost - Default Role: ADMIN
    Allows the user to bypass the cost for /teleport

This command is similar to the following command(s) found in Essentials: /tp, /tele, /tp2p, /teleport, /tpo

Essentials Migration Notes: If you have permission, this will override '/tptoggle' automatically.

/tpa
Module: teleport
Send a request to a player to ask for you to teleport to them.

Aliases: tpa teleportask call tpask

Root command aliases: /ntpa

Usage: /tpa [-f] <player>

Default Role: USER

Basic Command Permission: nucleus.teleport.tpa.base

Permissions

  • nucleus.teleport.tpa.force - Default Role: ADMIN
    Allows the user to "force" teleport to a point, regardless of whether it is safe to do so.
  • nucleus.teleport.tpa.exempt.cooldown - Default Role: ADMIN
    Allows the user to bypass the cooldown for /tpa
  • nucleus.teleport.tpa.exempt.cost - Default Role: ADMIN
    Allows the user to bypass the cost for /tpa
  • nucleus.teleport.tpa.exempt.warmup - Default Role: ADMIN
    Allows the user to bypass the warmup for /tpa
  • nucleus.teleport.tpa.base - Default Role: USER
    Allows the user to run the command /tpa

This command is an equivalent to the following command(s) in Essentials: /tpa, /call, /tpask

/tpaall
Module: teleport
Request all players on the server to teleport to your location.

Aliases: tpaall tpaskall

Root command aliases: /ntpaall

Usage: /tpaall [-f]

Default Role: ADMIN

Basic Command Permission: nucleus.teleport.tpaall.base

Permissions

  • nucleus.teleport.tpaall.base - Default Role: ADMIN
    Allows the user to run the command /tpaall

This command is an equivalent to the following command(s) in Essentials: /tpaall

/tpaccept
Module: teleport
Accept a pending teleport request.

Aliases: tpaccept teleportaccept tpyes

Root command aliases: /ntpaccept

Usage: /tpaccept

Default Role: USER

Basic Command Permission: nucleus.teleport.tpaccept.base

Permissions

  • nucleus.teleport.tpaccept.base - Default Role: USER
    Allows the user to run the command /tpaccept

This command is an equivalent to the following command(s) in Essentials: /tpaccept, /tpyes

/tpahere
Module: teleport
Send a request to a player to ask them to teleport to you.

Aliases: tpahere tpaskhere teleportaskhere

Root command aliases: /ntpahere

Usage: /tpahere [-f] <player>

Default Role: MOD

Basic Command Permission: nucleus.teleport.tpahere.base

Permissions

  • nucleus.teleport.tpahere.exempt.warmup - Default Role: ADMIN
    Allows the user to bypass the warmup for /tpahere
  • nucleus.teleport.tpahere.exempt.cooldown - Default Role: ADMIN
    Allows the user to bypass the cooldown for /tpahere
  • nucleus.teleport.tpahere.exempt.cost - Default Role: ADMIN
    Allows the user to bypass the cost for /tpahere
  • nucleus.teleport.tpahere.force - Default Role: ADMIN
    Allows the user to "force" teleport to a point, regardless of whether it is safe to do so.
  • nucleus.teleport.tpahere.base - Default Role: MOD
    Allows the user to run the command /tpahere

This command is an equivalent to the following command(s) in Essentials: /tpahere

/tpall
Module: teleport
Forcefully teleport all players on the server to your location.

Aliases: tpall tpallhere

Root command aliases: /ntpall

Usage: /tpall [-f]

Default Role: ADMIN

Basic Command Permission: nucleus.teleport.tpall.base

Permissions

  • nucleus.teleport.tpall.base - Default Role: ADMIN
    Allows the user to run the command /tpall

This command is an equivalent to the following command(s) in Essentials: /tpall

/tpdeny
Module: teleport
Deny a pending teleport request.

Aliases: tpdeny teleportdeny tpno

Root command aliases: /ntpdeny

Usage: /tpdeny

Default Role: USER

Basic Command Permission: nucleus.teleport.tpdeny.base

Permissions

  • nucleus.teleport.tpdeny.base - Default Role: USER
    Allows the user to run the command /tpdeny

This command is an equivalent to the following command(s) in Essentials: /tpdeny, /tpno

/tphere
Module: teleport
Teleports a player to your location.

Aliases: tphere tph

Root command aliases: /ntphere

Usage: /tphere [-q|--quiet] <player>

Default Role: ADMIN

Basic Command Permission: nucleus.teleport.tphere.base

Permissions

  • nucleus.teleport.tphere.base - Default Role: ADMIN
    Allows the user to run the command /tphere
  • nucleus.teleport.tphere.offline - Default Role: ADMIN
    Allows the user to teleport players who are offline to their current location on next login.

This command is similar to the following command(s) found in Essentials: /tphere, /s, /tpohere

Essentials Migration Notes: If you have permission, this will override '/tptoggle' automatically.

/tppos
Module: teleport
Teleport to the specified location.

The tppos command supports three flags:

* -f/--force: forces the teleport to happen even if Nucleus thinks it won't be safe for you.
* -c/--chunk: indicates that the input co-ordinates are chunk co-ordiantes rather than world co-ordinates. Nucleus tries to put you in the centre of the chunk, and scans the whole chunk for a safe location.
* -b/--border: allow teleportation to take you outside of the world border (requires nucleus.tppos.exempt.bordercheck permission)

Aliases: tppos

Root command aliases: /ntppos

Usage: /tppos [-f|--force] [-b|--border] [-c|--chunk] [<player>] [<world>] <x y z>

Default Role: ADMIN

Basic Command Permission: nucleus.teleport.tppos.base

Permissions

  • nucleus.teleport.tppos.exempt.bordercheck - Default Role: ADMIN
    If granted, allows the user to the use "-b" flag to attempt to warp outside of the border.
  • nucleus.teleport.tppos.base - Default Role: ADMIN
    Allows the user to run the command /tppos
  • nucleus.teleport.tppos.others - Default Role: ADMIN
    Allows the user to target other players using the command "tppos".

This command is an equivalent to the following command(s) in Essentials: /tppos

/tptoggle
Module: teleport
Toggle whether teleport requests are received.

Aliases: tptoggle

Root command aliases: /ntptoggle

Usage: /tptoggle [<true|false>]

Default Role: USER

Basic Command Permission: nucleus.teleport.tptoggle.base

Permissions

  • nucleus.teleport.tptoggle.base - Default Role: USER
    Allows the user to run the command /tptoggle
  • nucleus.teleport.tptoggle.exempt - Default Role: ADMIN
    Allows the user to teleport to anyone, regardless of whether they have turned on /tptoggle protection.

This command is an equivalent to the following command(s) in Essentials: /tptoggle

Permission Suggested Role Description
nucleus.teleport.teleport.base MOD Allows the user to run the command /teleport
nucleus.teleport.teleport.exempt.bordercheck ADMIN If granted, allows the user to the use "-b" flag to attempt to warp outside of the border.
nucleus.teleport.teleport.exempt.cooldown ADMIN Allows the user to bypass the cooldown for /teleport
nucleus.teleport.teleport.exempt.cost ADMIN Allows the user to bypass the cost for /teleport
nucleus.teleport.teleport.exempt.warmup ADMIN Allows the user to bypass the warmup for /teleport
nucleus.teleport.teleport.offline ADMIN Allows the user to teleport to the location of players who are offline.
nucleus.teleport.teleport.others ADMIN Allows the user to target other players using the command "teleport".
nucleus.teleport.teleport.quiet ADMIN Allows the user to use the "-q" flag to override whether to tell the target player if a teleport is being performed.
nucleus.teleport.tpa.base USER Allows the user to run the command /tpa
nucleus.teleport.tpa.exempt.cooldown ADMIN Allows the user to bypass the cooldown for /tpa
nucleus.teleport.tpa.exempt.cost ADMIN Allows the user to bypass the cost for /tpa
nucleus.teleport.tpa.exempt.warmup ADMIN Allows the user to bypass the warmup for /tpa
nucleus.teleport.tpa.force ADMIN Allows the user to "force" teleport to a point, regardless of whether it is safe to do so.
nucleus.teleport.tpaall.base ADMIN Allows the user to run the command /tpaall
nucleus.teleport.tpaccept.base USER Allows the user to run the command /tpaccept
nucleus.teleport.tpahere.base MOD Allows the user to run the command /tpahere
nucleus.teleport.tpahere.exempt.cooldown ADMIN Allows the user to bypass the cooldown for /tpahere
nucleus.teleport.tpahere.exempt.cost ADMIN Allows the user to bypass the cost for /tpahere
nucleus.teleport.tpahere.exempt.warmup ADMIN Allows the user to bypass the warmup for /tpahere
nucleus.teleport.tpahere.force ADMIN Allows the user to "force" teleport to a point, regardless of whether it is safe to do so.
nucleus.teleport.tpall.base ADMIN Allows the user to run the command /tpall
nucleus.teleport.tpdeny.base USER Allows the user to run the command /tpdeny
nucleus.teleport.tphere.base ADMIN Allows the user to run the command /tphere
nucleus.teleport.tphere.offline ADMIN Allows the user to teleport players who are offline to their current location on next login.
nucleus.teleport.tppos.base ADMIN Allows the user to run the command /tppos
nucleus.teleport.tppos.exempt.bordercheck ADMIN If granted, allows the user to the use "-b" flag to attempt to warp outside of the border.
nucleus.teleport.tppos.others ADMIN Allows the user to target other players using the command "tppos".
nucleus.teleport.tptoggle.base USER Allows the user to run the command /tptoggle
nucleus.teleport.tptoggle.exempt ADMIN Allows the user to teleport to anyone, regardless of whether they have turned on /tptoggle protection.
The following configuration is the default for this module:
# If true, by default, a target player will not be informed that they have been /teleport ed to. Override using "-q false"
default-quiet=true
# If true, teleporting tries to find a safe place for players.
use-safe-teleportation=true