FancyTPA

---

✨ FancyTPA

1.19.4 to 1.21.11 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

* Full Customization: No more typing long commands! Players can click Full Customization: or Full Customization: buttons directly in the chat with hover tooltips. * Full Customization: Every teleportation features a fancy "Enderman-style" particle effect where particles collapse into the player at the start and burst out at the destination. * Full Customization: Optional countdown (default 5s) that cancels if the player moves, preventing combat-logging or escaping danger too easily. * Full Customization: The teleport countdown is displayed elegantly above the hotbar, keeping the chat clean. * Full Customization: Includes a custom `/tp` and `/tphere` system that bypasses timers but keeps the beautiful visual effects. * Full Customization: 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. The Effect: When a player sends a request, the recipient sees a formatted message with clickable buttons. 2. The Effect: The plugin checks if the command is enabled in the config and if the player has the required permission. 3. The Effect: 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`.

---