🧭 TPAPLUS — Advanced Commercial-Grade Teleportation & Request Suite

TPAPLUS is a next-generation, high-performance teleportation plugin built for modern Paper, Purpur, and Spigot servers (1.18 – 1.21+). Designed to replace outdated TPA plugins, it delivers interactive chat actions, customizable GUI dashboards, built-in PvP combat tagging, player blocklists, claim protection hooks, safe landing invulnerability, and SQLite/MySQL database synchronization.

Engineered with zero exploits, enterprise-grade safety, sub-millisecond performance, and 100% customization.

---

🌐 Try It Yourself

You can experience TpaPlus exactly as intended by joining HYDRAZ Network:

Server Address
play.hydraz.online

---

⚡ Key Highlights & Core Features

⚔️ Built-In Combat Tagging (PvP Escape Prevention)

• Automatically detects when a player deals or takes damage in combat.
• Prevents players from exploiting /tpa or /tpaccept to escape during PvP fights.
• Active teleport countdowns are instantly cancelled if the player is attacked.

🚫 Player Blocklist System (/tpablock & /tpaunblock)

• Allows players to block specific toxic players or spammers from sending them teleport requests.
• Blocklists are saved permanently across server restarts via SQLite or MySQL.
• View currently blocked players anytime with /tpablocklist.

🛡️ Safe Landing Invulnerability & Safety Scanner

• Anti-Suffocation / Anti-Fall: Grants a configurable grace period (default: 3s) of damage immunity upon landing to protect players from chunk loading lag and fall damage.
• Safe Location Scanner: Automatically detects dangerous blocks (lava, void, fire, suffocation) and redirects the player to the nearest safe solid ground.

📊 Kyori Adventure BossBar & 3D Spiral Visuals

• Smooth, second-by-second Adventure BossBar countdown (5s -> 4s -> 3s...).
• Rotating 3D particle spirals around the teleporting player during warmup delay.
• Purely visual arrival lightning flash (strikeLightningEffect) and firework particles with zero player damage.

👑 VIP Permission Tiers (Delays & Cooldowns)

• Monetize rank perks by setting custom cooldowns and warmup delays based on permissions (e.g. aiotpa.delay.vip, aiotpa.cooldown.mvp, aiotpa.bypass.delay).

📦 Interactive GUI Dashboard & Direct Chat Flows

• Instant or GUI: Choose between direct chat requests or interactive GUI confirmation menus (use-request-gui and use-accept-gui).
• Request Dashboard (/tpalist): Interactive chest GUI displaying incoming and outgoing requests with live player heads, stats, and expiration timers.
• Hover & Clickable Chat: Beautiful chat prompts with interactive [Accept], [Deny], and [Cancel] buttons.

🌐 Cross-Server Storage (SQLite & MySQL)

• Built-in support for standard local SQLite (data.db) or high-performance cross-network MySQL synchronization.
• All queries run asynchronously off the main thread to ensure 20.0 TPS.

🔗 Deep Hook Integrations

• WorldGuard 7.x: Enforces region entry and teleport flags.
• GriefPrevention: Prevents teleporting into claims unless trusted or invited by the claim owner.
• Vault & Economy: Charge money/XP fees for teleports with automatic refunds if cancelled, plus /tpcoolby to bypass cooldowns for a fee.
• PlaceholderAPI: Live coin balances, economy stats, and kill counters in GUI lore.

---

💻 Commands & Permissions

🚶 Player Teleport Commands

Command	Permission	Description
/tpa <player>	aiotpa.use	Send a teleport request to a player
/tpahere <player>	aiotpa.use	Request a player to teleport to your location
/tpaccept [player]	aiotpa.use	Accept an incoming teleport request
/tpdeny [player]	aiotpa.use	Deny an incoming teleport request
/tpcancel [player]	aiotpa.use	Cancel a sent outgoing teleport request
/tpalist	aiotpa.use	Open the interactive requests dashboard GUI
/tpcoolby	aiotpa.use	Bypass active request cooldown by paying a fee

⚙️ Player Settings & Blocklist Commands

Command	Permission	Description
/tpaauto	aiotpa.autoaccept	Toggle auto-accepting all incoming requests
/tpatoggle	aiotpa.toggle	Toggle incoming /tpa requests on or off
/tpaheretoggle	aiotpa.toggle	Toggle incoming /tpahere requests on or off
/tpablock <player>	aiotpa.block	Block a player from sending you requests
/tpaunblock <player>	aiotpa.block	Unblock a player
/tpablocklist	aiotpa.block	View your list of blocked players

🛠️ Admin & Event Commands

Command	Permission	Description
/tpall	aiotpa.admin.all	Send teleport requests to all online players
/tpahereall	aiotpa.admin.all	Invite all online players to teleport to you
/tpareload	aiotpa.admin	Hot-reload all configuration and database settings

---

🔐 Administrative & Bypass Permissions

Permission	Default	Description
aiotpa.use	true	Access to core TPA commands
aiotpa.autoaccept	true	Access to /tpaauto
aiotpa.toggle	true	Access to /tpatoggle and /tpaheretoggle
aiotpa.block	true	Access to player blocklist commands
aiotpa.admin	op	Access to administrative reload commands
aiotpa.admin.all	op	Access to /tpall and /tpahereall
aiotpa.bypass.cooldown	op	Bypass request cooldowns completely
aiotpa.bypass.delay	op	Instant teleports (bypasses warmup delays)
aiotpa.bypass.toggle	op	Request players who have toggled requests off
aiotpa.bypass.block	op	Request players who have blocked you
aiotpa.bypass.combat	op	Teleport while in combat
aiotpa.bypass.world	op	Teleport in blacklisted/disabled worlds
aiotpa.bypass.cost	op	Bypass economy money and XP costs

---

🎨 Fully Configurable in tpa.yml

• 100% Customizable Texts: Supports legacy & codes, hex colors (&#RRGGBB), and Kyori Adventure MiniMessage tags.
• Sound Effects: Every single action has configurable sound, volume, and pitch (or set to none).
• GUI Customization: Change titles, sizes, slots, materials, custom model data, and lore.
• Warmup & Cooldown Tiers: Configure custom rank delays easily in seconds.

---

📋 Compatibility & Requirements

• Minecraft Versions: 1.21.x (Backwards compatible with 1.18.2 – 1.20.x)
• Server Software: Paper, Purpur, Pufferfish, Spigot, Folia
• Java Runtime: Java 21+