Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add EL4CTEO/roblox-skills --skill roblox-audio -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/roblox-audio/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/roblox-audio/

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.

roblox-audio TabooHarmony A skill for Roblox audio work: playback, 3D sound, music, effects and mixing through SoundGroups. CX Codex +1 3,500installs roblox-audio nonlooped This skill helps build and debug Roblox audio graphs, spatial sound, effects, and speech features. Use it when setting up playback or deciding whether to move from Sound to the audio graph. CX Codex +1 522installs scenario-roblox-vfx-audio scenario-labs The scenario-roblox-vfx-audio Claude Code skill builds and troubleshoots Roblox visuals and game audio. It applies to particle effects, combat feedback, 3D sound, and importing Scenario assets. CX Codex +1 379installs audio-design gamedev-skills The audio-design skill for Claude Code manages game audio buses, decibel sliders, ducking, and adaptive music. It assists with mixing in Godot, Unity, FMOD, and Wwise. CX Codex +1 14,200installs godot-audio gamedev-skills The godot-audio skill runs on Claude Code, Codex, Cursor and other platforms for managing audio APIs in Godot 4.7. It handles player routing, bus layouts, polyphony and headless checks. CX Codex +1 12,200installs optimize-audio Unity-Technologies The optimize-audio skill inspects Unity audio settings and helps trace memory use, mixer CPU load, and 3D playback issues. CX Codex +1 7,100installs audio-setup-mixers Unity-Technologies audio-setup-mixers sorts Audio Sources into the Audio Mixer groups a Unity project already has. It reads what each source plays, proposes a routing plan, then assigns it. CX Codex +1 4,900installs layer-audio layerai layer-audio configures agent prompts for generating sound effects, music, and spoken voice-overs with Layer. Keeps assets dry, sized, and fit for game engines. CX Codex +1 4,900installs

From the same set22

The whole set →
roblox-npc-ai The roblox-npc-ai Claude Code skill helps build AI for Roblox enemies, pets, and other NPCs. It covers pathfinding, chasing, attacks, and fixes for NPCs that get stuck or jitter. CX Codex +1 1,200installs roblox-teleport-matchmaking roblox-teleport-matchmaking — a skill for Claude Code handles player teleports and matchmaking flows in Roblox via TeleportService. CX Codex +1 1,200installs roblox-input roblox-input — a Claude Code skill for Roblox player controls and cameras. It comes into play when adding keybinds, abilities, vehicle controls, touch buttons, or a custom camera. CX Codex +1 1,200installs roblox-analytics-liveops roblox-analytics-liveops — a skill for Claude Code sets up game analytics, funnels, economy, and live ops for Roblox. Runs when instrumenting gameplay, economy tuning, or setting up A/B tests. CX Codex +1 1,200installs roblox-networking roblox-networking — a Claude Code skill for client-server communication in Roblox, helping configure remotes, validate server payloads, and reduce bandwidth. CX Codex +1 1,200installs roblox-data-stores roblox-data-stores — a Claude Code skill for Roblox persistence and cloud services. It covers player saves, leaderboards, queues, and fixes for lost or duplicated data. CX Codex +1 1,200installs roblox-studio-mcp Skill connects an AI agent to the built-in Roblox Studio MCP server for editing and playtesting games. CX Codex +1 1,200installs roblox-architecture The roblox-architecture Claude Code skill explains Roblox project structure and the client-server model. It activates when setting up a project or troubleshooting replication and streaming. CX Codex +1 1,200installs

Project sponsors

Companies that keep this analytics open