EzFlyTime

EzFlyTime is a production-ready timed-flight plugin for Minecraft servers.
Players earn or purchase vouchers to gain temporary flight. A live boss bar counts
down remaining time, particle trails add visual flair, and a GUI shop lets players
spend server currency - all configurable with YAML or MySQL storage.

Key Features

• Timed flight with a real-time boss bar countdown
• Physical voucher items with PDC-backed identity and duplicate detection
• In-game GUI shop for buying vouchers with Vault economy integration
• Configurable particle trails per player (with an unlockable shop)
• Auto-flight rewards: flat, permission-based, or tied to mcMMO skill levels
• Fuel display mode - show remaining time as a percentage instead of a countdown
• YAML or MySQL storage - easy single-server setup or cross-server database
• PlaceholderAPI support for scoreboards, chat formats, and GUIs
• Multilingual messages: English, Dutch, Spanish, French, Russian, Turkish, Chinese

---

Quick Install

1. Drop EzFlyTime-<version>.jar into your plugins/ directory.
2. Start the server to generate plugins/EzFlyTime/config.yml and related files.
3. Adjust vouchers:, bossbar:, and storage: in config.yml.
4. (Optional) Install Vault + an economy plugin to enable the voucher buy flow.
5. Run /ezflytime reload after any config edits.

---

Commands

Player commands

• /fly - Toggle flight on/off.
• /flytime - Show remaining fly time (or open the voucher GUI).
• /flyparticles - Open the particle select/shop GUI or toggle auto-equip.
• /flyvoucher buy <voucherId> [amount] - Purchase vouchers with server currency.
• /flyvoucher gui - Open the voucher shop GUI.

Admin commands

• /flytime give <player> <time> - Add flight time (e.g. 10m, 1h).
• /flytime set <player> <time> - Set a player's flight time exactly.
• /flytime remove <player> <time> - Remove flight time from a player.
• /flytime top - Show the fly-time leaderboard.
• /flyvoucher give <player> <voucherId> [amount] - Give vouchers to a player.
• /ezflytime reload - Reload all configuration files.
• /ezflytime maxsingle <player> [on|off|toggle] - Bypass the per-session cap for a player.

---

Permissions

---

Configuration highlights

Boss bar customization:

bossbar:
  enabled: true
  title: '&aFlight time remaining: {time}'
  color: GREEN
  style: SEGMENTED_10

Example voucher:

vouchers:
  basic:
    material: PAPER
    name: '&aBasic Fly Voucher'
    lore:
      - '&7Redeem for 5 minutes of flight.'
    duration-seconds: 300
    price: 1000

Display mode (time or fuel percentage):

display:
  flytime-mode: time  # 'time' or 'fuel'

---

PlaceholderAPI Placeholders

---

Integrations

• Vault / VaultUnlocked - economy abstraction for voucher purchasing
• EzEconomy - lightweight Vault-compatible economy: https://modrinth.com/plugin/ezeconomy
• PlaceholderAPI - register fly-time placeholders for scoreboards and GUIs
• mcMMO - grant flight time based on skill level thresholds

---

Language Support

Supported languages: English, Dutch, Spanish, French, Russian, Turkish, Chinese.

Set language: en (or another code) in config.yml. To add a new language, copy
messages_en.yml, rename it to messages_<code>.yml, and translate the values.

---

Links

• Documentation: https://ez-plugins.github.io/EzFlyTime/
• GitHub (source & issues): https://github.com/ez-plugins/EzFlyTime
• Modrinth: https://modrinth.com/plugin/ezflytime