# 🦆 DucksTempFly ![Minecraft Version](https://img.shields.io/badge/Minecraft-1.20%20--%201.21+-brightgreen?style=for-the-badge&logo=minecraft) ![Platform](https://img.shields.io/badge/Platform-Paper-blue?style=for-the-badge&logo=paper) ![Java](https://img.shields.io/badge/Java-21-orange?style=for-the-badge&logo=openjdk) ![Dependencies](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.` | | `/fly ui` | Open the Flight Status GUI. | `duckstempfly.limit.` | ### Admin Commands | Command | Description | Permission | | :--- | :--- | :--- | | `/fly token [amount]` | Give a physical Flight Token item. | `duckstempfly.admin` | | `/fly set ` | Set a player's flight balance. | `duckstempfly.admin` | | `/fly add ` | Add time to a player's balance. | `duckstempfly.admin` | | `/fly remove ` | 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: "DucksFly » " flight-enabled: "Flight enabled! %time% remaining." no-fuel: "No flight time! Next recharge in: %time%" # ... (Full list in generated file) visuals: action-bar: "⚡ Flight Time: %time% ⚡" gui-title: "Flight Status" ``` ### Formatting Info We use **MiniMessage** format. * Colors: ``, `<#ff0000>` * Gradients: `Text` * Styles: ``, ``, `` (Remove italics) --- **Made with 🦆 by Duckalds**

DucksTempFly

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

Flight Tokens

Banner

No Fuel