🎧 Dynamic Sound Culling

A highly optimized, feature-rich audio management mod designed to prevent audio clutter and major FPS drops in sound-heavy environments (e.g., massive entity farms, complex machinery grids, industrial spawners, or crowded multiplayer lobbies).

By dynamically culling and dampening overlapping audio sources based on the player's view direction, distance, and custom category limits, it delivers a smooth, crisp, and lag-free audio experience without losing critical ambient cues.

✨ Key Features

🚀 Dynamic Volume Dampening: Unlike simple mods that instantly mute overlapping sounds, Dynamic Sound Culling softly dampens excessive volumes, preserving atmospheric audio without blasting your speakers.
👀 Directional Culling: Prioritizes sounds in front of the player (inside your field of view) and intelligently sops/dampens sounds coming from behind.
📊 Per-Category Culling Limits: Configure independent culling limits for different sound types:
- Hostile Mobs (Zombies, Creepers, Skeleton farms)
- Neutral Mobs (Massive cow, sheep, or chicken farms)
- Blocks/Spawners (Pistons, farms, block noises)
- Ambient Sounds (Environmental loops)
- Default Limit (Generic catch-all limit)
🎨 Sleek Side-by-Side Config GUI: Access a beautiful, dual-column modern grid configuration panel directly from the game's mod menu across Fabric, Forge, and NeoForge.
⚡ Zero Performance Overhead: Built using highly optimized Mixins injecting directly into the Minecraft sound engine, leading to improved audio processing threads and frame rates.

📐 How it Works

The mod groups sounds into local 3D regions (chunks). When identical or total sounds exceed your defined thresholds within a short time window:

It checks if the sound is whitelisted (important sounds like player hurt, player death, generic explosions, lightning, and primed TNT are never culled).
It prioritizes sounds that are directly in front of you (inside your FOV) so you never miss what you are looking at.
Overlapping background sounds are softly dampened in volume or culled to protect your FPS and ears.

🛠️ Configuration Details

Configuration values are stored inside config/soundculling.json. You can easily adjust them via the in-game GUI or edit the file directly:

Region Total: Maximum total combined sounds of any type allowed inside a single region.
Time Window: Evaluation time window in game ticks (20 ticks = 1 second).
Region Size: Region boundary size in blocks (16.0 = 1 chunk).
Category Limits: Independent sound limit sliders for Hostile, Neutral, Blocks, and Ambient sound sources.

🚀 Game Commands

Control settings and inspect culling statistics dynamically using in-game chat commands:

/soundculling — Displays current mod limits, region settings, and total culled sound statistics for the session.
/soundculling limit <n> — Dynamically adjusts the default sound instance limit.
/soundculling total <n> — Dynamically adjusts the combined regional limit.