el4cteo/roblox-skills

roblox-audio

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 rout…

Vedi sorgente

Come usare

  1. Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
  2. Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
  3. Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/el4cteo/roblox-skills --skill roblox-audio

Prima di iniziare

  • L’installazione non include abbonamenti, quote API o accesso ai file.
  • Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Documento Skill originale

Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.

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 SoundGroups 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.
  • Raw samples in Luau: AudioStreamReader:Read(into) pulls buffers (one per channel) from the wired

input for custom analysis; AudioStreamWriter:Write(buffers) pushes synthesized audio (check Space() first). Both are thread-safe, so the processing can run in parallel Luau.

  • VideoFrame.SubtitlesChanged(cues) fires when on-screen subtitle cues change (including live streams).

Related skills

roblox-ui (settings menus), roblox-architecture (client vs server), roblox-performance (audio memory).

dallo stesso repository

Altri Skills

Tutti gli Skills
el4cteo
Community

roblox-architecture

Roblox project structure and client/server model - replication, where code and assets belong (ServerScriptService, ReplicatedStorage, StarterPlayer), RunContext, service/controller bootstrapping, player/character lifecycle, CollectionService components, attributes, streaming-safe client code, library choices. Use when starting a project, deciding where code goes, or fixing replication/streaming bugs.

Installazioni / 1h
5
GitHub Stars
131
Aggiornato
17 nov
el4cteo
Community

roblox-characters-animation

Characters and animation - Humanoid properties/states, spawning (LoadCharacterAsync), health and damage, HumanoidDescription appearance, Animator/AnimationTrack playback, priorities and markers, default animation replacement, Tools, TweenService, IKControl, Character Controller Library (beta). Use when changing movement, abilities, damage, respawn, avatars, animations, tweens, or tools/weapons.

Installazioni / 1h
5
GitHub Stars
131
Aggiornato
17 nov
el4cteo
Community

roblox-code-review

Review Roblox/Luau code for exploits, data loss, memory leaks, performance problems, lifecycle bugs, policy issues, and deprecated or superseded APIs, using a severity-ranked checklist and the full 2026 deprecation map. Use when reviewing a PR or script, auditing a game before launch, modernizing legacy code, or asked what is wrong with some Roblox code.

Installazioni / 1h
5
GitHub Stars
131
Aggiornato
17 nov
el4cteo
Community

roblox-game-systems

Recipes for common systems built on server authority - currency service and leaderstats, XP/levels, round loops with intermission and teams, validated melee/ranged combat, inventory and tools, soft-currency shops, obby checkpoints, daily rewards, pets. Use when implementing or reviewing gameplay systems such as rounds, combat, weapons, inventories, shops, currencies, or progression.

Installazioni / 1h
5
GitHub Stars
131
Aggiornato
17 nov