🌐 CustomTPA – Modern Teleport Requests

The ultimate TPA plugin now for Paper, Purpur, Folia, Spigot & Bukkit. 19 languages, auto‑accept, countdown sound, chat buttons, GUI, update checker, and MiniMessage formatting.

---

✨ Features

• 🌍 19 Languages – Automatic per-player language detection: English, Russian, Ukrainian, German, French, Spanish, Portuguese (Brazil), Turkish, Italian, Polish, Chinese (Simplified), Japanese, Finnish, Korean, Swedish, Dutch, Czech, Hungarian, Romanian.
• ⚡ Auto‑Accept Mode – /tpaauto instantly accepts all incoming requests with a configurable delay.
• 🔊 Countdown Sound – A subtle experience orb pickup sound plays each second of the teleport delay.
• 🔔 Update Checker – Admins receive join/console notifications when a new version is available on Modrinth.
• 💬 Chat Buttons – Clickable [✔ Accept], [✘ Deny], and [✘ Cancel] with descriptive prompts.
• ⏳ Teleport Delay – Configurable countdown shown in the action bar; movement cancels the teleport.
• 🖼️ GUI – /tpa gui opens an inventory with player heads and control buttons; fully localized.
• 🎨 MiniMessage + Legacy Colors – Supports <gradient>, <✨>, <#ffaa00>, &a, &l, §a, &#RRGGBB and §x§R§R§G§G§B§B.
• 🔄 PlaceholderAPI + LuckPerms – Use %other_luckperms_prefix% or any placeholder for the involved player.
• ⚙️ Fully Configurable – All messages and sounds are customizable via lang/*.yml.
• 📁 Easy Translation – Add new languages by dropping a messages_XX.yml into the lang/ folder.
• ⚡ Reload Command – /customtpa reload applies changes without restarting the server.
• 🛡️ Cross-Platform – Works on Paper, Purpur, Folia, Spigot, and Bukkit (1.21.1+).

---

📋 Commands

Command	Description
/tpa <player>	Request to teleport to a player
/tpahere <player>	Invite a player to teleport to you
/tpaccept [player]	Accept a request (or select from list)
/tpadeny [player]	Deny a request
/tpcancel	Cancel your outgoing request
/tpatoggle	Toggle receiving requests
/tpaauto	Toggle automatic acceptance of all requests
/tpa gui	Open the graphical request menu
/customtpa reload	Reload configuration (/ctpa)

---

🗣 Languages

The plugin automatically detects the player's locale.
Currently included:

• 🇬🇧 English (en)
• 🇷🇺 Russian (ru)
• ✨ Ukrainian (uk)
• 🇩🇪 German (de)
• 🇫🇷 French (fr)
• 🇪🇸 Spanish (es)
• 🇧🇷 Portuguese, Brazil (pt_br)
• 🇹🇷 Turkish (tr)
• 🇮🇹 Italian (it)
• 🇵🇱 Polish (pl)
• 🇨🇳 Chinese, Simplified (zh_cn)
• 🇯🇵 Japanese (ja)
• 🇫🇮 Finnish (fi)
• 🇰🇷 Korean (ko)
• 🇸🇪 Swedish (sv)
• 🇳🇱 Dutch (nl)
• 🇨🇿 Czech (cs)
• 🇭🇺 Hungarian (hu)
• 🇷🇴 Romanian (ro)

To add more languages, copy any messages_*.yml in the lang/ folder, rename it (e.g., messages_pl.yml), translate the values, and reload the plugin.

---

⚙️ Dependencies (Optional)

• PlaceholderAPI – for placeholders in messages.
• LuckPerms – for displaying player prefixes/suffixes.

The plugin works without them, but they unlock the full potential.

---

🛠️ Installation

1. Download the correct JAR for your server:
   • Paper / Purpur / Folia: CustomTPA‑1.7.0‑paper.jar
   • Spigot / Bukkit: CustomTPA‑1.7.0‑spigot.jar
2. Place it into your plugins folder.
3. Start the server (or use PlugMan).
4. Edit lang/messages_XX.yml to customize messages.
5. Run /customtpa reload to apply changes.

---

🔗 Links

• SpigotMC: [[https://www.spigotmc.org/resources/customtpa.XXXXXX/]
• GitHub (source): https://github.com/MrKronik/CustomTPA

---

👤 Author

MrKronick
Bug reports & suggestions: Discord mrkronick