ShieldStun

Plays shield block and stun sounds to the attacker when their melee hit is blocked by a shield.
item image
video thumbnail

Description

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

  1. A player lands a melee hit on another player.
  2. The victim blocks it with a shield.
  3. ShieldStun instantly plays the block sound and the stun sound to the attacker.
  4. Arrows and other projectiles are ignored — only true melee trades count.
  5. 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

ShieldStun Team

profile avatar
  • 11
    Projects
  • 125
    Downloads

Developer specializing in unique solutions for modpacks and server builds. Open for individual custom commissions. Let's bring your ideas to life!

More from NaotoDevView all