Compatibility with pma-voice

This guide explains how to make the Advanced Megaphone System compatible with PMA-Voice.

---

1. Installation & Basic Setup

1. Install PMA-Voice and r_megaphone on your server.

2. Enable PMA-Voice compatibility in the config.lua file:

   Config.Compatibility.PMAVoice.enabled = true
   Config.Compatibility.PMAVoice.resourceName = 'pma-voice'

3. Ensure that pma-voice is started before r_megaphone in your server.cfgIf they are in start folders, you need to start them manually separately.

   ✅ Correct order in server.cfg:

   ensure pma-voice  
   ensure r_megaphone  

4. Restart your server to apply the changes.

---

2. Common Errors & Solutions

2.1 Error: Your server must be restarted to support pma-voice

Why does this issue occur? This error typically appears when r_megaphone is started for the first time without restarting the server. The script tries to auto-generate a file named megaphone.lua inside the pma-voice script. However, it might fail due to:

• Missing write permissions.

• Incorrect folder structure.

• A server that hasn’t been restarted after installing the resource.

---

✅ Steps to Fix This Issue

Step 1: Manually Create the megaphone.lua File

1. Go to:

   ../pma-voice/client/

2. Create a new file called:

   megaphone.lua

3. Paste the following code into it:

table.insert(Cfg.voiceModes, {35.0, 'Megaphone'}) -- You can change the distance here

exports('setMegaphone', function(bool, value)
    if bool then
        mode = #Cfg.voiceModes
        setProximityState(Cfg.voiceModes[#Cfg.voiceModes][1], true)
        TriggerEvent('pma-voice:setTalkingMode', #Cfg.voiceModes)
    else
        mode = value
        setProximityState(Cfg.voiceModes[value][1], false)
        TriggerEvent('pma-voice:setTalkingMode', value)
    end
end)

exports('getMegaphone', function()
    return mode
end)

RegisterCommand('cycleproximity', function()
    if GetConvarInt('voice_enableProximityCycle', 1) ~= 1 or disableProximityCycle then return end
    local newMode = mode + 1

    if newMode <= #Cfg.voiceModes and newMode ~= #Cfg.voiceModes-1 then
        mode = newMode
    else
        mode = 1
    end

    setProximityState(Cfg.voiceModes[mode][1], false)
    TriggerEvent('pma-voice:setTalkingMode', mode)
end, false)

if gameVersion == 'fivem' then
    RegisterKeyMapping('cycleproximity', 'Cycle Proximity', 'keyboard', GetConvar('voice_defaultCycle', 'F11'))
end

---

Step 2: Modify the fxmanifest.lua in pma-voice

Add this line at the bottom (You must start this file separately even if you already have a global start of the files.):

client_script 'client/megaphone.lua'

---

Step 3: Ensure the Correct Startup Order

In your server.cfg, verify this order:

ensure pma-voice  
ensure r_megaphone

---

Step 4: Restart the Server

After applying all changes, restart your server to ensure the megaphone integration is active.

---

2.2 Error: r_megaphone must have these line(s) below in your server.cfg file to work

Cause: The r_megaphone script needs these two lines to produce the appropriate voice effects.

Solution: Check that these two lines appear in server.cfgIf not, add them.

setr voice_useNativeAudio true
setr voice_enableSubmix 1

---

2.3 Error: r_megaphone must be started after pma-voice in the server.cfg file!

Cause: r_megaphone depends on pma-voice and must load afterward to access its functions.

Solution: Adjust your server.cfg:

ensure pma-voice  
ensure r_megaphone