SMP FIXES

The essential companion plugin for Paper & Purpur SMP servers.

Fixes broken vanilla mechanics so your players get the experience they deserve.

❓ The Problem

If you run a Paper or Purpur server and you've enabled skip-vanilla-damage-tick-when-shield-blocked: true to enable the Stun mechanic — you've probably noticed something is broken:

🔇 The shield block sound is completely gone.

Players block an attack with their shield, but hear... nothing. No satisfying clang, no feedback. It feels wrong and breaks immersion.

SMP Fixes restores the missing shield block & shield break sounds, Disables the chat reports, Enables the Attribute Swap so you Lunge forever and more...

✨ Features

🔊 Shield Sound Restoration

Automatically detects your paper-global.yml / paper.yml / purpur.yml settings
Restores ITEM_SHIELD_BLOCK sound when blocking attacks
Supports all blockable damage types: melee, sweep, projectile, explosions etc.

⚙️ In-Game Config Management

No more digging through config files! SMP Fixes lets you toggle critical server settings directly from in-game commands:

Command	What it does
`/smpfixes reload`	Reloads the plugin config + runs `purpur reload` & `paper reload`
`/smpfixes attribute-swap <true\|false>`	Toggles `update-equipment-on-player-actions` in Paper config (inverse logic)
`/smpfixes shield-stuns <true\|false>`	Toggles `skip-vanilla-damage-tick-when-shield-blocked` in Paper config
`/smpfixes no-chat-report <true\|false>`	Toggles `enforce-secure-profile` in `server.properties` (inverse logic)

🧠 Smart Auto-Detection

Automatically scans config/paper-global.yml, paper.yml, and purpur.yml
Activates the shield sound fix only when needed
No manual setup required — just drop and go!

📦 Installation

Download the latest .jar from the releases
Drop it into your server's plugins/ folder
Restart your server
Done! The plugin auto-detects your settings and activates if needed

🔧 Configuration

The plugin generates a config.yml with fully customizable options:

# ====================================================== #
#               SMP Fixes Configuration                  #
# ====================================================== #

auto-detect-paper-setting: true
force-enable: false
debug: false

# Feature Toggles
no-chat-report: true
attribute-swap: true
shield-stuns: true

sound:
  enabled: true
  type: "ITEM_SHIELD_BLOCK"
  category: "PLAYERS"
  volume: 1.0
  pitch-min: 0.8
  pitch-max: 1.2

shield-break-sound:
  enabled: true
  type: "ITEM_SHIELD_BREAK"
  category: "PLAYERS"
  volume: 1.0
  pitch-min: 0.8
  pitch-max: 1.2

🔑 Permissions

Permission	Description	Default
`smpfixes.admin`	Access to all SMP Fixes commands	OP

📋 Requirements

Server: Paper, Purpur, or any Paper-based fork
Minecraft: 1.21+
Java: 21+

💬 Support & Community

Have a question, found a bug, or want to suggest a feature?

Join our Discord server for support, updates, and to connect with others!

Made by TheRealDarkKing