roblox-audio · el4cteo — скилл для Claude Code: звук в Roblox
Скилл roblox-audio для Claude Code помогает настраивать звук в Roblox: музыку, эффекты и пространственное аудио. Включается при добавлении звука или поиске причины, по которой он не воспроизводится.
MIT 1 200 установок ★ 131 обновлён 2026-11-03
npx skills add EL4CTEO/roblox-skills --skill roblox-audio -a claude-codeЧто делает roblox-audio
Скилл объясняет, как устроены два аудиосистемных подхода Roblox: модульный Audio API и классические Sound с SoundGroup. В нём разобраны 2D- и 3D-звук, эффекты, регулировка громкости, воспроизведение на клиенте и сервере, маршрутизация голосового чата и преобразование текста в речь.
Также описаны права на аудио, потоковая загрузка и акустическая симуляция. Приватное аудио другого автора не воспроизводится, пока владелец не откроет к нему доступ для игры. Для одной функции не следует смешивать Audio API и Sound: нужно продолжать использовать систему, принятую в проекте.
Какие задачи решает
- добавить фоновую музыку или звуковые эффекты
- настроить позиционный 3D-звук и затухание по расстоянию
- разобраться, почему звук не загружается или не слышен другим игрокам
- развести громкость музыки и эффектов
- обработать голосовой чат через аудиоэффекты
Примеры запросов агенту
- Добавь фоновую музыку через Audio API и настрой отдельную громкость.
- Настрой 3D-звук эффекта на детали с затуханием по расстоянию.
- Разберись, почему звук не слышен другим игрокам при потоковой загрузке деталей.
Как установить roblox-audio
1Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-audio -a claude-code2Вручную: положить файлы
~/.claude/skills/roblox-audio/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/roblox-audio/
1Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-audio -a codex2Вручную: положить файлы
.agents/skills/roblox-audio/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-audio -a cursor2Вручную: положить файлы
.cursor/skills/roblox-audio/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install EL4CTEO/roblox-skills skills/roblox-audio2Вручную: положить файлы
.github/skills/roblox-audio/SKILL.md1Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-audio -a gemini-cli2Командой платформы
gemini skills install https://github.com/EL4CTEO/roblox-skills --path skills/roblox-audioВручную: положить файлы
.devin/skills/roblox-audio/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-audio -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о roblox-audio
Как установить roblox-audio в Claude Code?
Выполни npx skills add EL4CTEO/roblox-skills --skill roblox-audio -a claude-code. Файл скилла находится по пути ~/.claude/skills/roblox-audio/SKILL.md.
Что делает roblox-audio?
Скилл помогает работать с музыкой, звуковыми эффектами и пространственным аудио в Roblox. Он описывает Audio API и классические Sound и SoundGroup.
Чем Audio API отличается от классических Sound?
Audio API строит модульную цепочку из аудиоплеера, соединений, источников и выходов. Классический Sound — отдельный объект; для одной функции скилл советует использовать только один из этих подходов.
Исходный текст
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
Похожие скиллы
Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →Сначала — roblox-audio от других авторов.