⚡ SimpleTPA+ | The Ultimate Modern Teleportation System

SimpleTPA+ is a high-performance, lightweight, and feature-rich teleportation plugin built from the ground up for Paper, Purpur, and Spigot (1.19 – 1.21+). Designed to deliver a smooth, interactive, and premium player experience without bloating server resources!

---

✨ Key Highlights & Features

• 🚀 Async & Ultra-Performant: Built using modern Adventure API and Kyori components to process text, sound effects, action bars, and particle effects asynchronously with zero main-thread lag.
• 📦 Interactive Online Players GUI (/tpa): Running /tpa without arguments opens a fully paginated, dynamic inventory menu featuring online player heads, TPA status indicators, and one-click request sending!
• 💬 Clickable Interactive Chat Cards: When a player receives a TPA request, they get a beautifully formatted, embed-like chat card with clickable [ ACCEPT ] and [ DENY ] buttons featuring hover text.
• 🎵 Pitch-Scaled Audio & Particle Effects: Features progressive audio pitch scaling during countdowns, alongside fully customizable particle bursts during teleport preparation and arrival.
• ⏱️ Real-time Action Bar Countdown: Smooth visual countdown displayed directly above the player's hotbar during teleportation.
• 🛡️ Anti-Movement Safety System: Teleportation automatically cancels if the traveler moves. Both the traveler and the target player receive immediate notifications explaining why it was aborted!
• 🛑 Outgoing Request Cancellation (/tpacancel): Players can cancel their pending outgoing TPA request at any time before it expires or gets accepted.
• 🔒 Request Locking & Anti-Spam: Prevents players from spamming multiple active TPA requests. Players can only have one active outgoing request at a time until it expires, is accepted, or is rejected.
• ⚙️ Player TPA Toggle & Staff Bypass: Players can disable incoming TPA requests using /tpatoggle. Staff members with the bypass permission can still send essential requests if enabled.
• 📩 Built-in Feedback System (/tpafeedback): Allows players to submit feedback or report issues directly to developers right from in-game.
• 🛠️ 100% Fully Customizable: Every single message, prefix, button label, GUI layout, particle type, sound effect, and countdown duration can be edited in config.yml!

---

📖 How to Use SimpleTPA+ (Step-by-Step Guide)

1. Sending a Teleport Request

• Using the GUI: Type /tpa (without arguments) to open the Online Players Menu. Click on any player's head to send a request instantly!
• Direct Command: Type /tpa <player> to request a direct teleport to a specific player.
• If you already have an active request pending, the plugin will block you from sending another until the first one is resolved, canceled, or expires.

2. Accepting, Denying, or Canceling Requests

• Target Player: When someone sends you a TPA request, a custom chat card appears with interactive buttons:
  • Click [ ACCEPT ] (or type /tpaccept): Accepts the request and initiates the teleport countdown for the sender.
  • Click [ DENY ] (or type /tpdeny): Rejects the request and notifies the sender immediately.
• Sender Player: Changed your mind? Type /tpacancel to cancel your active outgoing request before it gets accepted.

3. During the Teleport Countdown

• Once accepted, a countdown (e.g., 5 seconds) appears on the sender's Action Bar accompanied by progressive audio chimes and portal particles.
• CRITICAL: The traveling player must stand completely still.
• If the player moves more than 0.2 blocks, the teleportation is instantly aborted, cancellation sounds play, and both players are notified.

4. Toggling Requests On/Off

• Type /tpatoggle (or click your own status head in the /tpa GUI) to block incoming TPA requests.
• Executing the command again will re-enable incoming requests for your account.

5. Submitting Feedback

• Type /tpafeedback <your message> to send comments or bug reports straight to the developers.

---

💻 Commands & Command Reference

Command	Description	Permission Node	Default Access
/tpa	Open online players GUI menu.	simpletpa.use	Everyone (true)
/tpa <player>	Send a direct teleport request.	simpletpa.use	Everyone (true)
/tpaccept	Accept a pending teleport request.	simpletpa.use	Everyone (true)
/tpdeny	Deny a pending teleport request.	simpletpa.use	Everyone (true)
/tpacancel	Cancel your active outgoing request.	simpletpa.use	Everyone (true)
/tpatoggle	Toggle receiving incoming TPA requests.	simpletpa.use	Everyone (true)
/tpafeedback <msg>	Send direct feedback to plugin developers.	simpletpa.use	Everyone (true)
/tpahelp	Display the interactive help menu.	simpletpa.use	Everyone (true)
/tpareload	Reload the plugin configuration in real-time.	simpletpa.admin.reload	Admins / OP

---

🔑 Permissions Guide

SimpleTPA+ uses clean, intuitive permission nodes. By default, standard player permissions are granted automatically (default: true), while administrative functions are locked to Server Operators (default: op).

Permission Node	Description	Default Access	Recommended Group
simpletpa.use	Grants access to standard commands (/tpa, /tpaccept, /tpdeny, /tpacancel, /tpatoggle, /tpahelp, /tpafeedback).	true (All Players)	Default / Member
simpletpa.admin.reload	Allows reloading the config.yml file in real-time via /tpareload.	op (Admins Only)	Admin / Owner
simpletpa.bypass.toggle	Allows sending TPA requests to players who have toggled requests off (Requires allow-bypass: true in config).	op (Admins Only)	Moderator / Admin

---

⚙️ Example Setup for Permission Managers (LuckPerms)

# For Regular Players:
/lp group default permission set simpletpa.use true

# For Staff / Moderators (Bypass Toggle):
/lp group moderator permission set simpletpa.bypass.toggle true

# For Server Admins:
/lp group admin permission set simpletpa.admin.reload true