🦆 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

• 🎨 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> [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:

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

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