What is the purpose of the Audio Category System?

To define categories (Music, SFX, Ambient, UI, Voice) and a priority hierarchy that resolves channel conflicts and ensures critical sounds survive playback.

How does the Music State System work?

It maps game states (Menu, Exploration, Combat, Victory/Defeat, Boss) to mood-specific music and transitions like crossfades and stingers.

What matters in 3D audio decisions?

Spatialization rules specify which elements are 3D positioned (e.g., enemy footsteps, gunfire) and how distance behavior (volume and frequency rolloff) shapes immersion.

game-audio

Scanned

npx machina-cli add skill vudovn/antigravity-kit/game-audio --openclaw

Files (1)

SKILL.md

5.2 KB

Game Audio Principles

Sound design and music integration for immersive game experiences.

1. Audio Category System

Category Definitions

Category	Behavior	Examples
Music	Looping, crossfade, ducking	BGM, combat music
SFX	One-shot, 3D positioned	Footsteps, impacts
Ambient	Looping, background layer	Wind, crowd, forest
UI	Immediate, non-3D	Button clicks, notifications
Voice	Priority, ducking trigger	Dialogue, announcer

Priority Hierarchy

When sounds compete for channels:

1. Voice (highest - always audible)
2. Player SFX (feedback critical)
3. Enemy SFX (gameplay important)
4. Music (mood, but duckable)
5. Ambient (lowest - can drop)

2. Sound Design Decisions

SFX Creation Approach

Approach	When to Use	Trade-offs
Recording	Realistic needs	High quality, time intensive
Synthesis	Sci-fi, retro, UI	Unique, requires skill
Library samples	Fast production	Common sounds, licensing
Layering	Complex sounds	Best results, more work

Layering Structure

Layer	Purpose	Example: Gunshot
Attack	Initial transient	Click, snap
Body	Main character	Boom, blast
Tail	Decay, room	Reverb, echo
Sweetener	Special sauce	Shell casing, mechanical

3. Music Integration

Music State System

Game State → Music Response
│
├── Menu → Calm, loopable theme
├── Exploration → Ambient, atmospheric
├── Combat detected → Transition to tension
├── Combat engaged → Full battle music
├── Victory → Stinger + calm transition
├── Defeat → Somber stinger
└── Boss → Unique, multi-phase track

Transition Techniques

Technique	Use When	Feel
Crossfade	Smooth mood shift	Gradual
Stinger	Immediate event	Dramatic
Stem mixing	Dynamic intensity	Seamless
Beat-synced	Rhythmic gameplay	Musical
Queue point	Next natural break	Clean

4. Adaptive Audio Decisions

Intensity Parameters

Parameter	Affects	Example
Threat level	Music intensity	Enemy count
Health	Filter, reverb	Low health = muffled
Speed	Tempo, energy	Racing speed
Environment	Reverb, EQ	Cave vs outdoor
Time of day	Mood, volume	Night = quieter

Vertical vs Horizontal

System	What Changes	Best For
Vertical (layers)	Add/remove instrument layers	Intensity scaling
Horizontal (segments)	Different music sections	State changes
Combined	Both	AAA adaptive scores

5. 3D Audio Decisions

Spatialization

Element	3D Positioned?	Reason
Player footsteps	No (or subtle)	Always audible
Enemy footsteps	Yes	Directional awareness
Gunfire	Yes	Combat awareness
Music	No	Mood, non-diegetic
Ambient zone	Yes (area)	Environmental
UI sounds	No	Interface feedback

Distance Behavior

Distance	Sound Behavior
Near	Full volume, full frequency
Medium	Volume falloff, high-freq rolloff
Far	Low volume, low-pass filter
Max	Silent or ambient hint

6. Platform Considerations

Format Selection

Platform	Recommended Format	Reason
PC	OGG Vorbis, WAV	Quality, no licensing
Console	Platform-specific	Certification
Mobile	MP3, AAC	Size, compatibility
Web	WebM/Opus, MP3 fallback	Browser support

Memory Budget

Game Type	Audio Budget	Strategy
Mobile casual	10-50 MB	Compressed, fewer variants
PC indie	100-500 MB	Quality focus
AAA	1+ GB	Full quality, many variants

7. Mix Hierarchy

Volume Balance Reference

Category	Relative Level	Notes
Voice	0 dB (reference)	Always clear
Player SFX	-3 to -6 dB	Prominent but not harsh
Music	-6 to -12 dB	Foundation, ducks for voice
Enemy SFX	-6 to -9 dB	Important but not dominant
Ambient	-12 to -18 dB	Subtle background

Ducking Rules

When	Duck What	Amount
Voice plays	Music, Ambient	-6 to -9 dB
Explosion	All except explosion	Brief duck
Menu open	Gameplay audio	-3 to -6 dB

8. Anti-Patterns

Don't	Do
Play same sound repeatedly	Use variations (3-5 per sound)
Max volume everything	Use proper mix hierarchy
Ignore silence	Silence creates contrast
One music track loops forever	Provide variety, transitions
Skip audio in prototype	Placeholder audio matters

Remember: 50% of the game experience is audio. A muted game loses half its soul.

Source

git clone https://github.com/vudovn/antigravity-kit/blob/main/.agent/skills/game-development/game-audio/SKILL.mdView on GitHub

Overview

This skill covers organizing game audio into categories, prioritizing channels, and integrating music with adaptive systems. It emphasizes sound design decisions, music transitions, and 3D audio practices to create immersive experiences while managing platform constraints.

How This Skill Works

First, define Audio Categories (Music, SFX, Ambient, UI, Voice) and a Priority Hierarchy to arbitrate channels. Next, design SFX with a layered structure (Attack, Body, Tail, Sweetener) and attach music via a Music State System that maps game states to appropriate themes. Finally, implement Adaptive Audio using intensity parameters (threat level, health, speed, environment, time of day) and apply 3D spatialization rules with distance behavior, plus platform-aware format choices.

When to Use It

When designing an audio system that responds to game states (menu, exploration, combat, boss encounters).
When balancing voice, player SFX, enemy SFX, and music on limited channels using a clear priority order.
When implementing 3D audio cues like enemy footsteps and ambient zones for spatial awareness.
When applying adaptive music transitions based on threat, health, speed, and environment.
When targeting multiple platforms with platform-specific formats and memory considerations.

Quick Start

Step 1: Define Audio Categories (Music, SFX, Ambient, UI, Voice) and a Priority Hierarchy.
Step 2: Design layered SFX (Attack/Body/Tail/Sweetener) and implement a Music State System for transitions.
Step 3: Add Adaptive Audio with intensity parameters and 3D spatial rules; choose platform formats (PC: OGG/WAV, Mobile: MP3/AAC).

Best Practices

Define clear Audio Categories and a Priority Hierarchy to resolve channel conflicts.
Plan SFX layering: Attack, Body, Tail, and Sweetener for richer sounds.
Implement a Music State System that maps game states to mood-specific music and transitions.
Use intensity parameters (threat level, health, speed, environment, time of day) to drive adaptivity.
Design with platform formats and memory budgets in mind (OGG/WAV on PC, MP3/AAC on mobile, etc.).

Example Use Cases

Menu → Calm loop music; Exploration → Ambient, atmospheric; Combat → Transition to tension; Victory/Defeat → Stinger with mood shift; Boss → Unique multi-phase track.
Gunshot sounds built from Attack (initial click), Body (main blast), Tail (reverb/echo), and Sweetener (shell casing/metallic nuance).
Enemy footsteps and gunfire are 3D positioned; Player footsteps kept subtle to avoid masking important cues; Ambient zones drive area-specific reverb.
Dialogue priority ensures Voice overrides or ducks other sounds for clear speech.
Environment-based reverb changes when moving between cave-like and outdoor areas; memory-conscious format choices per platform.

Frequently Asked Questions

Add this skill to your agents