К основному содержанию
скилл CX Codex

roblox-audio · el4cteo — скилл для Claude Code: звук в Roblox

Скилл roblox-audio для Claude Code помогает настраивать звук в Roblox: музыку, эффекты и пространственное аудио. Включается при добавлении звука или поиске причины, по которой он не воспроизводится.

MIT 1 200 установок ★ 131 обновлён 2026-11-03

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add EL4CTEO/roblox-skills --skill roblox-audio -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

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

Папка скилла целиком; для одного проекта — .claude/skills/roblox-audio/

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

roblox-audio TabooHarmony Скилл roblox-audio для работы со звуком в Roblox: воспроизведение, 3D-звук, музыка, эффекты и микширование через SoundGroups. CX Codex +1 3 500установок roblox-audio nonlooped Скилл roblox-audio помогает собирать и отлаживать аудиосистемы Roblox: от позиционного звука до преобразования речи. Пригодится при настройке аудиографа или миграции со старого Sound. CX Codex +1 522установок scenario-roblox-vfx-audio scenario-labs Скилл scenario-roblox-vfx-audio для Claude Code помогает создавать и чинить визуальные эффекты и игровой звук в Roblox. Включается при работе с частицами, анимацией ударов, 3D-аудио и импортом ресурсов Scenario. CX Codex +1 379установок audio-design gamedev-skills Скилл audio-design для Claude Code управляет шинами, громкостью в децибелах, дакингом и адаптивной музыкой в играх. Помогает настроить микс в Godot, Unity, FMOD и Wwise. CX Codex +1 14 200установок godot-audio gamedev-skills Скилл godot-audio работает в Claude Code, Codex, Cursor и других платформах для настройки аудиосистемы в Godot 4.7. Решает задачи маршрутизации звука, полифонии и проверки шин. CX Codex +1 12 200установок optimize-audio Unity-Technologies Скилл optimize-audio проверяет настройки аудио в Unity и помогает найти причины высокого расхода памяти, нагрузки на микшер или проблем с 3D-звуком. CX Codex +1 7 100установок audio-setup-mixers Unity-Technologies Скилл audio-setup-mixers разносит Audio Sources по готовым группам Audio Mixer в Unity: смотрит, что играет каждый источник, и предлагает маршрут. Нужен живой редактор. CX Codex +1 4 900установок layer-audio layerai Скилл layer-audio настраивает промпты для генерации звуковых эффектов, музыки и озвучки через платформу Layer. Помогает избежать лишнего эха и каши в аудиодорожках. CX Codex +1 4 900установок

Из того же набора22

Весь набор →
roblox-npc-ai Скилл roblox-npc-ai для Claude Code помогает создавать ИИ врагов, питомцев и других NPC в Roblox. Используется для настройки поиска пути, преследования, атак и поведения персонажей, а также для исправления застревающих NPC. CX Codex +1 1 200установок roblox-teleport-matchmaking Скилл roblox-teleport-matchmaking для Claude Code управляет телепортацией игроков и созданием матчей в Roblox через TeleportService. CX Codex +1 1 200установок roblox-input Скилл roblox-input для Claude Code настраивает ввод игрока и камеры в Roblox. Он подключается к задачам с клавишами, способностями, транспортом, сенсорными кнопками или собственной камерой. CX Codex +1 1 200установок roblox-analytics-liveops Скилл roblox-analytics-liveops для Claude Code настраивает игровую аналитику, воронки, экономику и live-ops на Lua. Включается при добавлении событий, A/B-тестов или начислении наград. CX Codex +1 1 200установок roblox-networking Скилл roblox-networking для Claude Code управляет сетевым взаимодействием клиента и сервера на Roblox, помогая настраивать RemoteEvent, RemoteFunction и оптимизировать трафик. CX Codex +1 1 200установок roblox-data-stores Скилл roblox-data-stores для Claude Code помогает проектировать сохранение данных игроков и облачные сервисы Roblox. Включается при настройке таблиц лидеров, очередей или устранении потери и дублирования данных. CX Codex +1 1 200установок roblox-studio-mcp Скилл Claude Code подключает ИИ-агент к встроенному серверу Roblox Studio через протокол MCP для проверки и правки игровых миров. CX Codex +1 1 200установок roblox-architecture Скилл roblox-architecture для Claude Code объясняет устройство проекта Roblox и разделение кода между клиентом и сервером. Включается при настройке структуры проекта и разборе проблем с репликацией или стримингом. CX Codex +1 1 200установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой