Weapon Flow

WeaponFlow

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.