TomTPA

TomTPA is a clean teleportation plugin for your server that handles standard TPA requests while adding great quality-of-life upgrades like interactive chat messages, action bar countdowns, and dynamic custom delays.

Features

• Interactive Chat Requests: Players receive clickable chat messages to easily accept or decline incoming teleport requests.

• Visual & Audio Feedback: The plugin utilizes the action bar to display a live countdown timer and plays ascending note block sounds to both players as the timer ticks down.

• Teleportation Effects: Upon a successful teleport, the destination features Portal and Cloud particle effects along with specific sound effects.

• Anti-Movement System: If the teleporting player moves their character before the delay finishes, the teleport is automatically cancelled and a warning sound is played.

• Dynamic Custom Delays: You can configure different teleport waiting times for different player ranks, and the plugin will automatically apply the shortest delay a player has permission for.

Commands

Permissions

• tomtpa.use: Grants access to use /tpa (true by default).

• tomtpa.here: Grants access to use /tpahere (true by default).

• tomtpa.accept: Grants access to use /tpaccept (true by default).

• tomtpa.decline: Grants access to use /tpadecline (true by default).

• tomtpa.admin: Grants access to the reload command (OP by default).

• tomtpa.bypass.timer: Completely bypasses the teleport delay, setting it to 0 seconds.

• tomtpa.<group>: Used to assign custom delays to specific groups based on the configuration.

Requirements

• Spigot/Paper 1.21

Custom Cooldowns & Configuration

TomTPA allows you to easily assign custom teleport wait times for different ranks (like VIP, Mod, or Sponsor) using your configuration file.

Below is the default config.yml generated by the plugin:

# The default teleport delay in seconds for normal players.
teleport-delay: 5

# Custom delays based on permissions.
# You can add as many as you want here! Just give the player the permission: tomtpa.<group>
# Example: If you add 'booster: 3' below, give the player 'tomtpa.booster' to give them a 3-second delay.
#
# NOTE: If a player has multiple permissions, the plugin will automatically use the lowest delay!
# To bypass the timer completely (0 seconds), give the player: tomtpa.bypass.timer
custom-delays:
  mod: 1
  vip: 2
  booster: 3
  sponsor: 0

Note from the config: You can set a custom group's delay to 0 to make it instant, or you can use the built-in tomtpa.bypass.timer permission.

Bugs & Suggestions

Please report bugs on my discord server. This is the first release i do expect bugs.