Godot Audio Systems

This is a comprehensive reference for Godot's audio engine that covers the stuff most tutorials skip. It handles bus routing and logarithmic volume correctly, includes pooling patterns to avoid spawning hundreds of AudioStreamPlayer nodes per second, and ships with actual scripts for occlusion raycasting, voice limiting, and vertical music layering. The "never do" rules are solid: they cover common mistakes like forgetting attenuation models on 3D players or using linear values for bus volume. Use this when you're building a real audio system and need patterns for crossfades, spatial audio, or dynamic mixing instead of just playing a one-shot sound effect.

skills.sh installs: 322
GitHub stars: 464
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add thedivergentai/gd-agentic-skills --skill godot-audio-systems --agent claude-code

Installs into .claude/skills of the current project.

Files

Audio Systems

Expert mixing, spatial, pooling, and interactive-music patterns for Godot's audio engine.

NEVER Do (Expert Audio Rules)

Mixing & Buses

NEVER set bus volume with linear values — set_bus_volume_db() is logarithmic. Use linear_to_db() for sliders OR everything will sound too loud until the last 5%.
NEVER skip 'Bus Routing' — Playing music on the 'SFX' bus makes volume menus useless. Strictly route every player to its dedicated sub-bus (Music, SFX, UI, Voice).
NEVER use 'Master' for gameplay sounds — Dedicate Master to final limiting. Route all gameplay to sub-groups so you can mute/duck categories.

Positional & Spatial

NEVER use 3D players without an Attenuation Model — Default is NONE. If you don't set it to Inverse Distance, a whisper on the other side of the map will be global volume.
NEVER play 3D sounds exactly on top of the listener — Causes "Panning Jitter" where the sound snaps between Left/Right speakers. Offset by 0.1 units.
NEVER forget Doppler for high-speed objects — A car flying by without DOPPLER_TRACKING_PHYSICS_STEP feels flat and static.

SKILL.md on GitHub