- name
SKILL.md
스킬 파일은 게시자의 저장소에 그대로 있습니다.
복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill audio-design -a cursor -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill audio-design -a claude-code -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill audio-design -a codex -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill audio-design -a grok -y복사한 메시지를 Grok Bot 채팅에 보냅니다. Bot이 GitHub에서 이 SKILL.md를 가져와 모든 Bot이 공유하는 스킬에 추가합니다.
Install this skill: https://github.com/gamedev-skills/awesome-gamedev-agent-skills/tree/HEAD/skills/disciplines/audio-design게시자 제공
Game audio is a mixing graph plus a music system. Every sound plays into a small set of buses
that the settings sliders and ducking act on, and music reacts to play through layers and
segments instead of one loop. This skill owns those decisions; godot-audio, Unity's
AudioMixer or FMOD/Wwise supply the API.
Not this skill: Godot node, bus and stream API questions go to godot-audio; settings menu
layout goes to game-ui-ux; triggering sounds from hits goes through game-feel's feedback
bundle.
AudioSource and the bus or mixer group it
outputs to; anything on Master or with no group bypasses the sliders.Master ← Music ← MusicDuck, SFX, Ambience, UI, Voice. Sliders map
to bus gain; nobody sets per-clip volumes by hand.linear_to_db, mute at 0.xvfb-run -a godot --path . --write-movie capture.avi --fixed-fps 60 --quit-after 9000
(needs a renderer; Movie Maker crashes under --headless). Other engines: ask the user to
record the game's output to a WAV and share the path.ffmpeg -hide_banner -nostats -i capture.avi -vn -af ebur128=peak=true:framelog=quiet -f null -
prints integrated loudness (I:) and true peak (Peak:). Compare with step 4.Snippets are Godot 4.7 GDScript; the Unity 6.3 LTS and middleware equivalents follow each one.
# Route sounds to named buses; control GROUPS, not individual clips.
sfx_player.bus = &"SFX"
music_player.bus = &"Music"
# Map a 0..1 settings slider to bus gain. Squaring the slider first spreads the
# audible change over the whole travel; a raw linear-amplitude slider puts most of
# the change in the bottom fifth.
func set_bus_volume(bus_name: StringName, slider01: float) -> void:
var idx := AudioServer.get_bus_index(bus_name)
var gain := clampf(slider01, 0.0, 1.0)
AudioServer.set_bus_mute(idx, gain <= 0.0) # true silence at 0
AudioServer.set_bus_volume_linear(idx, gain * gain) # = set_bus_volume_db(idx, linear_to_db(gain * gain))
# WRONG: AudioServer.set_bus_volume_db(idx, slider01): "0.5" is +0.5 dB (no audible
# change) and 0 is 0 dB (full volume).
Unity 6.3 LTS: expose the group's Volume as a mixer parameter, then
mixer.SetFloat("MusicVolume", 20f * Mathf.Log10(Mathf.Max(gain * gain, 0.0001f))) (the mixer
floor is -80 dB). An AudioSource whose Output group is empty plays outside your mixer groups,
so no category slider or snapshot affects it: route every source.
A compressor on the music bus, keyed by the voice bus, lowers the music while dialogue plays and releases afterwards. Starting values: threshold about -30 dB on the voice signal, ratio 4:1 to 8:1, attack as fast as the effect allows (up to ~10 ms), release 300-500 ms.
# Godot 4.7: AudioEffectCompressor reads its sidechain bus for threshold detection.
func _ready() -> void:
var duck := AudioEffectCompressor.new()
duck.sidechain = &"Voice" # the bus that triggers the dip
duck.threshold = -30.0 # dB, range -60..0
duck.ratio = 8.0 # range 1..48
duck.attack_us = 2000.0 # MICROseconds, range 20..2000 (2 ms is the maximum)
duck.release_ms = 400.0 # milliseconds, range 20..2000
AudioServer.add_bus_effect(AudioServer.get_bus_index(&"Music"), duck)
# No-compressor alternative: tween a dedicated "MusicDuck" bus that sits between
# Music and Master, so ducking never overwrites the player's Music slider.
func duck_music(active: bool) -> void:
var idx := AudioServer.get_bus_index(&"MusicDuck")
var from := AudioServer.get_bus_volume_db(idx)
var to := -12.0 if active else 0.0
create_tween().tween_method(
func(db: float) -> void: AudioServer.set_bus_volume_db(idx, db), from, to, 0.25)
Unity 6.3 LTS: add a Duck Volume effect to the Music group and a Send effect on the Voice group targeting it. FMOD Studio and Wwise have sidechain/auto-ducking on buses; prefer those over script tweens when the project already uses middleware.
# Godot 4.7: AudioStreamRandomizer picks a take (no immediate repeats by default)
# and randomizes pitch and volume on every play. No per-shot node allocation.
func make_footsteps(samples: Array[AudioStream]) -> void:
var rnd := AudioStreamRandomizer.new()
for s in samples:
rnd.add_stream(-1, s) # -1 appends; optional third arg = weight
rnd.random_pitch_semitones = 1.0 # up to +/-1 semitone (about 6%)
rnd.random_volume_offset_db = 2.0 # up to +/-2 dB
$Footsteps.stream = rnd
$Footsteps.max_polyphony = 4 # overlapping steps without new players
Unity 6.3 LTS: put the takes in an Audio Random Container asset (Random or Shuffle playback,
Avoid Repeating Last, volume and pitch randomization) and assign it to the AudioSource's
Audio Resource (AudioSource.resource); with Manual trigger each Play() picks a new take. For
full script control, keep an array of clips, pick one that differs from the last, set pitch in
a small range, and call PlayOneShot on a pooled AudioSource.
# Schedule gameplay/visuals on musical time, not frame time, so they land on beat.
const BPM := 120.0
const SECONDS_PER_BEAT := 60.0 / BPM
# What the player HEARS now: playback position, plus time since the last mix
# (the position only updates once per mixed chunk), minus output latency.
func song_time() -> float:
return ($Music.get_playback_position() + AudioServer.get_time_since_last_mix()
- AudioServer.get_output_latency())
func current_beat() -> int:
return floori(song_time() / SECONDS_PER_BEAT) # negative means beat 0 is not audible yet
# Quantize an action to the NEXT beat boundary instead of firing immediately.
func time_until_next_beat() -> float:
var time := song_time()
if time < 0.0:
return -time # pre-roll: wait for the first audible beat
return SECONDS_PER_BEAT - fposmod(time, SECONDS_PER_BEAT)
# At an exact non-negative beat boundary, NEXT means one full beat later.
Unity 6.3 LTS: read AudioSettings.dspTime and schedule with AudioSource.PlayScheduled(dspTime)
for sample-accurate starts.
set_bus_volume_db(idx, 0.5) is +0.5 dB, and 0 is full volume.
Convert, and square or cube the slider first: a raw linear-amplitude slider barely changes over
most of its travel and then drops off at the bottom.AudioSource with an empty Output, or a Godot player
left on Master, ignores the category sliders and snapshots.attack_us is in microseconds (20-2000), while release_ms is milliseconds; a value
of 10 means 10 µs, not 10 ms.AudioSettings.dspTime and PlayScheduled).AudioStreamSynchronized) or middleware.AudioStreamWAV never quantize: only Ogg Vorbis and MP3 streams
carry bpm and bar_beats for AudioStreamInteractive.max_polyphony, a randomizer stream, or a
pool; free on finished.references/adaptive-music.md: read when building layered or segmented music (stem sync,
bar-quantized switches, AudioStreamSynchronized, AudioStreamInteractive, stingers, an
intensity value with hysteresis).godot-audio: Godot players, buses, effects and import settings.game-feel: the feedback bundles that trigger impact sounds.game-ui-ux: the settings screen that holds the volume sliders.Last verified: 2026-11-11.
AudioServer.set_bus_volume_linear, AudioEffectCompressor.sidechain/attack_us/
release_ms, AudioStreamRandomizer, AudioStreamSynchronized (MAX_STREAMS = 32),
AudioStreamInteractive with TRANSITION_FROM_TIME_NEXT_BAR; bpm/bar_beats exist on
AudioStreamOggVorbis and AudioStreamMP3 only (Godot 4.7.2 class reference). Movie Maker
under --headless crashed in a local 4.7.2 test; it worked under xvfb-run.AudioSource.resource; mixer floor -80 dB;
AudioSettings.dspTime with AudioSource.PlayScheduled.ebur128 filter with peak=true reports BS.1770 integrated loudness and true peak
(https://ffmpeg.org/ffmpeg-filters.html#ebur128); tested with ffmpeg 6.1.>
---name: audio-designdescription: >---# skills/disciplines/audio-design/SKILL.mdFAQ
게시자에게서 skills/disciplines/audio-design/SKILL.md를 다운로드하거나 경로를 복사해 저장소를 엽니다. PlugMCP는 스킬을 목록에 올릴 뿐 파일을 호스팅하지 않습니다.
게시자가 https://github.com/gamedev-skills/awesome-gamedev-agent-skills에서 관리합니다.
Claude, Cursor, Codex, Grok Build는 게시자의 저장소에서 추가한 SKILL.md를 읽을 수 있습니다. Grok Bot은 채팅에서 스킬의 GitHub 폴더 링크를 보내면 설치합니다.