- name
SKILL.md
Tệp skill vẫn nằm trong kho mã của nhà phát hành.
Dán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill audio-design -a cursor -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill audio-design -a claude-code -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill audio-design -a codex -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill audio-design -a grok -yGửi tin nhắn đã sao chép trong cuộc trò chuyện Grok Bot. Bot sẽ lấy tệp SKILL.md này từ GitHub và thêm vào bộ skill mà mọi Bot của bạn dùng chung.
Install this skill: https://github.com/gamedev-skills/awesome-gamedev-agent-skills/tree/HEAD/skills/disciplines/audio-designTừ nhà phát hành
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.mdCâu hỏi thường gặp
Tải skills/disciplines/audio-design/SKILL.md từ nhà phát hành, hoặc sao chép đường dẫn và mở kho mã. PlugMCP chỉ liệt kê skill và không lưu trữ tệp này.
Nhà phát hành duy trì nó tại https://github.com/gamedev-skills/awesome-gamedev-agent-skills.
Claude, Cursor, Codex và Grok Build có thể đọc tệp SKILL.md mà bạn thêm từ kho mã của nhà phát hành. Grok Bot cài đặt skill khi bạn gửi liên kết thư mục GitHub của skill trong cuộc trò chuyện.