FancyTPA

--- # ✨ 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 **** or **** 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 ` | Accept a pending request (or the last one). | `ftpa.player.tpaccept` | | `/tpdeny ` | 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 ` | 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`. ---