SparkTPA

<div align="center"> # ⚡ SparkTPA **A sleek, DonutSMP-inspired TPA plugin for Paper/Purpur servers! 🍩✨** <img src="https://img.shields.io/badge/MC-1.21.x-green?style=for-the-badge" alt="MC Version"> <img src="https://img.shields.io/badge/Platform-Paper/Purpur-blue?style=for-the-badge" alt="Platform"> <img src="https://img.shields.io/badge/Author-PavitraXD-orange?style=for-the-badge" alt="Author"> </div> --- ## 📖 About SparkTPA is a **lightweight**, **modern**, and **feature-packed** teleport request plugin for Minecraft 1.21.x servers. Inspired by the iconic **DonutSMP** style — it features a sleek auto-opening accept/deny GUI, clean black glass layouts, player head info cards, emoji-rich messages, and smooth sound & particle effects. ⚡✨ --- ## ✨ Features - 🍩 **DonutSMP-Style GUI** — Clean black glass layout with player heads, green/red wool buttons - 🔔 **Auto-Opening Popup** — Accept/deny GUI pops up automatically when you receive a TPA request - 🧑 **Player Info Cards** — See requester's world, health, and TPA type in the GUI - 🚀 **TPA & TPA Here** — Send and receive teleport requests - 📡 **TPA Here All** — Send TPA Here to every online player at once - ✅ **Accept / Deny / Accept All / Deny All** — Full control over requests via GUI or commands - 🔕 **Toggle TPA** — Disable/enable incoming requests anytime - 🚫 **Block Players** — Block specific players from sending TPA - 📋 **Request List** — View all pending requests in a styled chat list - ⏱️ **Configurable Countdown** — Customizable teleport delay with action bar timer - 🚶 **Cancel on Move/Damage** — Prevents teleportation abuse - 🎵 **Sound Effects** — Satisfying sounds on every action - ✨ **Particle Effects** — End rod particles on teleport - 🎨 **Colorful Messages** — Beautiful emoji-rich chat messages - 📝 **Fully Customizable** — All messages in `messages.yml`, all settings in `config.yml` - 🔧 **Easy Config** — Simple and clean out-of-the-box configuration - 📑 **Tab Completion** — Auto-complete player names in all commands --- ## 🍩 GUI Preview ### Accept/Deny Popup (auto-opens on request) !(https://cdn.modrinth.com/data/KwMOHcz2/images/16d1a35bb56114af9e8f478d05d4f51f2ea64611.png) - 🧑 **Player head** in center with name, world, health & TPA type - 🟩 **Green wool** = Accept (left-click) - 🟥 **Red wool** = Deny (right-click) - ⬛ **Black glass** background — clean & minimal ### Multi-Request Popup When you have multiple pending requests, a 5-row menu opens with all player heads. Left-click to accept, right-click to deny. Includes **Accept All** 🟩 and **Deny All** 🟥 buttons. --- ## 🎮 Commands | Command | Description | Permission | |---|---|---| | `/tpa <player>` | 🚀 Send a teleport request to a player | `sparktpa.tpa` | | `/tpa gui` | 🖥️ Open the TPA GUI menu | `sparktpa.tpa` | | `/tpahere <player>` | 📍 Request a player to come to you | `sparktpa.tpahere` | | `/tpahereall` | 📡 Send TPA Here to ALL online players | `sparktpa.tpahereall` | | `/tpaccept ` | ✅ Accept a TPA request (latest if no name) | `sparktpa.tpaccept` | | `/tpaccept all` | ✅ Accept all pending requests | `sparktpa.tpaccept` | | `/tpaccept gui` | 🍩 Open Donut-style request popup | `sparktpa.tpaccept` | | `/tpadeny ` | ❌ Deny a TPA request (latest if no name) | `sparktpa.tpadeny` | | `/tpadeny all` | ❌ Deny all pending requests | `sparktpa.tpadeny` | | `/tpacancel ` | 🔄 Cancel your sent request | `sparktpa.tpacancel` | | `/tpatoggle` | 🔕 Toggle TPA on/off | `sparktpa.tpatoggle` | | `/tpalist` | 📋 List pending requests in chat | `sparktpa.tpalist` | | `/tpablock <player>` | 🚫 Block a player from TPA | `sparktpa.tpablock` | | `/tpaunblock <player>` | ✅ Unblock a player | `sparktpa.tpaunblock` | | `/sparktpa help` | ❓ View all commands | *(everyone)* | | `/sparktpa reload` | 🔧 Reload configs | `sparktpa.admin` | --- ## 🔑 Permissions | Permission | Default | Description | |---|---|---| | `sparktpa.tpa` | ✅ Everyone | Use `/tpa` command | | `sparktpa.tpahere` | ✅ Everyone | Use `/tpahere` command | | `sparktpa.tpahereall` | ✅ Everyone | Use `/tpahereall` command | | `sparktpa.tpaccept` | ✅ Everyone | Accept TPA requests | | `sparktpa.tpadeny` | ✅ Everyone | Deny TPA requests | | `sparktpa.tpacancel` | ✅ Everyone | Cancel sent requests | | `sparktpa.tpatoggle` | ✅ Everyone | Toggle TPA on/off | | `sparktpa.tpalist` | ✅ Everyone | List pending requests | | `sparktpa.tpablock` | ✅ Everyone | Block players | | `sparktpa.tpaunblock` | ✅ Everyone | Unblock players | | `sparktpa.admin` | 🔑 OP only | Reload & admin commands | | `sparktpa.bypass.block` | 🔑 OP only | Bypass player blocks | | `sparktpa.bypass.delay` | 🔑 OP only | Skip teleport delay | | `sparktpa.bypass.cooldown` | 🔑 OP only | Bypass cooldowns | --- ## ⚙️ Configuration ### config.yml ```yaml settings: request-timeout: 60 # ⏱️ Seconds before request expires teleport-delay: 5 # ⏳ Seconds before teleport (0 = instant) cancel-on-move: