promotional bannermobile promotional banner
premium banner

Weapon Flow

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.

Description

A Hytale Character using a weapon skill during mayhem mode (no cooldowns). The character skill indicator is already full during execution

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

  1. Place WeaponFlow.jar in your server's mods folder
  2. Start the server to generate the default configuration
  3. Edit config.json OR IF using LuckPerms, Configure cooldown durations via LuckPerms meta values
  4. 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.

Discord