WoolProofed

🔇 WoolProofed
A Paper/Spigot plugin that makes wool blocks act as realistic soundproofing material!

WoolProofed uses advanced packet interception to block all sounds when wool is placed between the sound source and the player. Perfect for creating soundproof redstone rooms, silent storage systems, or reducing noise pollution in your builds!

✨ Features
🎯 Complete Sound Blocking: Automatically blocks ALL block sounds (redstone, pistons, droppers, dispensers, observers, buttons, levers, doors, trapdoors, and more) when wool is in the line of sight

🌈 All Wool Colors Supported: Works with all 16 wool colors (white, orange, magenta, light blue, yellow, lime, pink, gray, light gray, cyan, purple, blue, brown, green, red, black)

🔬 Smart Raytrace Detection: Uses precise raytrace calculations to check every block between sound source and player

⚡ Performance Optimized: Efficient packet interception that only blocks sounds when necessary

🔌 Plugin-Based: Works server-side, no client mods required

📋 Requirements
Required Dependencies:

ProtocolLib 5.3.0+ - Download and place in your plugins/ folder

Server Requirements:

Paper or Spigot 1.21.x

Java 17 or higher

📦 Installation
Download ProtocolLib (minimum version 5.3.0)

Download WoolProofed from the releases page

Place both JAR files in your server's plugins/ folder

Restart your server

Enjoy realistic soundproofing!

🎮 Usage
Simply build walls, floors, or ceilings using wool blocks between yourself and any noisy redstone contraptions, farms, or machinery. The plugin automatically detects when wool blocks the direct line between a sound source and the player's position.

Example Use Cases:

🔴 Silent redstone rooms - no more annoying clicking sounds

🏭 Quiet farm designs - build farms without the constant noise

🏠 Soundproof housing - keep your base peaceful

🎵 Recording studios - eliminate background noise for content creation

⚙️ How It Works
WoolProofed uses ProtocolLib to intercept sound packets before they reach the player's client. When a sound is about to play:

The plugin captures the sound packet using ProtocolLib's packet listeners

It calculates a raytrace path from the sound source to the player's eye position

Every 0.5 blocks along this path, it checks if a wool block exists

If wool is detected, the sound packet is cancelled before reaching the client

If no wool is found, the sound plays normally

This approach is the only reliable method to block sounds in Minecraft, as it prevents the sound from ever reaching the player rather than trying to stop it after it's already been sent.

🔧 Technical Details
API Used: Paper API 1.21.1-R0.1-SNAPSHOT

Packet Types: NAMED_SOUND_EFFECT, WORLD_EVENT

Raytrace Step Size: 0.5 blocks

Detection Range: Unlimited (follows Minecraft's natural sound range)

Performance Impact: Minimal - only processes sounds when players are nearby

🐛 Known Limitations
Requires ProtocolLib to function

Client-side sounds (like UI clicks) cannot be blocked

Music discs and jukeboxes are not affected