Audio Rework is a lightweight audio enhancement mod that improves how 3D sounds behave in-game. It adds occlusion (sounds being blocked by objects), directional awareness, and smoother spatial audio transitions using runtime hooks.
Occlusion
Directional Audio
Diffraction (Corner Behavior)
Stereo Panning
Low-Pass Filtering
Hooks into audio playback using Harmony.
When a 3D AudioSource plays, the mod attaches a handler component.
Each active sound:
All settings are configurable via the generated config file.
Ray Count (int, default: 7)Number of rays cast between the player and the sound source.
Higher values:
Lower values:
Min Volume (float, default: 0.25)The lowest volume a sound can reach when fully occluded.
1.0 = no volume reduction0.0 = completely silent when blockedMax Cutoff (float, default: 22000)Maximum low-pass filter frequency (clear sound).
Min Cutoff (float, default: 1200)Minimum low-pass filter frequency (muffled sound).
Smoothing Speed (float, default: 5)Controls how quickly audio transitions between states.
Higher values:
Lower values:
Direction Strength (float, default: 1.8)Controls how strongly sound is affected based on whether it is in front of or behind the player.
1.0 = minimal directional effectDiffraction Softness (float, default: 0.2)Controls how much sound “wraps” around obstacles.
Higher values:
Lower values:
Ear Responsiveness (float, default: 5)Controls how quickly stereo panning updates.
Higher values:
Lower values:
Only affects 3D audio sources (UI and 2D sounds are ignored).
Uses Unity object tags (Glass, Wood, Metal) to adjust occlusion strength.
Designed to run efficiently by attaching only to active audio sources.
This project is provided as-is for personal use and modification.