Skip to content

claudehohl/SpatialAudio3D

Repository files navigation

🎧 SpatialAudio3D

SpatialAudio3D is a drop-in Godot 4 plugin that transforms AudioStreamPlayer3D into a full spatial acoustics system. It 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.

SpatialAudio3D

See it in action

Godot: SpatialAudio3D

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

Configuration options

Config Options

Installation

  • Drop addons/spatial_audio_3d into your project
  • Add Child Node: Add node

About

A Godot 4 plugin that brings physically-informed 3D audio to your scenes — with distance-based delay, raycast-driven reverb, and dynamic occlusion, all derived from your level geometry at runtime.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors