DucksTempFly

# 🦆 DucksTempFly !(https://img.shields.io/badge/Minecraft-1.20%20--%201.21+-brightgreen?style=for-the-badge&logo=minecraft) !(https://img.shields.io/badge/Platform-Paper-blue?style=for-the-badge&logo=paper) !(https://img.shields.io/badge/Java-21-orange?style=for-the-badge&logo=openjdk) !(https://img.shields.io/badge/Dependencies-None-lightgrey?style=for-the-badge) **The coolest, most modern Temporary Flight plugin for Minecraft 1.21+** **DucksTempFly** is a lightweight, feature-rich flight plugin designed for Survival and SMP servers. It features RGB gradients, MiniMessage support, intuitive GUIs, physical flight tokens, and a smart auto-recharge system. --- ## ✨ Features * **🎨 Modern Visuals:** Full support for RGB Gradients and Hex colors via MiniMessage. * **⏱️ Time-Based Flight:** Give players flight time based on their rank (e.g., `10m`, `1h`). * **⚡ Auto-Recharge:** Flight time refills automatically every X minutes (Configurable). * **⚔️ Combat Tag:** Flight is instantly disabled if a player enters PvP combat (Configurable timer). *Note: Fighting mobs does not disable flight.* * **🪙 Flight Tokens:** Create physical items that players can redeem for extra flight time. Perfect for Crates and Vote Rewards! * **🖥️ GUI Dashboard:** A sleek inventory menu to view flight status, time remaining, and PvP status. * **📊 Action Bar HUD:** Displays a live countdown gradient while flying. * **⚙️ Fully Configurable:** Every message, timer, and item is editable. --- ## 📥 Installation 1. Download `DucksTempFly.jar`. 2. Place the file into your server's `plugins` folder. 3. **Requirement:** This plugin is built for **Paper 1.21** (or forks like Purpur). It utilizes the modern Adventure API. 4. Restart your server. 5. Configure permissions (see below). --- ## 🎮 Commands ### Player Commands | Command | Description | Permission | | :--- | :--- | :--- | | `/fly` | Toggle flight mode on/off. | `duckstempfly.limit.<time>` | | `/fly ui` | Open the Flight Status GUI. | `duckstempfly.limit.<time>` | ### Admin Commands | Command | Description | Permission | | :--- | :--- | :--- | | `/fly token <player> <time> ` | Give a physical Flight Token item. | `duckstempfly.admin` | | `/fly set <player> <time>` | Set a player's flight balance. | `duckstempfly.admin` | | `/fly add <player> <time>` | Add time to a player's balance. | `duckstempfly.admin` | | `/fly remove <player> <time>` | Remove time from a player. | `duckstempfly.admin` | | `/fly reload` | Reload the `config.yml`. | `duckstempfly.admin` | | `/fly debug` | View your current permission calculation. | `duckstempfly.admin` | --- ## 🔐 Permissions ### Flight Limits Assign these permissions to your ranks (e.g., Member, VIP) to determine their **maximum** flight capacity. The plugin automatically uses the highest time found. * `duckstempfly.limit.30s` * `duckstempfly.limit.1m` * `duckstempfly.limit.5m` * `duckstempfly.limit.10m` * `duckstempfly.limit.30m` * `duckstempfly.limit.1h` * `duckstempfly.limit.4h` *(Note: OPs automatically have infinite flight).* ### Administrative * `duckstempfly.admin` - Access to set, add, remove, token, and reload commands. --- ## 🪙 Flight Tokens You can give players items that add flight time when right-clicked. This allows players to exceed their rank limit temporarily. **Example:** ```bash /fly token primevxie 30m 1 ``` *This gives player `primevxie` 1 item that adds 30 minutes of flight time.* --- ## ⚔️ Combat Mechanics * **PvP Only:** Flight is disabled **only** when damaging another player or being damaged by another player (including arrows/tridents). * **Mob Safe:** Fighting Zombies, Skeletons, or Ender Dragons **will not** disable your flight. * **Timer:** By default, flight is disabled for 30 seconds after a hit. --- ## ⚙️ Configuration (`config.yml`) You can customize everything in the `plugins/DucksTempFly/config.yml` file. ```yaml settings: # How often (in minutes) flight time recharges for everyone recharge-minutes: 5 # How long (in seconds) flight is disabled after pvp combat-seconds: 30 # The item used for flight tokens token-material: MAGMA_CREAM messages: prefix: "<bold><gradient:#FF0080:#7928CA>DucksFly</gradient></bold> <dark_gray>» <gray>" flight-enabled: "<green>Flight enabled! <aqua>%time% <gray>remaining." no-fuel: "<red>No flight time! Next recharge in: <yellow>%time%" # ... (Full list in generated file) visuals: action-bar: "<gradient:#FF0080:#7928CA><b>⚡ Flight Time: %time% ⚡</b></gradient>" gui-title: "<!i><gradient:blue:cyan>Flight Status</gradient>" ``` ### Formatting Info We use **MiniMessage** format. * Colors: `<red>`, `<#ff0000>` * Gradients: `<gradient:red:blue>Text</gradient>` * Styles: `<bold>`, `<italic>`, `<!i>` (Remove italics) --- **Made with 🦆 by Duckalds**