godot-audio

1# Godot Audio (4.x)
2 
3Play SFX and music, route them through buses, control volume in decibels, and time
4gameplay to the beat. Targets **Godot 4.7**.
5 
6## When to use
7 
8- Use when playing sound effects or music, routing audio to buses (Master/Music/SFX),
9  adjusting volume/mute from code, adding bus effects (reverb, compressor), positional 3D
10  audio, or syncing events to music.
11 
12**When *not* to use:** engine-agnostic audio *design* (adaptive music structure, mixing
13philosophy, ducking patterns) → `audio-design`; importing/encoding assets outside Godot.
14 
15## Core workflow
16 
171. **Pick the player node:**
18   - `AudioStreamPlayer` — non-positional (music, UI, global SFX).
19   - `AudioStreamPlayer2D` / `AudioStreamPlayer3D` — positional; volume/pan from distance.
202. **Assign an `AudioStream`** to `stream` (`.ogg` for music/loops, `.wav` for short SFX)
21   and `play()`. Set `autoplay` for music that starts with the scene.
223. **Route to a bus.** Set the player's `bus` to a named bus (e.g. `"Music"`, `"SFX"`).
23   Define buses in the Audio panel (bottom dock); each can have volume, mute, solo, and
24   effects.
254. **Control volume in dB**, not linear (audio is logarithmic). `0 dB` = unchanged,
26   `-80 dB` ≈ silent. Convert with `linear_to_db`/`db_to_linear`, or use the linear helpers
27   (`volume_linear` on players, `AudioServer.set_bus_volume_linear()`), which convert for you.
285. **Drive volume/mute from code** with `AudioServer` by bus index.
29…