CustomTPA

CustomTPA – Modern Teleport Requests

The ultimate TPA plugin for Paper, Purpur, Folia, Spigot & Bukkit. 70 languages, auto‑accept, countdown sound, chat buttons, GUI, update checker, bypass permissions, daily limits, warm welcome, visual effects, request logging, TPA Back, Force TPA, World Whitelist/Blacklist, Vault economy integration, and MiniMessage formatting.

---

✨ Features

• 70 Languages – Automatic per‑player language detection. Full list includes English, Russian, Ukrainian, German, French, Spanish, Portuguese (Brazil & Portugal), Turkish, Italian, Polish, Chinese (Simplified), Japanese, Finnish, Korean, Swedish, Dutch, Czech, Hungarian, Romanian, Norwegian, Danish, Greek, Indonesian, Arabic, Vietnamese, Slovak, Bulgarian, Hebrew, Thai, Filipino (Tagalog), Hindi, Croatian, Slovenian, Lithuanian, Latvian, Estonian, Serbian, Macedonian, Catalan, Bengali, Urdu, Persian, Malay, Swahili, Afrikaans, Icelandic, Galician, Basque, Esperanto, Punjabi, Marathi, Telugu, Tamil, Gujarati, Kannada, Malayalam, Nepali, Sinhala, Burmese, Kazakh, Uzbek, Azerbaijani, Georgian, Armenian, Khmer, Lao, Mongolian, Somali, Zulu.
• Vault Economy – Configurable cost for /tpa and /tpahere. Permission customtpa.bypass.cost to skip payment.
• Auto‑Accept Mode – /tpaauto instantly accepts all incoming requests with a configurable delay.
• Countdown Sound – Configurable sound plays each second of the teleport countdown.
• Request Sound – Optional sound when receiving a teleport request.
• Bypass Permissions – Granular permissions for VIPs/admins: customtpa.bypass.delay, customtpa.bypass.cooldown, customtpa.bypass.blacklist, customtpa.bypass.limit, customtpa.bypass.cost.
• Daily Request Limit – Configurable limit for sent requests per day (0 = unlimited).
• Configurable Timeout – Set request expiration time in config.yml.
• World Whitelist / Blacklist – Choose between blacklist (block specific worlds) or whitelist (allow only specific worlds). Perfect for servers with many worlds.
• 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>, <rainbow>, <#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.
• Player Statistics – /tpastats shows sent, accepted, and denied requests.
• Warm Welcome – Send a configurable message to new players on their first join (per‑language).
• Request Logging – Log all TPA actions to a file for moderation. Auto‑cleanup included.
• Visual Effects – Spawn particles on teleportation (configurable type and count).
• TPA Back – /tpaback returns you to your previous location after a teleport.
• Force TPA – /tpaforce lets admins instantly teleport to players (hidden from regular players).
• Fully Configurable – All messages, sounds, cooldowns, limits, blacklists, whitelists, and new features are in config.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.
• Update Checker – Admins receive join/console notifications when a new version is available. Can be toggled.
• Cross-Platform – Works on Paper, Purpur, Folia, Spigot, and Bukkit (1.21.1+).

---

📋 Commands

---

🗣 Languages

The plugin automatically detects the player's locale.
Currently included (70 languages):

• English (en)
• Russian (ru)
• Ukrainian (uk)
• German (de)
• French (fr)
• Spanish (es)
• Portuguese, Brazil (pt_br)
• Portuguese, Portugal (pt)
• 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)
• Norwegian (nb)
• Danish (da)
• Greek (el)
• Indonesian (id)
• Arabic (ar)
• Vietnamese (vi)
• Slovak (sk)
• Bulgarian (bg)
• Hebrew (he)
• Thai (th)
• Filipino, Tagalog (tl)
• Hindi (hi)
• Croatian (hr)
• Slovenian (sl)
• Lithuanian (lt)
• Latvian (lv)
• Estonian (et)
• Serbian (sr)
• Macedonian (mk)
• Catalan (ca)
• Bengali (bn)
• Urdu (ur)
• Persian (fa)
• Malay (ms)
• Swahili (sw)
• Afrikaans (af)
• Icelandic (is)
• Galician (gl)
• Basque (eu)
• Esperanto (eo)
• Punjabi (pa)
• Marathi (mr)
• Telugu (te)
• Tamil (ta)
• Gujarati (gu)
• Kannada (kn)
• Malayalam (ml)
• Nepali (ne)
• Sinhala (si)
• Burmese (my)
• Kazakh (kk)
• Uzbek (uz)
• Azerbaijani (az)
• Georgian (ka)
• Armenian (hy)
• Khmer (km)
• Lao (lo)
• Mongolian (mn)
• Somali (so)
• Zulu (zu)

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

---

⚙️ Dependencies (Optional)

• PlaceholderAPI – for placeholders in messages.
• LuckPerms – for displaying player prefixes/suffixes.
• Vault – for economy features (optional).

---

🛠️ Installation

1. Download the correct JAR for your server:
   • Paper / Purpur / Folia: CustomTPA‑2.3.0‑paper.jar
   • Spigot / Bukkit: CustomTPA‑2.3.0‑spigot.jar
2. Place it into your plugins folder.
3. Start the server.
4. Edit lang/messages_XX.yml to customize messages.
5. Edit config.yml to configure features (including Vault prices if enabled).
6. Run /customtpa reload to apply changes.

---

🔗 Links

• SpigotMC: https://www.spigotmc.org/resources/customtpa.136316/
• GitHub: https://github.com/MrKronick/CustomTPA

---

🙏 Thank You!

A huge thank you to everyone who has downloaded, tested, and supported CustomTPA. Your feedback and suggestions are invaluable. Keep the ideas coming!
Special thanks to the open‑source community and all contributors who help make this project better every day.

---

🖥️ Full Core Support

CustomTPA is battle‑tested on every major server software:

• Paper (1.21.x)
• Purpur (1.21.x)
• Folia (1.21.x)
• Spigot (1.21.x)
• Bukkit (1.21.x)

All cores are tested with every release. If it runs Java, it runs CustomTPA.

---

👤 Author

MrKronick
Bug reports & suggestions: Discord mrkronick