Audio Systems

Expert guidance for Godot's audio engine and mixing architecture.

NEVER Do

• NEVER create new AudioStreamPlayer nodes for every sound — Causes memory bloat and GC spikes. Use audio pooling (reuse players) or one-shot helper function.
• NEVER set AudioServer bus volume with linear values — set_bus_volume_db() expects decibels (-80 to 0). Use linear_to_db() for 0.0-1.0 conversion.
• NEVER forget to set autoplay = false on music players — Music autoplays on scene load by default. Causes overlapping tracks when changing scenes.
• NEVER use AudioStreamPlayer3D without attenuation model — Default attenuation is NONE (no falloff). Set attenuation_model to ATTENUATION_INVERSE_DISTANCE or audio is global.
• NEVER play AudioStreamPlayer without checking playing first — Restarting an already-playing sound cuts it off. Check if not player.playing: before play().

Available Scripts

MANDATORY: Read the appropriate script before implementing the corresponding pattern.