CustomTPA

🌐 CustomTPA — Beautiful Teleport Requests

MrKronick Author: MrKronick | Version: X.X.X | Core: Paper 1.21.x

---

✨ Features

- 💬 Quick reload — When prompted, the player sees clickable `[✔ Accept]` and `[✘ Decline]` buttons (on a separate line) - 🖼️ Quick reload — `/tpa gui` opens the inventory with player heads and buttons - ⏳ Quick reload — a configurable countdown (default 3 seconds) displayed in the ActionBar - 🎨 Quick reload — support for gradients, rainbows, hex colors (`<#ff5555>`), hover, and clicks - 🔤 Quick reload — you can use `&a`, `&l`, `§a`, `§l`, `&#RRGGBB` — the plugin automatically converts everything - 🔄 Quick reload — show prefixes and suffixes of Quick reload via `%other_luckperms_prefix%` and `%other_luckperms_suffix%` - 📁 Quick reload — all messages and colors are editable in a single `messages.yml` file - 🔁 Quick reload — 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

- LuckPerms or later (required) - LuckPerms (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.