03 - Voice

2 min read

Voice — pma-voice / Mumble

INFO

Il voice in FiveM usa Mumble (integrato) e script che lo controllano. Il più usato è pma-voice, che gestisce prossimità, radio e telefoni.

ObiettivoDettagli
Cosa imparerai• Installare pma-voice
• Prossimità e range
• Radio e altri canali
• Integrare con job (es. solo polizia sente la radio)
Prerequisiti• Server attivo
• (Consigliato) un framework

1. Cos’è Mumble in FiveM

FiveM ha il supporto Mumble integrato. Gli script voice (pma-voice) controllano:

  • Range di prossimità
  • Canali (radio, telefoni)
  • Volume e muting

WARNING

Il voice richiede il client FiveM recente con Mumble abilitato. Se il server ha server build molto vecchie, il voice potrebbe non funzionare.

2. Installare pma-voice

# nella cartella resources
git clone https://github.com/AvarianKnight/pma-voice.git

Nel server.cfg (prima del framework):

ensure pma-voice

Impostazioni di base (convars)

# Abilita voice (importante)
setr voice_enabled true
 
# Intervalli di prossimità
setr voice_1 "10.0"
setr voice_2 "20.0"
setr voice_3 "35.0"
setr voice_4 "50.0"

3. Range di Prossimità

pma-voice usa 4 livelli di prossimità (default):

LivelloRange
voice_1Whisper (10m)
voice_2Normale (20m)
voice_3Alto (35m)
voice_4Urla / megafono (50m)
-- client.lua
-- Imposta il range del giocatore (0-4)
exports.pma-voice:setVoiceProximity(3)

4. Radio

-- client.lua
-- Apri/chiudi la radio
exports.pma-voice:setRadioChannel(1)       -- entra nel canale 1
exports.pma-voice:setRadioChannel(0)       -- esce
 
-- Manda un segnale "squillo" se richiesto

Radio per job

Per fare in modo che solo la polizia senta la radio, proteggi i canali:

-- server.lua
RegisterNetEvent('voice:setRadio')
AddEventHandler('voice:setRadio', function(channel)
    local xPlayer = ESX.GetPlayerFromId(source)
    local job = xPlayer and xPlayer.getJob()
    local allowedChannel = Config.RadioChannels[job.name]  -- es. polizia -> canale 1
 
    if allowedChannel == channel then
        TriggerClientEvent('pma-voice:setRadioChannel', source, channel)
    end
end)

NOTE

Le export di pma-voice si chiamano exports['pma-voice']:nome() (con trattino e parentesi quadre). Controlla la documentazione ufficiale per le export complete.

5. Megafono e Accessi

-- client.lua
-- Abilita il megafono (es. auto di polizia)
exports['pma-voice']:setMuffle(true)     -- voce soffocata
exports['pma-voice']:setMegaphone(true)  -- megafono attivo

6. Telefono (opzionale)

Molti script telefonici (es. npwd, gks-phone) si integrano con pma-voice per le chiamate. Di solito basta installarli e configurarli per usare pma-voice come voce.

Verifica

  • pma-voice avviato prima del framework
  • voice_enabled true impostato
  • I giocatori si sentono in prossimità
  • Radio funzionante
  • Canali radio protetti per job

TIP

Prossimo passo: 04 - Meteo e Tempo

Torna alla: Indice Generale