\n# HorizonsTPA<\/p>\n
**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.<\/p>\n
—<\/p>\n
## Features at a Glance<\/p>\n
– Clickable **accept \/ deny buttons** directly in chat
\n– Configurable **warmup system** with ActionBar progress bar, titles, or both
\n– Separate **cooldowns** for TPA and \/back
\n– **Economy support** with four currency providers
\n– **PlaceholderAPI** integration
\n– **Sound effects** for every interaction
\n– Multilingual out of the box (English & German)
\n– Lightweight, chat-based design — no GUIs, no bloat<\/p>\n
—<\/p>\n
## Teleport Requests<\/p>\n
### \/tpa and \/tpahere<\/p>\n
Send a teleport request to any online player. `\/tpa – Requests automatically **expire** after a configurable timeout (default: 60 seconds). ### Accepting, Denying & Cancelling<\/p>\n | Command | Description | All three commands provide immediate feedback with configurable messages and sound effects.<\/p>\n ### Toggle Requests<\/p>\n 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.<\/p>\n Players with the `horizonstpa.bypass.toggle` permission can still send requests to players who have toggled off.<\/p>\n —<\/p>\n ## \/back Command<\/p>\n 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.<\/p>\n – Separate permission for general \/back usage (`horizonstpa.back`) and returning to death locations (`horizonstpa.back.ondeath`). —<\/p>\n ## Warmup System<\/p>\n 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.<\/p>\n ### Cancel Conditions<\/p>\n The warmup is cancelled if the player: ### Display Modes<\/p>\n Choose how the warmup countdown is displayed to the player:<\/p>\n | Mode | Description | ### Progress Bar Customization<\/p>\n The ActionBar progress bar is fully customizable:<\/p>\n – **Length** — total number of characters in the bar Example: `[##########———-]` with green-to-gray gradient, fully adjustable in the configuration.<\/p>\n —<\/p>\n ## Cooldown System<\/p>\n Prevent teleport spam with separate cooldown timers:<\/p>\n – **TPA Cooldown** — applies after sending a `\/tpa` or `\/tpahere` request Both cooldown durations are independently configurable. Players with the `horizonstpa.bypass.cooldown` permission skip all cooldowns entirely.<\/p>\n —<\/p>\n ## Sound Effects<\/p>\n HorizonsTPA plays configurable sound effects for key interactions, providing audio feedback alongside chat messages:<\/p>\n | Event | Description | Each sound can be customized or disabled individually in the configuration.<\/p>\n —<\/p>\n ## Economy Integration<\/p>\n Charge players for teleportation to add an economic dimension to your server:<\/p>\n – **TPA Cost** — charge for sending `\/tpa` or `\/tpahere` requests ### Supported Currency Providers<\/p>\n | Provider | Description | Configure your preferred provider and costs in the main configuration file. Only one provider is active at a time.<\/p>\n —<\/p>\n ## PlaceholderAPI<\/p>\n HorizonsTPA provides the following placeholders (requires PlaceholderAPI):<\/p>\n | Placeholder | Description | —<\/p>\n ## Commands<\/p>\n | Command | Aliases | Description | Permission | —<\/p>\n ## Permissions<\/p>\n ### Core Permissions<\/p>\n | Permission | Description | Default | ### Bypass Permissions<\/p>\n | Permission | Description | Default | ### Admin Permissions<\/p>\n | Permission | Description | Default | **Wildcard permissions:** —<\/p>\n ## Getting Started<\/p>\n 1. **Download** HorizonsTPA and place the JAR file in your server’s `plugins` folder. —<\/p>\n ## Configuration<\/p>\n HorizonsTPA uses a clean YAML configuration file. Key configuration sections include:<\/p>\n – **Request Settings** — timeout duration, clickable button text and hover messages Language files are stored separately and the plugin ships with **English** and **German** translations. Additional languages can be added by creating new language files.<\/p>\n —<\/p>\n ## Compatibility<\/p>\n | Requirement | Details | ### Optional Integrations<\/p>\n | Plugin | Purpose | ### Metrics<\/p>\n HorizonsTPA collects anonymous usage statistics via **bStats** to help with development. This can be disabled in the bStats configuration.<\/p>\n —<\/p>\n ## Support<\/p>\n If you encounter any issues or have feature suggestions, please reach out through the Modrinth project page or the linked support channels. When reporting a bug, please include:<\/p>\n – Your server version (`\/version`) A lightweight TPA plugin with clickable accept\/deny buttons, back command, toggle system, and smooth warmup effects.<\/p>\n","protected":false},"featured_media":81929,"template":"","meta":{"_minecraft_slug":"horizons-tpa","_minecraft_project_id":"dXJZWszH","_minecraft_author":"raawn","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":18,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"horizons-tpa.zip","_minecraft_size_bytes":142212,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:39:35.831506Z","_minecraft_date_created":"2026-03-31T00:08:13.269339Z","_minecraft_date_modified":"2026-03-31T12:59:36.063389Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/horizons-tpa","_minecraft_icon_attachment_id":81929,"_minecraft_imported_at":"2026-06-04T17:01:08+00:00","_minecraft_import_hash":"73218b1969710ff2091aa46b1ae6efbe","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,127,128,129,869,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-81940","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-transportation","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– 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.
\n– Players can have only one outgoing request at a time. Sending a new request automatically cancels the previous one.<\/p>\n
\n|—|—|
\n| `\/tpaccept` | Accept an incoming teleport request |
\n| `\/tpdeny` | Deny an incoming teleport request |
\n| `\/tpcancel` | Cancel your own outgoing request |<\/p>\n
\n– Has its own independent **cooldown** timer, configured separately from TPA cooldowns.
\n– Can optionally **cost money** through the economy system, also configured independently from TPA costs.<\/p>\n
\n– **Moves** from their current position
\n– **Takes damage**<\/p>\n
\n|—|—|
\n| **ActionBar** | A progress bar displayed in the action bar area above the hotbar |
\n| **Title** | A title and subtitle displayed in the center of the screen |
\n| **Both** | ActionBar progress bar and title\/subtitle simultaneously |<\/p>\n
\n– **Filled character** — the character used for the completed portion
\n– **Empty character** — the character used for the remaining portion
\n– **Filled color** — HEX color code for the completed portion
\n– **Empty color** — HEX color code for the remaining portion<\/p>\n
\n– **\/back Cooldown** — applies after using the `\/back` command<\/p>\n
\n|—|—|
\n| **Teleport** | Played when a teleportation completes |
\n| **Countdown** | Played during warmup countdown ticks |
\n| **Error** | Played when an action fails (e.g., no pending request) |
\n| **Request Received** | Played when you receive an incoming TPA request |
\n| **Accept** | Played when a request is accepted |
\n| **Toggle** | Played when toggling TPA requests on\/off |
\n| **Cancel** | Played when a request is cancelled or denied |<\/p>\n
\n– **\/back Cost** — charge separately for using the `\/back` command
\n– Players with the `horizonstpa.bypass.cost` permission teleport for free.<\/p>\n
\n|—|—|
\n| **Vault** | Standard economy integration via any Vault-compatible economy plugin |
\n| **PlayerPoints** | Use PlayerPoints as the currency |
\n| **CoinsEngine** | Use any CoinsEngine currency |
\n| **XP-based** | Deduct experience levels or points directly |<\/p>\n
\n|—|—|
\n| `%horizonstpa_tpa_status%` | Whether the player accepts TPA requests (`On`\/`Off`) |
\n| `%horizonstpa_tpa_incoming_count%` | Number of incoming TPA requests |
\n| `%horizonstpa_tpa_outgoing_count%` | Number of outgoing TPA requests |
\n| `%horizonstpa_tpa_cooldown%` | Remaining TPA cooldown in seconds (0 if none) |
\n| `%horizonstpa_back_cooldown%` | Remaining \/back cooldown in seconds (0 if none) |
\n| `%horizonstpa_has_back_location%` | Whether the player has a saved back location (`true`\/`false`) |<\/p>\n
\n|—|—|—|—|
\n| `\/tpa
\n| `\/tpahere
\n| `\/tpaccept [player]` | `\/tpyes` | Accept an incoming request (optionally from a specific player) | `horizonstpa.accept` |
\n| `\/tpdeny [player]` | `\/tpno` | Deny an incoming request (optionally from a specific player) | `horizonstpa.deny` |
\n| `\/tpcancel` | — | Cancel your outgoing request | `horizonstpa.cancel` |
\n| `\/tptoggle` | — | Toggle receiving TPA requests | `horizonstpa.toggle` |
\n| `\/back` | — | Return to your last\/death location | `horizonstpa.back` |
\n| `\/tpaadmin reload` | — | Reload the plugin configuration | `horizonstpa.admin.reload` |
\n| `\/tpaadmin info` | — | Display plugin information | `horizonstpa.admin.info` |<\/p>\n
\n|—|—|—|
\n| `horizonstpa.use` | Grants all core TPA permissions below (parent permission) | `true` |
\n| `horizonstpa.tpa` | Send `\/tpa` requests | `true` |
\n| `horizonstpa.tpahere` | Send `\/tpahere` requests | `true` |
\n| `horizonstpa.accept` | Accept incoming requests | `true` |
\n| `horizonstpa.deny` | Deny incoming requests | `true` |
\n| `horizonstpa.cancel` | Cancel outgoing requests | `true` |
\n| `horizonstpa.toggle` | Toggle receiving TPA requests | `true` |
\n| `horizonstpa.back` | Access to the \/back command | `true` |
\n| `horizonstpa.back.ondeath` | Allow \/back to return to death locations | `true` |<\/p>\n
\n|—|—|—|
\n| `horizonstpa.bypass.toggle` | Send requests to players who have toggled off | `op` |
\n| `horizonstpa.bypass.cooldown` | Bypass all cooldown timers | `op` |
\n| `horizonstpa.bypass.warmup` | Bypass the warmup delay | `op` |
\n| `horizonstpa.bypass.cost` | Bypass economy costs | `op` |<\/p>\n
\n|—|—|—|
\n| `horizonstpa.admin` | Grants all admin permissions below (parent permission) | `op` |
\n| `horizonstpa.admin.reload` | Reload the plugin configuration | `op` |
\n| `horizonstpa.admin.info` | View plugin information | `op` |<\/p>\n
\n– `horizonstpa.bypass.*` — grants all bypass permissions
\n– `horizonstpa.admin.*` — grants all admin permissions<\/p>\n
\n2. **Restart** your server (or load the plugin with a plugin manager).
\n3. The plugin generates its default configuration files on first startup.
\n4. **Grant permissions** — give players `horizonstpa.use` for basic TPA access and `horizonstpa.back` for the \/back command.
\n5. (Optional) Configure economy, warmup, cooldown, and sound settings to your liking.
\n6. Use `\/tpaadmin reload` to apply configuration changes without restarting.<\/p>\n
\n– **Warmup** — duration, display mode (ActionBar\/Title\/Both), cancel conditions, progress bar customization
\n– **Cooldowns** — separate durations for TPA and \/back
\n– **Economy** — enable\/disable, currency provider selection, TPA cost, \/back cost
\n– **Sounds** — individual toggle and sound selection for each event
\n– **Messages** — fully translatable, supports MiniMessage formatting with HEX colors and gradients<\/p>\n
\n|—|—|
\n| **Server Software** | Paper, Purpur, or Spigot 1.21 or newer (Folia not supported) |
\n| **Java Version** | Java 21 or newer |<\/p>\n
\n|—|—|
\n| **Vault** + Economy Plugin | Economy provider for teleport costs |
\n| **PlayerPoints** | Alternative economy provider |
\n| **CoinsEngine** | Alternative economy provider |
\n| **PlaceholderAPI** | Placeholder support for external plugins |<\/p>\n
\n– The plugin version (`\/tpaadmin info`)
\n– A clear description of the issue
\n– Relevant console errors, if any<\/p>\n","protected":false},"excerpt":{"rendered":"