🌐 CustomTPA – Modern Teleport Requests

The ultimate TPA plugin for Paper, Purpur, Folia, Spigot & Bukkit. 65 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, and MiniMessage formatting.

---

✨ Features

• 🌍 65 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.
• ⚡ 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.
• ⏱ 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 (e.g., EliteMobs).
• 💬 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

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
/tpastats	View your teleport statistics
/tpaback	Return to your location before the last teleport
/tpaforce <player>	Force‑teleport to a player (admin only)
/customtpa reload	Reload configuration (/ctpa)

---

🗣 Languages

The plugin automatically detects the player's locale.
Currently included (65 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)

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.

---

🛠️ Installation

1. Download the correct JAR for your server:
   • Paper / Purpur / Folia: CustomTPA‑2.2.0‑paper.jar
   • Spigot / Bukkit: CustomTPA‑2.2.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 world whitelist/blacklist).
6. Run /customtpa reload to apply changes.

---

🔗 Links

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

---

👤 Author

MrKronick
Bug reports & suggestions: Discord mrkronick