SMP Fixes

---

❓ 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

1. Download the latest .jar from the releases
2. Drop it into your server's plugins/ folder
3. Restart your server
4. 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!

---