This skill covers Godot 4.7 audio from the node level to the mixer: AudioStreamPlayer, AudioStreamPlayer2D and 3D, the bus layout file, AudioServer volume and mute, polyphony, looping imports and playback position for beat sync. It starts by reading the project’s bus layout so names in scenes and code match exactly.
It includes patterns for overlapping one-shot effects, a mute-aware volume slider, a two-player music crossfade and song time for rhythm games. A bundled headless check reports every bus name that the layout does not define, with file and line.
What You Get
- A workflow that reads the bus layout, picks a player node, routes buses, sets volume and sets loops at import
- GDScript patterns for overlapping SFX, a bus volume slider with mute, a music crossfade and beat-sync song time
- A headless bus check that lists every bus name the layout does not define, with file and line
- A gotcha list for silent sounds, cut-off effects, missing loops, silent 3D audio and web export effects
Common Use Cases
- Adding sound effects and music with separate volume sliders
- Debugging a sound that plays on Master and ignores its bus
- Syncing gameplay to a song with a corrected playback position
- Fixing effects or reverb that go silent only in a web export
What Makes It Unique
Godot falls back to the Master bus without an error when a bus name is wrong, so the mistake stays hidden. This skill ships a headless check that loads the real layout and reports every bad name. It also records version-specific traps such as the 4.7 area_mask default and the Web Audio sample playback in web exports.
Under The Hood
The agent loads the SKILL.md and, when needed, a reference on the layout file, the AudioServer API, effects and positional audio. It runs commands in your project: the Godot binary headless with the bundled GDScript bus check, and optionally the Python project checker from the godot-nodes-scenes skill to find missing stream files. It reads project, scene and script files and makes no network calls. The shipped GDScript check is a file type the scanner cannot read, so what it does was not analysed and is worth a look before you run it. Loudness and mix still need a person to listen.