This is a playable demo project for SpatialAudio3D, a drop-in Godot 4 addon that transforms AudioStreamPlayer3D into a full spatial acoustics system. Install and run this project directly to hear it in action. To use it in your own project, copy the addons/spatial_audio_3d folder over and configure the exposed parameters on your own AudioStreamPlayer3D nodes.

The addon fires raycasts from each sound source to detect nearby surfaces, placing virtual reflection points that play back reverb with delay and room size derived from the actual geometry around them. Occlusion behind walls smoothly rolls off high frequencies, and a dual-player crossfade system eliminates the audible clicks that occur when changing audio delay mid-playback. The result is an environment that sounds like it has walls, rooms, and air — with no manual setup beyond dropping the node into your scene.

FEATURES

Realistic spatial acoustics for Godot 4, driven entirely by your level geometry.

• Distance delay — sound reaches the player at the correct time based on speed of sound
• Raycast reverb — reflection points are placed automatically at surrounding surfaces
• Room size detection — reverb tail length adapts to the measured dimensions of the space
• Occlusion filtering — walls between source and listener smoothly cut high frequencies
• Proximity bass — low-end increases naturally as you approach a reflecting surface
• Crack-free crossfading — dual-player A/B system avoids audio glitches when delay changes
• Zero manual setup — extends AudioStreamPlayer3D, works with your existing collision geometry

INSTALLATION

1. Drop addons/spatial_audio_3d into your project
2. Add it as a child node in your scene

No further configuration is required — the plugin uses your existing collision geometry out of the box, with optional parameters available for fine-tuning.