✨ 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.