🌐 CustomTPA — Beautiful Teleport Requests

A convenient plugin for teleport requests with chat buttons, a graphical menu, and full support for MiniMessage, PlaceholderAPI, and classic colors. Author: MrKronick | Version: X.X.X | Core: Paper 1.21.x

---

✨ Features

• 💬 Chat Buttons — When prompted, the player sees clickable [✔ Accept] and [✘ Decline] buttons (on a separate line)
• 🖼️ GUI — /tpa gui opens the inventory with player heads and buttons
• ⏳ Teleport Delay — a configurable countdown (default 3 seconds) displayed in the ActionBar
• 🎨 MiniMessage and RGB — support for gradients, rainbows, hex colors (<#ff5555>), hover, and clicks
• 🔤 Classic Colors — you can use &a, &l, §a, §l, &#RRGGBB — the plugin automatically converts everything
• 🔄 PlaceholderAPI + LuckPerms — show prefixes and suffixes of another player via %other_luckperms_prefix% and %other_luckperms_suffix%
• 📁 Flexible customization — all messages and colors are editable in a single messages.yml file
• 🔁 Auto-disable requests — requests are automatically canceled after 60 seconds
• ⚡ Quick reload — /customtpa reload applies changes without restarting the server

---

📋 Commands

Command	Description
/tpa <player>	Send a teleport request to a player
/tpahere <player>	Invite a player to your place
/tpaccept [player]	Accept a request (you can specify a specific player)
/tpadeny [player]	Reject a request (aliases: /tpno, /tpad deny)
/tpcancel	Cancel your outgoing request
/tpatoggle	Enable/disable accepting requests
/tpa gui	Open a graphical menu with a list of requests
/customtpa reload	Reload the configuration (/ctpa)

---

📦 Dependencies

• Paper 1.21.11 or later (required)
• PlaceholderAPI (optional) — for placeholders in messages
• LuckPerms (optional) — for displaying prefixes/suffixes

The plugin works without them, but with them, full functionality is unlocked.

---

🎨 Color and Formatting Support

CustomTPA understands all popular formats simultaneously:

• MiniMessage: <green>Text</green>, <gradient:#ffef99:#ffd700>ʟᴇɢᴇɴᴅᴀ</gradient>, <rainbow>Rainbow</rainbow>
• Classic & codes: &aHello, &lBold
• Paragraph symbol: §lBold
• Hex via &#RRGGBB: &#FF5500Orange

You can combine everything in one message!

---

🛠️ Setup

1. Upload CustomTPA-X.X.X.jar to the server's plugins folder
2. Restart the server (or use PlugMan)
3. Edit plugins/CustomTPA/messages.yml to suit your needs
4. Run /customtpa reload - the changes will apply instantly

Placeholder Examples (PlaceholderAPI)

In messages.yml, you can use:

• %other_name% - another player's nickname
• %other_luckperms_prefix% - their prefix
• %other_luckperms_suffix% - their suffix
• %other_vault_rank% - a Vault group and any other

All regular %...% refer to the message recipient, and %other_...% refer to other to the player (sender or target).

---

👤 Author

MrKronick Thanks for using this! If you have any ideas or bugs, please let me know in the comments.