Compatibility
Minecraft: Java Edition
26.3
26.2
26.1.x
1.21.11
Platforms
Tags
Creators
Details
Licensed LGPL-3.0-only
Published 5 days ago
Updated 2 days ago
What it does
SpearAttributeSwapFixer is a server-side plugin for Spigot, Bukkit and Paper. 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. Where the server allows it, 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.
- On Spigot and Bukkit the modifier is a regular one, so the plugin also removes any leftover modifier when a player joins or the plugin starts or stops.
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
| Command | Permission | Description |
|---|---|---|
/spearswapfixer (aliases /ssf, /spearswarpfixer) |
spearswapfixer.use (default: op) |
Toggle the plugin on or off |
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
## Metrics
This plugin uses [bStats](https://bstats.org) to collect anonymous usage statistics (server software and version, player count, plugin version). You can disable it with `metrics: false` in the plugin's `config.yml`, or globally in `plugins/bStats/config.yml`.


