---

✨ FancyTPA

FancyTPA is a fancy, modern, lightweight, and highly customizable teleportation plugin designed for Minecraft servers from 1.19.4 to 1.21.11. It replaces the clunky, old-school teleportation commands with a sleek, interactive, and visually stunning experience.

---

🚀 Core Features

• Interactive Chat Components: No more typing long commands! Players can click [Accept] or [Deny] buttons directly in the chat with hover tooltips.
• Visual Implosion/Explosion Effects: Every teleportation features a fancy "Enderman-style" particle effect where particles collapse into the player at the start and burst out at the destination.
• Smart Teleport Timer: Optional countdown (default 5s) that cancels if the player moves, preventing combat-logging or escaping danger too easily.
• Action Bar Integration: The teleport countdown is displayed elegantly above the hotbar, keeping the chat clean.
• Admin Overlays: Includes a custom /tp and /tphere system that bypasses timers but keeps the beautiful visual effects.
• Mass Teleportation: Admins can summon everyone (/tphere all) or everyone from a specific dimension.
• Full Customization: 100% of messages, sounds, particles, and permissions can be edited in the config.yml.

---

📜 Command List & Permissions

👤 Player Commands

Command	Description	Permission
/tpa <player>	Send a teleport request to a player.	ftpa.player.tpa
/tpahere <player>	Request a player to teleport to you.	ftpa.player.tpahere
/tpaccept [player]	Accept a pending request (or the last one).	ftpa.player.tpaccept
/tpdeny [player]	Refuse a pending request.	ftpa.player.tpdeny
/tpahelp	Show the interactive help menu.	ftpa.player.help

🛠️ Admin Commands

Command	Description	Permission
/tp <player>	Instant teleport with custom effects.	ftpa.admin.tp
/tphere <player>	Instantly summon a player to your location.	ftpa.admin.tphere
/tphere all [world]	Summon everyone (optionally from one world).	ftpa.admin.tphereall
/ftpa reload	Reload the configuration files.	ftpa.admin.reload
Admin All	Access to every FancyTPA feature.	ftpa.admin.*

---

⚙️ How it Works

1. Requesting: When a player sends a request, the recipient sees a formatted message with clickable buttons.
2. Validation: The plugin checks if the command is enabled in the config and if the player has the required permission.
3. The Countdown: If enabled, the sender must stand still. Moving will trigger a "Teleport Cancelled" notification on the Action Bar.
4. The Effect: Upon success, a "Portal" particle implosion occurs at the start location, followed by an explosion at the target.

---

🛠️ Installation

1. Download the FancyTPA.jar.
2. Drop it into your server's /plugins/ folder.
3. Restart your server (Java 17+ required).
4. Configure messages and timers in plugins/FancyTPA/config.yml.

---