roblox-audio · el4cteo — Claude Code skill for Roblox sound
The roblox-audio Claude Code skill covers sound in Roblox, from music and effects to spatial audio. It activates for audio setup or when a sound fails to play.
MIT 1,200 installs ★ 131 updated 2026-11-03
npx skills add EL4CTEO/roblox-skills --skill roblox-audio -a claude-codeWhat roblox-audio does
The skill explains Roblox’s two audio approaches: the modular Audio API and classic Sound objects with SoundGroup. It covers 2D and 3D playback, effects, volume controls, client-side and server-side playback, voice routing, and text-to-speech.
It also covers asset permissions, streaming behavior, and acoustic simulation. Private audio owned by another creator will not play unless that creator shares it with the experience. For a single feature, the skill advises sticking to the audio system already used in the project rather than combining both.
What it helps with
- add background music or sound effects
- set up positional 3D audio with distance falloff
- find why audio fails to load or reach other players
- control music and SFX volume separately
- route voice chat through audio effects
Example prompts for the agent
- Add background music with the Audio API and give it a separate volume control.
- Set up a 3D sound on a part and configure its distance falloff.
- Find why other players cannot hear a sound when parts stream out.
How to install roblox-audio
1Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-audio -a claude-code2Manually: put the files in place
~/.claude/skills/roblox-audio/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/roblox-audio/
1Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-audio -a codex2Manually: put the files in place
.agents/skills/roblox-audio/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-audio -a cursor2Manually: put the files in place
.cursor/skills/roblox-audio/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install EL4CTEO/roblox-skills skills/roblox-audio2Manually: put the files in place
.github/skills/roblox-audio/SKILL.md1Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-audio -a gemini-cli2Platform CLI
gemini skills install https://github.com/EL4CTEO/roblox-skills --path skills/roblox-audioManually: put the files in place
.devin/skills/roblox-audio/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-audio -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about roblox-audio
How do I install roblox-audio in Claude Code?
Run npx skills add EL4CTEO/roblox-skills --skill roblox-audio -a claude-code. The skill file is at ~/.claude/skills/roblox-audio/SKILL.md.
What does roblox-audio do?
It helps configure Roblox music, sound effects, and spatial audio. The skill explains both the Audio API and classic Sound and SoundGroup objects.
How does the Audio API differ from classic Sound?
The Audio API connects modular players, emitters, listeners, and outputs in a signal chain. Classic Sound uses a single object; the skill recommends choosing one approach per feature.
Source text
SKILL.md · MIT
---
name: roblox-audio
description: Sound and music - the Audio API (AudioPlayer, AudioEmitter, AudioListener, AudioDeviceOutput, Wire, effects, faders), classic Sound/SoundGroup, 2D vs 3D audio, music and SFX volume, client vs server playback, asset permissions, streaming caveats, voice routing, text-to-speech. Use when adding music, sound effects, spatial audio, mixing, or fixing sounds that don't play.
---
# Roblox audio
Two systems coexist:
- **Audio API** (modular, current): `AudioPlayer` → `Wire` → (`AudioEmitter` … `AudioListener`) → `Wire`
→ `AudioDeviceOutput`, with effect objects inserted in the chain. Required for voice-chat processing,
mixing graphs, analyzers, text-to-speech/speech-to-text.
- **`Sound`** (classic, still supported): one object, parented to a part for 3D or to `SoundService`/UI for 2D;
routed through `SoundGroup`s with `SoundEffect` children. Fine for simple games and existing code.
Don't mix both for the same feature; follow what the project uses.
## 2D audio (music, UI) with the Audio API
```luau
--!strict
-- Client: build a music player once.
local SoundService = game:GetService("SoundService")
local player = Instance.new("AudioPlayer")
player.Name = "Music"
player.Asset = "rbxassetid://1843463175" -- AudioPlayer.AssetId is deprecated; use Asset
player.Looping = true
player.Volume = 0.5
player.Parent = SoundService
local fader = Instance.new("AudioFader") -- one place to control music volume (settings menu)
fader.Name = "MusicVolume"
fader.Parent = SoundService
local output = Instance.new("AudioDeviceOutput")
output.Parent = SoundService
local function wire(source: Instance, target: Instance)
local w = Instance.new("Wire")
w.SourceInstance = source
w.TargetInstance = target
w.Parent = target
end
wire(player, fader)
wire(fader, output)
player:Play()
```
## 3D audio with the Audio API
- Put an `AudioEmitter` on the sound's part/attachment; wire `AudioPlayer → AudioEmitter`.
- Listening: `SoundService.ListenerLocation` controls the default `AudioListener` (camera or character);
wire `AudioListener → AudioDeviceOutput` (done automatically in default setups).
- Distance falloff and directionality are set on the emitter/listener (`AudioEmitter:SetDistanceAttenuation`,
the `AudioInteractionGroup` string property on emitters and listeners scopes who hears what).
- **Acoustic simulation** (fully released; Audio API only, not `Sound` yet): set
`SoundService.AcousticSimulationEnabled = true` (in Studio) and 3D audio is muffled by walls, bends around
corners, and reverbs in rooms. Per part: `BasePart.AudioCanCollide` (false = doesn't block sound); thicker and
denser parts muffle more. Per emitter/listener: `AcousticSimulationEnabled`. Set
`SoundService.CharacterSoundsUseNewApi` so character sounds are simulated too. Quality scales down on weak devices.
## Classic Sound quick reference
```luau
--!strict
local SoundService = game:GetService("SoundService")
local sfxGroup = Instance.new("SoundGroup")
sfxGroup.Name = "SFX"
sfxGroup.Volume = 0.8
sfxGroup.Parent = SoundService
local function playAt(part: BasePart, soundId: string)
local sound = Instance.new("Sound")
sound.SoundId = soundId
sound.SoundGroup = sfxGroup
sound.RollOffMaxDistance = 80
sound.Parent = part -- 3D: plays from the part; parent to SoundService/UI for 2D
sound:Play()
sound.Ended:Once(function()
sound:Destroy()
end)
end
return playAt
```
- `SoundService:PlayLocalSound(sound)` for client-only UI clicks.
- Preload critical sounds: `ContentProvider:PreloadAsync({ sound })` (not everything — slows joins).
- Pool frequently played sounds instead of creating one per shot.
## Where to play
- Sounds started **on the client** are heard only by that client (UI, local feedback, music tracks
the player chose). Sounds started **on the server** replicate to everyone (use sparingly; prefer a
remote telling clients to play locally, which also lets each client apply its own volume settings).
- With `SoundService.RespectFilteringEnabled = true` (default), client-played sounds don't replicate.
- Streaming: a sound or emitter in a part that streams out stops. Keep ambient audio in persistent
models or `SoundService`.
## Assets and permissions
- Use audio you own, uploaded to the same owner (user/group) as the experience, or Creator Store
audio marked free-to-use. Private audio from other creators won't play unless shared with your
experience (asset permissions). Check the Output for "failed to load" / permission errors.
- Uploads are auto-classified as sound effects or songs; eligible songs can show on the game page.
## Extras
- Effects: `AudioEqualizer`, `AudioCompressor`, `AudioReverb`, `AudioEcho`, `AudioChorus`, `AudioDistortion`,
`AudioFlanger`, `AudioPitchShifter`, `AudioTremolo`, `AudioFilter`, `AudioLimiter`, `AudioAnalyzer` (read
loudness/spectrum for visualizers).
- `AudioTextToSpeech` (artificial voices) and `AudioSpeechToText` (transcription). `AudioTextToSpeech.AutoLocalize`
(default `true`) translates the text into each player's language (11 languages) and picks a matching
voice; set it to `false` for text that must stay as written (names, chants). Uploaded TTS assets aren't translated.
- Voice chat: each player's `AudioDeviceInput` can be wired through effects (radios, walkie-talkies,
proximity) — see the voice chat docs; respect players' voice settings.
- Give players separate Music/SFX volume sliders (faders or SoundGroups) and a mute option.
## Related skills
`roblox-ui` (settings menus), `roblox-architecture` (client vs server), `roblox-performance` (audio memory).
© EL4CTEO · MIT · EL4CTEO/roblox-skills
Similar skills
All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →roblox-audio by other authors comes first.