⚡ SparkTPA

A sleek, DonutSMP-inspired TPA plugin for Paper/Purpur servers! 🍩✨

📖 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)

• 🧑 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

🔑 Permissions

⚙️ Configuration

config.yml

settings:
  request-timeout: 60        # ⏱️ Seconds before request expires
  teleport-delay: 5          # ⏳ Seconds before teleport (0 = instant)
  cancel-on-move: true       # 🚶 Cancel teleport if player moves
  cancel-on-damage: true     # 💥 Cancel teleport if player takes damage
  max-pending-requests: 5    # 📋 Max requests per player
  enable-sounds: true        # 🎵 Play sounds on actions
  enable-particles: true     # ✨ Show particles on teleport
  enable-gui: true           # 🍩 Enable Donut-style GUI (auto-popup)
  block-bypass-permission: true # 🔑 Allow bypass permission

messages.yml

All messages are fully customizable with color codes (&), hex colors (&#RRGGBB), and emoji support! ✨

📦 Installation

1. ⬇️ Download the latest SparkTPA-x.x.x.jar
2. 📂 Place it in your server's plugins/ folder
3. 🔄 Restart or reload your server
4. ✅ Done! TPA requests will auto-open the Donut-style GUI ⚡

💡 Usage Tips

• 🍩 When someone sends you a TPA, the accept/deny popup opens automatically!
• 📡 Use /tpahereall to send TPA Here to everyone online at once
• 🖥️ Type /tpa gui to open the main SparkTPA menu
• 📋 Use /tpalist to see all pending requests in a styled list
• ✅ Use /tpaccept without arguments to accept the latest request
• ❌ Use /tpadeny all to quickly deny all pending requests
• 🔕 Use /tpatoggle when you don't want to be disturbed
• 🚫 Use /tpablock to stop specific players from sending requests

🛠️ Requirements

• ☕ Java 21+
• 📄 Paper 1.21.x or Purpur 1.21.x

📝 License

This project is licensed under the MIT License.