Horizons TPA

!(https://cdn.modrinth.com/data/cached_images/3469d3bfb3a2d39bf91ace998306a9fb4831a21f.png) # HorizonsTPA

A feature-rich, lightweight teleport request plugin for modern Paper, Purpur, and Spigot servers. HorizonsTPA brings a polished TPA experience with warmups, cooldowns, economy integration, and fully customizable messages -- all without a single GUI. Every interaction happens through clean, clickable chat components.

## Features at a Glance

• Clickable accept / deny buttons directly in chat
• Configurable warmup system with ActionBar progress bar, titles, or both
• Separate cooldowns for TPA and /back
• Economy support with four currency providers
• PlaceholderAPI integration
• Sound effects for every interaction
• Multilingual out of the box (English & German)
• Lightweight, chat-based design -- no GUIs, no bloat

## Teleport Requests

### /tpa and /tpahere

Send a teleport request to any online player. `/tpa ` requests to teleport to the target, while `/tpahere ` requests the target to teleport to you.

• Requests automatically expire after a configurable timeout (default: 60 seconds).
• The receiving player sees clickable Accept and Deny buttons in chat. Both the button text and hover tooltip are fully customizable in the language files.
• Players can have only one outgoing request at a time. Sending a new request automatically cancels the previous one.

### Accepting, Denying & Cancelling

| Command | Description | |---|---| | `/tpaccept` | Accept an incoming teleport request | | `/tpdeny` | Deny an incoming teleport request | | `/tpcancel` | Cancel your own outgoing request |

All three commands provide immediate feedback with configurable messages and sound effects.

### Toggle Requests

Use `/tptoggle` to disable or enable incoming TPA requests entirely. When toggled off, other players cannot send you requests and will be notified that you are not accepting them.

Players with the `horizonstpa.bypass.toggle` permission can still send requests to players who have toggled off.

## /back Command

Return to your last location before teleporting or your death location. The /back command maintains a per-player history so you can always get back to where you were.

• Separate permission for general /back usage (`horizonstpa.back`) and returning to death locations (`horizonstpa.back.ondeath`).
• Has its own independent cooldown timer, configured separately from TPA cooldowns.
• Can optionally cost money through the economy system, also configured independently from TPA costs.

## Warmup System

When a teleport request is accepted, the teleporting player enters a warmup phase before the actual teleportation occurs. This gives a brief delay that can be interrupted.

### Cancel Conditions

The warmup is cancelled if the player: - Moves from their current position - Takes damage

### Display Modes

Choose how the warmup countdown is displayed to the player:

| Mode | Description | |---|---| | ActionBar | A progress bar displayed in the action bar area above the hotbar | | Title | A title and subtitle displayed in the center of the screen | | Both | ActionBar progress bar and title/subtitle simultaneously |

### Progress Bar Customization

The ActionBar progress bar is fully customizable:

• Length -- total number of characters in the bar
• Filled character -- the character used for the completed portion
• Empty character -- the character used for the remaining portion
• Filled color -- HEX color code for the completed portion
• Empty color -- HEX color code for the remaining portion

Example: `[##########----------]` with green-to-gray gradient, fully adjustable in the configuration.

## Cooldown System

Prevent teleport spam with separate cooldown timers:

• TPA Cooldown -- applies after sending a `/tpa` or `/tpahere` request
• /back Cooldown -- applies after using the `/back` command

Both cooldown durations are independently configurable. Players with the `horizonstpa.bypass.cooldown` permission skip all cooldowns entirely.

## Sound Effects

HorizonsTPA plays configurable sound effects for key interactions, providing audio feedback alongside chat messages:

| Event | Description | |---|---| | Teleport | Played when a teleportation completes | | Countdown | Played during warmup countdown ticks | | Error | Played when an action fails (e.g., no pending request) | | Request Received | Played when you receive an incoming TPA request | | Accept | Played when a request is accepted | | Toggle | Played when toggling TPA requests on/off | | Cancel | Played when a request is cancelled or denied |

Each sound can be customized or disabled individually in the configuration.

## Economy Integration

Charge players for teleportation to add an economic dimension to your server:

- TPA Cost -- charge for sendin