pma-voice is the standard voice chat resource for FiveM roleplay servers. It wraps FiveM's built-in Mumble implementation to provide proximity voice, radio channels, phone calls, and directional audio.
Quick Setup
1. Download pma-voice
Download the latest release from the pma-voice GitHub repository. Place the folder in your server resources directory.
2. Add to server.cfg
ensure pma-voice
Make sure pma-voice loads after your framework (QBCore, ESX).
3. Configure convars in server.cfg
setr voice_useNativeAudio true
setr voice_useSendingRangeOnly true
setr voice_defaultCycle "GRAVE"
setr voice_defaultVolume 0.5
setr voice_enableRadioAnim true
setr voice_zoneRadius 50.0
4. Enable voice chat in server.cfg
voice_chat true
5. Restart the server
How pma-voice Works
FiveM includes a native Mumble VoIP server. When players connect, they join a Mumble channel. pma-voice controls:
- Proximity: Players hear each other based on distance. Closer players are louder.
- Radio: Players on the same radio frequency hear each other regardless of distance.
- Phone: One-to-one voice calls through phone resources.
- Channels: Mumble uses integer channel IDs to separate audio groups.
Channel Offset Logic
Mumble routes audio through channels identified by integer IDs. pma-voice uses an offset system to separate different voice types:
- Proximity voice uses the base channel
- Radio frequencies are mapped to channel IDs with an offset
- Phone calls use separate channel IDs
Conflicts happen when another voice resource (like vdk_voice or legacy TokoVoIP) also manipulates Mumble channels. Only run one voice resource at a time.
Proximity Voice Cycling
Players can cycle through voice ranges using a keybind (default: grave/tilde key):
- Whisper: short range
- Normal: medium range
- Shout: long range
Configure ranges in the pma-voice config or via convars.
Radio Setup
pma-voice radio works with compatible radio resources. Players set a frequency, and anyone on the same frequency hears radio transmissions.
Common integration:
exports['pma-voice']:setRadioChannel(frequency)
Troubleshooting
No voice at all:
- Confirm voice_chat is enabled in server.cfg
- Check that pma-voice is started (ensure pma-voice)
- Verify no other voice resource is running
Players hear everyone globally:
- Check voice_useSendingRangeOnly is set to true
- Verify Mumble channel assignments are not conflicting
Radio not working:
- Ensure radio resource is compatible with pma-voice exports
- Check that players are on the same frequency
Voice cuts out or spatial audio breaks:
- Update pma-voice to the latest version
- Update FiveM artifacts
- Check server RAM (low memory can cause audio dropouts)
FAQ
What is pma-voice? A FiveM resource that provides proximity voice, radio, and phone voice chat using FiveM's built-in Mumble system.
Does pma-voice replace TokoVoIP? Yes. pma-voice is the modern standard. TokoVoIP is legacy and no longer maintained for current FiveM builds.
Can I use pma-voice with QBCore? Yes. pma-voice works with QBCore, ESX, and standalone setups.
What are Mumble channel IDs in pma-voice? Integer identifiers used internally by Mumble to route audio. pma-voice manages these automatically. Manual channel manipulation is only needed for advanced custom setups.
Related: FiveM voice chat Mumble fix, FiveM voice chat setup guide, FiveM server requirements