SpearAttributeSwapFixer

Spear Attribute Swap Fixer

A server-side Paper plugin. Every time a player swipes their hotbar to a spear, they get one spear jab with no attack cooldown, so the Lunge dash on it is instantly available. After that jab, the normal vanilla cooldown applies until the next swipe. Without a swipe, nothing changes.

Why

Vanilla spears put a cooldown on the jab, and that cooldown also gates Lunge. After swapping to a spear you usually have to wait for it to recharge. This plugin gives you one ready jab per swipe and leaves everything else as vanilla.

How it works

• Swiping the hotbar to a spear arms one free jab.
• A temporary attack speed modifier is applied to the player. The spear cooldown check is done by the client using the attack speed attribute, so the modifier is what makes the jab available. The server-side attack cooldown counter is also filled for that attack.
• As soon as the jab is used, the modifier is removed and the normal cooldown takes over.
• If the free jab is not used, it expires after a configurable time (default 2 seconds), or when the player swipes to a non-spear item, leaves the server, or the plugin is disabled.
• Swiping to a spear again arms another free jab.

Vanilla Lunge rules still apply

The plugin only removes the cooldown. It does not change Lunge itself, so these still block the dash:

• Hunger of 6 points or less
• Being in water, riding a mount, or gliding with an elytra
• Charge attacks (Lunge only works on the jab)

Commands and permissions

Configuration

enabled: true
zero-cooldown-ticks: 40       # how long the free jab stays available after a swipe (20 ticks = 1 second); 0 = until used or the player swipes away
attack-speed-boost: 1000      # temporary attack speed bonus; must be large, do not set to 0
hand-swap-triggers: false     # also trigger with the offhand swap key
lunge-only: false             # only count spears that have the Lunge enchantment