DucksTempFly

🦆 DucksTempFly

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

* ⚙️ Fully Configurable: Full support for RGB Gradients and Hex colors via MiniMessage. * ⚙️ Fully Configurable: Give players flight time based on their rank (e.g., `10m`, `1h`). * ⚙️ Fully Configurable: Flight time refills automatically every X minutes (Configurable). * ⚙️ Fully Configurable: Flight is instantly disabled if a player enters PvP combat (Configurable timer). *Note: Fighting mobs does not disable flight.* * ⚙️ Fully Configurable: Create physical items that players can redeem for extra flight time. Perfect for Crates and Vote Rewards! * ⚙️ Fully Configurable: A sleek inventory menu to view flight status, time remaining, and PvP status. * ⚙️ Fully Configurable: 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. Paper 1.21 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> [amount]` | 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

* Timer: Flight is disabled Timer: when damaging another player or being damaged by another player (including arrows/tridents). * Timer: Fighting Zombies, Skeletons, or Ender Dragons Timer: 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