ShieldStun makes shield PvP sound the way it should. When a player's melee hit is blocked by a shield, the attacker instantly hears the shield block click and the shield stun ring — instead of just the plain vanilla hit sound.
No more silent blocks — every blocked trade in a fight becomes audible.
🎯 Why Your Server Needs This Plugin
Vanilla blocks are silent for the attacker. The shield holder hears their block, but the attacker gets nothing. ShieldStun closes that gap and makes every blocked hit satisfying to hear.
Real tactical feedback. The moment you hear the block, you know the shield is up — change tactics. Skilled play becomes readable through sound.
100% sound, 0% gameplay change. Damage, shield cooldowns and every vanilla mechanic stay untouched. Remove the plugin and nothing else changes.
Zero setup. Drop the jar into plugins, it works out of the box. Every sound, volume and pitch is configurable, and /shieldstun reload applies edits instantly.
Closes a year-old request. Asked on SpigotMC in July 2025, promised, never delivered — until now.
💡 How It Works
- A player lands a melee hit on another player.
- The victim blocks it with a shield.
- ShieldStun instantly plays the block sound and the stun sound to the attacker.
- Arrows and other projectiles are ignored — only true melee trades count.
- The vanilla hit sound keeps playing as usual (it is client-side) — ShieldStun layers its sounds on top of it.
Sounds (fully configurable)
| Sound |
Plays when |
Default key |
| 🛡️ Block |
Every blocked melee hit |
item.shield.block |
| 💥 Stun |
Every blocked hit by default — or only when the shield is actually disabled (e.g. an axe hit with the 5s cooldown), via one config switch |
item.shield.break |
Who hears it
| Target |
Config key |
Default |
| Attacker (hit was blocked) |
play-to-attacker |
on |
| Defender (shield holder) |
play-to-defender |
off |
| Nearby players |
play-to-nearby + nearby-radius |
off |
Any sound key works — vanilla, resource pack or plugin sounds. Volume and pitch are set per sound.
⚙️ Technical Advantages
Featherweight. ~8 KB jar, zero dependencies, no libraries, no NMS — nothing is downloaded at runtime.
Modern Paper API. Built against Paper 26.3 and uses Paper's PlayerShieldDisableEvent for exact stun detection.
Double block detection. Reads the blocking damage modifier first, with a safe fallback (zero final damage + active shield check) — no false triggers.
Plays nice with other plugins. Listens at MONITOR priority and ignores cancelled events, so protection and PvP plugins stay in full control.
Adventure Components. Clean modern messages, no legacy color-code glitches.
One jar for everything. Java 21, api-version 1.21 — runs on Paper, Purpur and other Paper forks from 1.21.x to 26.3.
🛠️ Commands & Permissions
| Command / Permission |
What it does |
Default |
/shieldstun reload |
Reloads config.yml without a restart |
shieldstun.admin (OP) |
shieldstun.bypass |
Players with this permission never trigger the extra sounds |
nobody |
📦 Perfect For
- PvP, Practice and KitPvP servers — shield play becomes audible and skill-based.
- SMP and survival — a tiny touch that makes every fight feel alive.
- Factions and arenas — crisp feedback even in mass fights.
- Content creators — satisfying, readable combat audio for videos.
Install ShieldStun and let your players hear every block!
Chat, requests to add features, bugs — discord
Support the author: donate