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.** !(https://img.shields.io/bstats/servers/32220?label=Servers&style=flat-square) !(https://img.shields.io/bstats/players/32220?label=Players&style=flat-square) --- ## ✨ 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 ``, ``, and `` 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 ` | Accept a request (or select from list) | | `/tpadeny ` | 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 (70 languages): - 🇬🇧 English (`en`) - 🇷🇺 Russian (`ru`) - 🇺🇦 Ukrainian (`uk`) - 🇩🇪 German (`de`) - 🇫🇷 French (`fr`) - 🇪🇸 Spanish (`es`) - 🇧🇷 Portuguese, Brazil (`pt_br`) - 🇵🇹 Portuguese, Portugal (`pt`) - 🇹🇷 Turkish (`tr`) - 🇮