TaleFly
Flight Management for Hytale
Time or Money Based | Combat Safe | Claim Aware | Glider Protected | PlaceholderAPI
World Rules | Speed Control | Fall Damage Protection | Live Reload
Give your players flight without breaking your economy or your PvP. TaleFly turns flying into a managed resource, players spend a time bank or pay per second while they actually fly, and you get the control tools to keep it fair.
Overview
TaleFly is a premium grade flight plugin for any Hytale server that wants controlled flight:
- Flight as a resource: players burn a stored time bank first, then optionally pay money per second while flying, never while standing still.
- Fair by design: combat tagging, claim rules, world whitelists and an anti glider exploit keep flight from breaking balance.
- Safe landings: fall damage protection kicks in right after flight ends so players never get punished for it.
- Drops onto any economy: auto detects Vault, EcoAPI, Ecotale and XqediiCore, or runs time only with none installed.
- Built for dashboards: full PlaceholderAPI support for time, status, balance, cost and speed on scoreboards and HUDs.
- Owner friendly: everything is configurable, messages included, and reloads live without a restart.
Toggle Flight in a Tap
- One command, /fly, flips flight on and off (aliases: /tf, /tfly, /talefly)
- Smooth enable and disable with proper client sync, no stuck flying state
- Configurable enable, disable and out of resources messages as chat or title
Dual Resource System
- Every player has a personal flight time bank measured in seconds
- TaleFly spends stored time first, and only while the player is actively flying
- When the time bank hits zero it can optionally charge money per second instead
- Hovering idle in the air costs nothing, the meter only runs when the player really flies
Economy Support (Auto Detect, Optional)
- Detects and uses the first available supported economy automatically
- Supports VaultUnlocked, EcoAPI, Ecotale and XqediiCore
- No economy installed? Flight falls back to time only automatically, nothing breaks
- Developers can register a custom economy through the public TaleFly API
Claim and Faction Aware (Optional)
- Reads claims live as players fly and enforces your rules per region
- Works with SimpleClaims and WiFlow's Claims
- Separate allow or deny toggles for own, ally, neutral, enemy, safezone, warzone and wilderness
- A talefly.claimbypass permission lets staff fly anywhere
- Real time chunk detection disables flight the moment a player enters a forbidden claim
Combat Tag System
- Automatically disables flight when a player enters combat
- Blocks re enabling for a configurable cooldown so nobody flies away from a fight
- Independent PvP and PvE toggles
- Optionally clears the combat tag on death
Glider Protection
- Stops the classic glider exploit, players cannot swap to a glider mid flight to dodge the cost or rules
- Smart two phase handling cancels the glide, zeroes momentum and lands the player safely, no falling glitches
- Choose your enforcement: silently block the glider, or kick repeat abusers with a custom message
- Keeps working until the player is safely on the ground after flight ends
Fall Damage Protection
- Prevents fall damage right after flight is disabled, so ending flight never means taking damage
- Protection holds until the player actually touches the ground, then clears on its own
- Fully optional, switch it off in the config if you want flight to be risky
Flight Speed Control
- Players set their own speed with /fly speed <amount>
- Configurable min and max bounds keep it sane
- Gated behind its own talefly.speed permission
World Rules
- World whitelist: allow flight only in the worlds you choose
- Auto disable on world change: flight never carries over between worlds, no cross world exploits
Configurable Messages and Titles
- Every message is editable, output as chat or title per message
- Rich color tags like <gold>, <red>, <bold> and legacy & codes
- Set your own prefix once and it applies everywhere
PlaceholderAPI Support
- Auto registers when PlaceholderAPI is found, fully optional otherwise
- Surface flight time, status, balance, cost and speed on scoreboards, HUDs and menus
- Placeholder output text is itself configurable through config/placeholders
Fast, Safe Storage
- Each player's time bank is kept in a compact local database file
- Async writes with atomic saves, the world thread never blocks on disk
- Data preloads on join, so /fly status and placeholders are correct from the first second
Commands
Player (permission: talefly.use)
- /fly - Toggle your flight (aliases: /tf, /tfly, /talefly)
- /fly status - Show your flight time, balance and cost per second
- /fly speed <amount> - Set your flight speed within the configured limits (permission: talefly.speed)
Admin (permission: talefly.admin)
- /fly reload - Reload the config and messages
- /fly givetime <player> <seconds> - Add flight time to a player
- /fly settime <player> <seconds> - Set a player's flight time to an exact value
Permissions
- talefly.use - Required to use /fly and /fly status
- talefly.speed - Use /fly speed
- talefly.admin - Access to /fly reload, givetime and settime
- talefly.bypass - Fly for free, skips all time and money checks
- talefly.claimbypass - Ignore claim flight rules and fly inside any claim
Placeholders (Optional: PlaceholderAPI)
If PlaceholderAPI is installed, TaleFly registers its placeholders automatically. Output text is configurable in config/placeholders.
Use cases: scoreboards, HUDs, server UI panels and custom menus.
- %talefly_time% - remaining flight time in seconds
- %talefly_time_formatted% - mm:ss or hh:mm:ss
- %talefly_status% - true or false
- %talefly_status_formatted% - Enabled or Disabled
- %talefly_balance% - formatted balance, if an economy is present
- %talefly_cost% - cost per second from the config
- %talefly_speed% - the player's current fly speed
Configuration Highlights
TaleFly is fully configurable through its codec based config files, no coding required.
- Economy and costs: enable money, cost per second, default starting time, currency format
- World rules: allowed worlds list and auto disable on world change
- Combat tag: duration, separate PvP and PvE toggles, clear on death, disable flight on death
- Glider protection: toggle it, set a blocked message cooldown, or switch to kick mode
- Safety: fall damage protection on or off
- Speed: min and max bounds for /fly speed
- Claims: enable integration and pick exactly which region types allow flight
Pairs Perfectly With
- An economy plugin (Vault, EcoAPI, Ecotale or XqediiCore): turn flight into a money sink that drains while players fly.
- A claim plugin (SimpleClaims or WiFlow's Claims): let players fly over their own land but not raid enemies from the air.
- PlaceholderAPI: put flight time, cost and status straight onto your scoreboard or HUD.
Every integration is optional and auto detected. With none installed, TaleFly still runs as a clean time based flight plugin.
Installation
- Drop TaleFly.jar into your server's mods folder.
- Optional: install one supported economy plugin (VaultUnlocked, EcoAPI, Ecotale or XqediiCore) for money based flight.
- Optional: install a supported claim plugin (SimpleClaims or WiFlow's Claims) to enable claim flight rules.
- Optional: install PlaceholderAPI to expose flight placeholders.
- Start the server once to generate config/TaleFly, config/messages, config/placeholders and data/talefly.db.
- Tune the config to taste, then run /fly reload to apply changes without a restart.
Compatibility
New economy and claim integrations are added over time. Need one that isn't listed? Contact us trough our Discord.
