Obsi Lib plays sounds through its own NUI player, with volume that follows the distance live, or through xsound when it is running.
Playing sounds
ObsiLib.sound.play('click', { volume = 0.4 })
local id = ObsiLib.sound.playAt(GetEntityCoords(PlayerPedId()), 'engine_loop', { range = 15.0, loop = true })
ObsiLib.sound.setPosition(id, newCoords) -- volume follows the distance every 100 ms
ObsiLib.sound.stop(id)
ObsiLib.sound.stopAll()Short names play web/build/sounds/<name>.mp3.
Add your own files to web/public/sounds before building the UI.
Broadcasting to nearby players
ObsiLib.sound.broadcast('horn', { range = 30.0, id = 'horn' }) -- everyone near you
ObsiLib.sound.unbroadcast('horn')The server checks the range (up to ObsiConfig.Sound.MaxBroadcastRange) and rate (BroadcastCooldown).
Streams and URLs
-- xsound when it runs, the built-in player otherwise
ObsiLib.sound.url('radio_1', 'https://example.com/stream.mp3', { coords = coords, range = 25.0, volume = 0.3 })
ObsiLib.sound.seek('radio_1', 30) -- xsound only
ObsiLib.sound.provider() -- 'xsound' | 'nui' | 'none'Server-side sounds are on Notifications and logs.