TimedFlyX – Controlled Temp Flight Perks ✈️ Safe, Configurable, Async ✅ [1.12 – 1.21+] icon

TimedFlyX – Controlled Temp Flight Perks ✈️ Safe, Configurable, Async ✅ [1.12 – 1.21+] -----

Enable been able to add fly time directly to a player! (Essentially Temp Fly)



TimedFlyX - Official Documentation
Install, configure, and control time-based flight on your server


Installation
  • Drop TimedFlyX.jar into your /plugins folder
  • Start or reload your server
  • Edit
    Code (Text):
    config.yml
    and
    Code (Text):
    lang.yml
    to match your needs
  • (Optional) Install PlaceholderAPI for placeholders
  • (Optional) Install Vault for GUI shop and players buying fly time


Code (Text):

# -----------------------
# TimedFlyX Configuration
# -----------------------

# Default flight time given to new players
# Format: m = minutes, h = hours, d = days (e.g. 30m, 1h, 2d)
default-time: 30m

# Storage type for saving player fly times
# Options:
#   - sqlite: Uses local file-based storage
#   - sql:    Uses a MySQL database (requires configuration below)
storage: sqlite

# SQL database connection settings (used only if storage is set to 'sql')
sql:
  host: localhost          # MySQL server hostname
  port: 3306               # MySQL server port
  database: minecraft      # Database name
  username: root           # Database username
  password: password       # Database password

# Safe mode configuration
# After fly time ends, players get temporary invincibility (to avoid fall damage)
safe-mode-duration: 10       # Time in seconds for safe mode after flight ends
safe-mode-warn-before: 3     # Warn players before safe mode ends (in seconds)

# Disables flying during PvP combat
pvp-disable:
  enabled: true              # If true, disables flight while in combat

# Shows fly timer as an actionbar message (while flying)
actionbar-timer: true        # Enable/disable action bar display of fly time

# Daily fly time reward for players with permission: timedfly.daily
daily-reward:
  enabled: true              # Enables daily flight time reward
  amount: 30m                # Amount of time rewarded per day (same format as default-time)
# Enable or disable the fly shop (Essentially allowing players to buy temp fly time in game)
fly-shop:
  enabled: true
  title: "&b&lFly Time Shop"
  rows: 3
  sounds: # Change sounds to your liking!
    open: BLOCK_CHEST_OPEN
    close: BLOCK_CHEST_CLOSE
    success: ENTITY_EXPERIENCE_ORB_PICKUP
    failure: BLOCK_NOTE_BLOCK_BASS
  options:
    1:
      duration: "1m"
      cost: 500
      item: CLOCK
      name: "&eBuy 1 Minute"
      lore:
        - "&7Purchase 1 minute of fly time"
        - "&eCost: $500"
    2:
      duration: "10m"
      cost: 3000
      item: CLOCK
      name: "&aBuy 10 Minutes"
      lore:
        - "&7Purchase 10 minutes of fly time"
        - "&aCost: $3000"
    3:
      duration: "1h"
      cost: 10000
      item: NETHER_STAR
      name: "&bBuy 1 Hour"
      lore:
        - "&7Purchase 1 hour of fly time"
        - "&bCost: $10000"
[/code]
→ Tweak storage, safe-mode timing, daily bonuses, and PvP rules

Code (Text):

# --------------------------
# TimedFlyX Language File
# --------------------------

# Prefix used at the start of all messages
prefix: "&7[&bTimedFlyX&7] &r"

messages:
  # Message shown when player has 0 fly time
  no-time: "%prefix%&cYou have no fly time remaining!"

  # Message shown when flight is toggled on
  fly-enabled: "%prefix%&aFlight enabled. Time left: {time}"

  # Message shown when flight is toggled off
  fly-disabled: "%prefix%&eFlight disabled."

  # Message showing remaining fly time
  time-left: "%prefix%&6You have &e{time} &6of flight remaining."

  # Message when safe mode activates after losing flight
  safe-mode-started: "%prefix%&eYou are in safe mode until you land or {seconds}s pass..."

  # Message when safe mode expires due to timer
  safe-mode-ended: "%prefix%&cSafe mode expired."

  # Message when safe mode ends by landing
  safe-mode-disabled: "%prefix%&aSafe mode disabled."

  # Message warning that safe mode is about to expire
  safe-mode-warning: "%prefix%&cSafe mode ending in {seconds} seconds!"

  # Shown when non-player tries to use a player-only command
  only-players: "%prefix%&cOnly players can use this command."

  # Generic no-permission message
  no-permission: "%prefix%&cYou do not have permission to do that."

  # Message when target player is not found
  player-not-found: "%prefix%&cPlayer not found."

  # Usage message for /timedfly admin command
  usage-timedfly: "%prefix%&eUsage: /timedfly <add|set|remove> <player> <time>"

  # Message when admin inputs an invalid time format
  invalid-time-format: "%prefix%&cInvalid time format. Use 10m, 1h, 2d, etc."

  # Confirmation messages for admin actions
  time-added: "%prefix%&aAdded {time} to {player}."
  time-set: "%prefix%&aSet {player}'s time to {time}."
  time-removed: "%prefix%&aRemoved {time} from {player}."

  # Message when an unknown action is used in /timedfly
  unknown-action: "%prefix%&cUnknown action. Use add, set or remove."

  # Inform player they’re already in creative mode
  already-creative: "%prefix%&eYou are in creative mode and already can fly."

  # Message when a player receives daily reward
  daily-reward: "%prefix%&aYou received your daily fly reward of {time}!"

  # Message after reloading config
  reloaded: "%prefix%&aTimedFlyX configuration reloaded!"

  # Message when PvP disables flying
  pvp-fly-disabled: "%prefix%&cFlight disabled due to PvP!"

  # Help messages for players and admins
  admin-help:
    - "%prefix%&6User Commands:"
    - "&e/fly &7- Toggle flight if time remains"
    - "&e/flytime &7- Check your remaining fly time"
    - ""
    - "&6Admin Commands:"
    - "&eTime formats: 10m, 1h, 2d (chainable)"
    - "&e/timedfly add <player> <time> &7- Add time to a player"
    - "&e/timedfly set <player> <time> &7- Set exact fly time"
    - "&e/timedfly remove <player> <time> &7- Subtract time from player"
    - "&e/timedflyreload &7- Reloads configuration files"

 
→ Fully editable and translatable


Code (Text):

%timedfly_time%      - Shows formatted remaining time (e.g. 1h 30m)
%timedfly_seconds%   - Shows raw seconds remaining
 
→ Optional, but useful for scoreboards or menus


/timedfly help displays:
Code (Text):

%prefix%&6TimedFly User Commands:
 /fly       - Toggle flight if time remains
 /flytime   - Check remaining fly time

%prefix%&6TimedFly Admin Commands:
 /timedfly add <player> <time> - Add time
 /timedfly set <player> <time> - Set exact time
 /timedfly remove <player> <time> - Remove time
 Time formats: 10m, 1h, 2d (chainable)
 

Notes
  • Safe-mode keeps players alive when fly expires mid-air
  • MySQL or SQLite support, stored per UUID
  • Fly time does not persist in creative mode
  • PvP instantly disables flight to prevent abuse
  • Messages and logic are 100% configurable

For support, bug reports, or feature suggestions, use the Spigot Discussion tab
Resource Information
Author:
----------
Total Downloads: 154
First Release: May 4, 2025
Last Update: May 13, 2025
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings