84 lines
1.8 KiB
Markdown
Raw Normal View History

2025-04-07 01:41:12 +00:00
# mana_audio
API for playing native audio. Stopping audio early or looping are not supported.
Thanks to PrinceAlbert, Demi-Automatic, ChatDisabled, Joe Szymkowicz, and Zoo
[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/O5O0NX2Q4)
## Client
### PlaySound
Plays a sound not located within the 3D world
```lua
exports.mana_audio:PlaySound({
audioBank = 'myAudioBank',
audioName = {'myAudioName1', 'myAudioName2'},
audioRef = 'myAudioRef'
})
```
### PlaySoundFromEntity
Plays a sound originating from an entity
```lua
exports.mana_audio:PlaySoundFromEntity({
audioBank = 'myAudioBank',
audioName = {'myAudioName1', 'myAudioName2'},
audioRef = 'myAudioRef',
entity = PlayerPedId()
})
```
### PlaySoundFromCoords
Plays a sound originating from coordinates
```lua
exports.mana_audio:PlaySoundFromCoords({
audioBank = 'myAudioBank',
audioName = {'myAudioName1', 'myAudioName2'},
audioRef = 'myAudioRef',
coords = vec3(0, 0, 0),
range = 10,
})
```
## Server
### PlaySound
Plays a sound not located within the 3D world to the given client or -1 for all clients
```lua
exports.mana_audio:PlaySound(-1, {
audioBank = 'myAudioBank',
audioName = {'myAudioName1', 'myAudioName2'},
audioRef = 'myAudioRef'
})
```
### PlaySoundFromEntity
Plays a sound originating from an entity to all clients
```lua
exports.mana_audio:PlaySoundFromEntity({
audioBank = 'myAudioBank',
audioName = {'myAudioName1', 'myAudioName2'},
audioRef = 'myAudioRef',
entity = GetPlayerPed(1)
})
```
### PlaySoundFromCoords
Plays a sound originating from coordinates to all clients in range
```lua
exports.mana_audio:PlaySoundFromCoords({
audioBank = 'myAudioBank',
audioName = {'myAudioName1', 'myAudioName2'},
audioRef = 'myAudioRef',
coords = vec3(0, 0, 0),
range = 10,
})
```