SparkTPA

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper purpur spigot

标签： game-mechanics transportation utility

# ⚡ 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.