✨ SparkTPA

A modern, feature-rich teleport request plugin for Paper, Spigot, and Purpur servers. SparkTPA replaces outdated TPA systems with beautiful GUIs, clickable chat buttons, BossBar warmups, sounds, titles, particle effects, and a fully customizable experience.

🚀 Features

• 📨 Send teleport requests with /tpa
• 📍 Request players to teleport to you with /tpahere
• 🌐 Request all online players with /tpahereall
• 🖱️ Modern GUI Accept/Deny menu
• 💬 Clickable chat buttons
• ⏳ Teleport warmup system
• 📊 BossBar teleport countdown
• 🔊 Custom sounds with SoundManager caching
• ✨ Particle effects for teleport events
• 🎨 MiniMessage support
• 📢 Titles & ActionBars
• 🔇 Ignore specific players
• 🔒 Toggle incoming requests
• 🛡️ Anti-spam protection with CooldownManager
• ⚡ Lightweight & optimized with batch async saving
• 🔧 Fully configurable
• 🚨 Teleport safety checks (lava, magma, campfire, void, solid blocks)
• 🔄 Modrinth update checker (OP-only notifications)
• 📝 Tab completion for all commands

---

📖 Commands

Command	Description
/tpa <player>	Send a teleport request
/tpahere <player>	Ask a player to teleport to you
/tpahereall	Request all online players
/tpaccept <player>	Accept a request
/tpadeny <player>	Deny a request
/tpacancel	Cancel an outgoing request
/tpaignore <player>	Ignore/unignore a player
/tpatoggle	Toggle all incoming requests
/sparktpa reload	Reload configuration files

---

🔑 Permissions

Permission	Use
sparktpa.tpa	Use /tpa
sparktpa.tpahere	Use /tpahere
sparktpa.tpahereall	Use /tpahereall
sparktpa.accept	Use /tpaccept
sparktpa.deny	Use /tpadeny
sparktpa.cancel	Use /tpacancel
sparktpa.ignore	Use /tpaignore
sparktpa.toggle	Use /tpatoggle
sparktpa.admin	Access admin commands
sparktpa.bypasscooldown	Bypass request cooldowns
sparktpa.bypassdelay	Bypass teleport warmups
sparktpa.safety.bypass	Bypass teleport safety checks

---

⚙️ Configuration

SparkTPA is fully configurable:

• 🎨 Messages with MiniMessage formatting
• 🔊 Sounds with SoundManager caching
• ⏳ Cooldowns with centralized CooldownManager
• ⏰ Request expiration
• 📊 BossBar settings (color, style, title, sounds)
• 🖱️ GUI settings (title, accept/deny items)
• 📢 Titles & ActionBars
• 🚀 Teleport warmups
• ✨ Particle effects (request-sent, request-accepted, request-denied, teleport, arrival)
• 🛡️ Safety checks (lava, magma, campfire, void, solid blocks)
• 🔄 Update checker (Modrinth integration)

---

📦 Supported Versions

• Paper 1.21+
• Purpur 1.21+
• Spigot 1.21+

---

🔧 Installation

1. Download the latest sparktpa-1.0.0.jar
2. Place it in your server's plugins folder
3. Restart your server
4. Configure the plugin in plugins/SparkTPA/config.yml and plugins/SparkTPA/messages.yml

---

⚡ Performance Optimizations

SparkTPA is optimized for small servers and SMPs:

• 🔄 Single cleanup task for request expiration (instead of per-request tasks)
• 💾 Batch async saving every 5 minutes (reduces disk I/O)
• 🔊 SoundManager caching (avoids repeated enum lookups)
• 🚫 Particle effects disabled by default (can be enabled in config)
• ⚡ Removed unnecessary synchronization (ConcurrentHashMap is thread-safe)
• 📦 Lightweight memory footprint
• 🎯 Minimal CPU overhead

---

Made with ❤️ by PavitraXD