Weapon Flow replaces Hytale's native hit-to-charge weapon ability system with rank-based time cooldowns configured through LuckPerms, so special attacks recharge automatically over time instead of requiring combat hits.
WeaponFlow replaces Hytale's native hit-to-charge weapon ability system with configurable time-based cooldowns. Instead of building up charges by attacking enemies, weapon special abilities automatically recharge over time with durations fully customizable per rank through LuckPerms integration. During a cooldown, players cannot gain energy charge and must wait.
A (kinda bad) video showcase show its usage with LuckPerms for fast settings, if you wanna make a better showcase video, please do and I will place it here.
undefined
Features
Time-Based Cooldowns
Each weapon type has its own independent cooldown timer. After using a special attack, the ability enters cooldown and recharges automatically over time rather than requiring combat hits.
Support all weapon classes, and has planned support for future content mods.
LuckPerms Integration
Fine-tune cooldown durations for each rank on your server using LuckPerms meta values. If you want, you can set ranks to enjoy shorter or higher cooldowns as a gameplay perk.
lp group king meta set cooldown.axe 15
lp group king meta set cooldown.sword 8
lp group king meta set cooldown.dagger 4
lp group knight meta set cooldown.axe 30
lp group knight meta set cooldown.sword 15
lp group knightmeta set cooldown.dagger 8
Weapon keywords for now: sword, axe, dagger, mace, staff
The plugin queries LuckPerms in real-time, respecting group inheritance and per-player overrides. Make sure to use /lp sync if needed.
Server-Wide Events
Admins can trigger temporary pre-set events that modify all cooldowns server-wide:
Event
Command
Effect
Mayhem Mode
zero-cool
All cooldowns disabled
Hyper Speed
hyper-speed
80% reduced cooldowns
Half Time
half-time
50% reduced cooldowns
Double Time
double-time
Doubled cooldowns
Events display title announcements to all players and automatically expire after the configured duration. There is also a toast in the bottom right of the player screen showing how much time is left.
Admin Controls
Full command suite for server administrators (substitute for LuckPerms, needs op):
/wf toggle - Enable or disable the plugin
/wf reload - Hot-reload configuration
/wf set <player> <weapon> <seconds> - Override cooldowns for specific players
/wf clear <player> <weapon|all> - Clear cooldowns and overrides
/wf event start <mode> <duration> - Start a cooldown event
/wf event stop - End the current event
/wf check [player] - View cooldown status
/wf status - View plugin and event status
Bypass Permission
Grant the weaponflow.bypass permission to allow specific players or ranks to use abilities without cooldown restrictions.
Configuration
WeaponFlow generates a config.json file with extensive customization options:
Default cooldown durations per weapon type
Minimum and maximum cooldown limits
Action bar messages with color code support (Being implemented in another UI mod I am making mainly)
Sound effects for cooldown feedback
Event duration limits and messages/title customization
Disconnect behavior (clear or persist cooldowns)
Permissions
Permission
Description
weaponflow.admin
Access to admin commands
weaponflow.bypass
Skip all cooldown checks
weaponflow.check.self
Check own cooldown status
weaponflow.check.others
Check other players' cooldowns
Requirements
- None, but LuckPerms is recommended for ease of use.
Installation
Place WeaponFlow.jar in your server's mods folder
Start the server to generate the default configuration
Edit config.json OR IF using LuckPerms, Configure cooldown durations via LuckPerms meta values
Use /wf reload to apply configuration changes
Use Cases
PvP Servers: Create balanced combat with predictable ability timing. Grant shorter cooldowns to different case scenarios or modes.
RPG Servers: Implement strategic combat where ability timing matters. Use longer cooldowns to encourage thoughtful gameplay.
Event Servers: Run limited-time events with modified cooldowns to create unique gameplay experiences.
Planned Features
Event templates for quick deployment of custom cooldown modifiers
Event auto scheduling with player warnings
Cooldown system restriction to zone maps (being implemented to my WIP regions plugin)
Custom weapon effect definitions for content mods
Additional event types and cooldown behaviors
Items that act as consumables to grant shorter cooldowns temporaliry for the player that used it.
Support
While you can leave a comment, check the Discord for near-real-time information.
This mod disables the Teleporter limit and introduces private and restricted teleporters, as well as true Teleporter Ownership and true cross-world Teleporters. Temporary Teleports. Intra World Teleports, and much more.
This mod disables the Teleporter limit and introduces private and restricted teleporters, as well as true Teleporter Ownership and true cross-world Teleporters. Temporary Teleports. Intra World Teleports, and much more.
