Dynamic Surroundings Sound Engine Guide: Channels, Culling, Volume, and Per-Sound Options

guide

Dynamic Surroundings exposes its sound engine tuning through an in-game Mod Configuration Menu rather than through crafting or items. Everything below is controlled from that configuration screen and, where noted, from the Individual Sound Configuration list. Some changes only take effect after a client, world, or asset reload; the configuration screen flags these as CLIENT restart required, WORLD restart required, or ASSET reload required.

Sound System Options

These settings change how Minecraft's sound system behaves while the mod is active.

Number of Streaming Sound Channels — sets how many channels are held in reserve for streaming audio such as music, biome sounds, and records. Raise it if streaming audio cuts out; lower it to free resources.
Sound Culling Interval — the number of ticks between culled sound events. Setting it to 0 turns culling off.
Sound culling — when enabled, sounds a player will not hear are cancelled. This does not apply to global sounds, non-attenuated sounds, or weather sounds.

Ambient and Effect Generation

Ambient sound scaling factor — multiplies the volume of ambient sounds the mod plays. The unit is 1/100, so 100 means normal volume. This is one of several factors in the volume calculation, and the final result is always clamped between 0.0 and 1.0.
Replace Vanilla thunder sounds — swaps vanilla thunder for the mod's own thunder audio.
Sound remapping — when enabled, various step sounds are replaced with the mod's substitute versions.
Allow playing scary sounds — permits scary sounds to play. What counts as scary is subjective and is left to mod pack authors to configure. Sounds you dislike can also be blocked through the in-game sound configuration menu.
Play biome music while creative — keeps configured biome background music playing in creative mode, instead of letting Minecraft's situational selector choose creative music.
Display music toast messages — shows toast notifications for music that requires attribution.

Block and Entity Effects

Block Effect Range — the scan distance used when generating block effects. Changing it resets existing effects and rescans the area.
Entity Effect Range — the maximum distance at which entity special effects apply. Sound and particle effects still use their own ranges inside the game engine.

Individual toggles cover steam columns where liquids meet hot sources, flame jets over lava and nether wart, underwater bubble columns, firefly particles, waterfall effects, waterfall sounds, and waterfall particles. Waterfall sound and particle toggles are independent: turning off particles leaves sounds running, and vice versa. Water Ripple Render Style selects the ripple drawn when a drop lands in fluid.

Entity toggles cover bow pull sounds, breath effects in cold biomes, player toolbar effects, toolbar block sounds, item swing effects, and sounds from walking through dense brush.

Footstep Accents and Particles

Footstep Accent Options has a global toggle plus separate toggles for worn armor, wet surfaces (rain or waterlogged blocks), and squeaky blocks.

Particle behaviour settings include suppressing the local player's potion particles in first person and suppressing projectile particle trails on critical strikes.

Compass and Clock Overlay

Toggles show a clock reading above the hot bar while holding a clock, and a compass heading above the crosshair while holding a compass. Separate options set the compass render style and scale its rendering.

Enhanced Sound Processing

Enhanced Sound Processing — the master toggle for reverb and occlusion.
Stereo-to-mono conversion — converts stereo sounds on the fly as needed, and only runs while enhanced processing is on.
Background Worker Threads — thread count for enhanced processing. Do not change this arbitrarily, as it can affect performance.
Occlusion Processing — muffles sound behind blocks. It adds worker load and may hurt performance on lower-end systems.
Reverb Ray Projections, Reverb Ray Reflections, and Reverb Ray Projection Distance — control reverb quality. Higher values cost more CPU and improve fidelity; lower values do the opposite. Ray projections are the primary setting to adjust when managing performance.

Fog, Music Manager, and Miscellaneous

Fog options include a master toggle plus separate toggles for morning fog, biome fog (colour and intensity come from biome configuration), and weather fog.

Replace Music Manager — swaps Minecraft's music manager for the modded one, which enables the music manager commands.
Reduce music wait time — a percentage that shortens the gap between music plays, independent of the modded music manager.
Play Random Sound On Startup — plays a random sound when loading reaches the main screen.

Individual Sound Configuration

The Individual Sound Configuration screen configures sounds one at a time. For each sound you can:

Cull — limits how many plays of the same resource ID queue up in a short window, easing load on the sound engine and on your ears. Useful near mob farms. Applies only to sounds played through the Minecraft sound engine.
Block — stops sounds with that resource ID from playing at all. Blocking also applies to Dynamic Surroundings sounds, but only through the Minecraft sound engine.
Volume scaling — plays the sound with volume multiplied by a scaling factor. It does not apply sound category volume modifiers. A factor of 100 is normal; raise it to make quiet sounds louder, lower it to make loud sounds quieter.

Diagnostics

The Diagnostic Overlay and its diagnostic options control debug logging, a bitmask of debug traces, mod update chat messages, and tag filtering in the overlay. Tag filtering, when enabled, shows only tags belonging to loader frameworks plus Minecraft and this mod. Register client side commands can be disabled, which may give the broadest support when running alongside other loaders.

Other diagnostic actions report success or failure in chat, covering configuration dumps, resource reloads, and Music Manager reset, pause, unpause, and now-playing queries. If the Music Manager is absent, the mod reports it as not present, possibly disabled or failed. When nothing is playing, it reports that no music is playing.