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

ServerVersion: >=0.5.0 (Hytale Update 5)
Optional Dependencies: VaultUnlocked, EcoAPI, Ecotale, XqediiCore, SimpleClaims, WiFlow's Claims, PlaceholderAPI

New economy and claim integrations are added over time. Need one that isn't listed? Contact us trough our Discord.