Comment installer pma-voice sur FiveM : guide complet

pma-voice est le script de voix proximité le plus utilisé sur FiveM. Gratuit, open source (licence MIT) et activement maintenu, il remplace le système vocal basique par une voix 3D réaliste avec atténuation par la distance, des canaux radio configurables et plusieurs modes de proximité (chuchoter, parler, crier). Ce guide détaille l'installation complète de pma-voice sur votre serveur FiveM : choix de l'hébergement, transfert des fichiers, configuration réseau, dépannage et maintenance.

Qu'est-ce que pma-voice

pma-voice est une ressource FiveM qui encapsule le serveur Mumble intégré au moteur FiveM. Concrètement, ce script fournit :

• Voix proximité 3D : le volume diminue avec la distance entre les joueurs, avec trois modes par défaut (chuchoter, normal, crier).
• Système radio : canaux radio avec réglage du volume, effet sonore d'activation et animation de micro à l'épaule.
• Système d'appel : communication téléphonique intégrée, utilisable par les scripts RP (téléphone, intercom).
• Interface intégrée : un indicateur micro à l'écran et le changement de mode de proximité par touche (F11 par défaut).
• Compatibilité frameworks : annoncé compatible avec ESX Legacy, QBCore et la plupart des frameworks maison.

Le projet est maintenu sur GitHub par AvarianKnight. Il ne nécessite aucune dépendance externe : tout est inclus dans le dossier de la ressource. Si vous mettez en place un serveur FiveM pour la première fois, commencez par notre guide de configuration d'un serveur FiveM avant d'ajouter pma-voice.

Quel hébergement pour un serveur FiveM avec pma-voice

pma-voice ajoute peu de charge : le traitement vocal est géré côté client et par le serveur Mumble intégré. C'est le serveur FiveM lui-même qui définit les besoins en ressources. Voici les critères pour bien héberger votre serveur.

Serveur VPS, serveur dédié ou hébergement mutualisé ?

Un hébergement mutualisé est conçu pour des sites web et des CMS (WordPress, Joomla), avec un serveur web comme Apache ou Nginx, du PHP et des bases de données MySQL partagées entre plusieurs clients. Ce type d'offre mutualisée ne permet pas de faire tourner un serveur de jeu FiveM : pas d'accès root, pas de ports dédiés, pas de contrôle sur la RAM ou le CPU.

Pour héberger un serveur FiveM, deux options adaptées :

Pour la plupart des serveurs FiveM RP avec pma-voice, un serveur VPS avec au moins 4 Go de RAM, un processeur rapide et un espace disque SSD suffit largement. Si votre communauté dépasse 64 joueurs simultanés ou que vous hébergez plusieurs serveurs, un serveur dédié offre des ressources non partagées. Consultez notre guide pour choisir le meilleur hébergeur FiveM pour approfondir ces critères.

Si vous préférez un hébergement FiveM premium avec panel intégré, gestion simplifiée et infogérance, nos offres serveur FiveM incluent Pterodactyl, un gestionnaire de fichiers, l'accès à la console et des sauvegardes automatiques.

Prérequis avant installation

• Un serveur FiveM fonctionnel avec OneSync activé (set onesync on dans server.cfg).
• Un accès au serveur : panel d'administration (Pterodactyl, txAdmin), connexion SSH ou client FTP.
• Un artefact FXServer récent. Les versions obsolètes causent des incompatibilités avec les ressources communautaires activement maintenues.
• Une sauvegarde complète avant toute installation : fichiers de configuration, base de données MySQL, dossier resources/. Consultez notre guide des sauvegardes FiveM.

Étape 1 : télécharger pma-voice

Téléchargez la dernière version stable depuis le dépôt GitHub officiel (AvarianKnight/pma-voice). Ne téléchargez jamais depuis un site tiers : des copies modifiées contenant du code malveillant circulent régulièrement sous le nom de ressources et extensions FiveM populaires. Pour trouver des scripts FiveM fiables, consultez notre guide des scripts FiveM : où les trouver, lesquels éviter.

Le dossier téléchargé doit contenir un fichier fxmanifest.lua à la racine : c'est le manifeste qui identifie une ressource FiveM valide. Vérifiez aussi la présence du fichier config.lua, des dossiers client/ et server/, et du répertoire ui/ pour l'interface intégrée.

Étape 2 : transférer les fichiers sur le serveur

Trois méthodes pour déposer pma-voice dans le répertoire resources/ de votre serveur FiveM :

Via le panel (Pterodactyl / txAdmin)

Si votre hébergeur fournit un panel comme Pterodactyl, utilisez le gestionnaire de fichiers intégré. Naviguez vers resources/, créez un dossier nommé exactement pma-voice (casse comprise), et uploadez-y le contenu du dossier téléchargé. C'est la méthode la plus simple si vous n'avez pas d'accès SSH direct au serveur.

Via FTP / SFTP

Avec un client FTP (FileZilla, WinSCP), connectez-vous à votre serveur en utilisant l'adresse IP, le port et vos identifiants. Naviguez vers le répertoire du serveur FiveM, puis vers resources/. Créez le dossier pma-voice et transférez les fichiers. Préférez SFTP (FTP chiffré via SSH) au FTP classique pour protéger vos identifiants en transit.

Via SSH (ligne de commande)

Si vous disposez d'un accès SSH avec les droits root ou un utilisateur sudo sur votre serveur VPS, clonez directement le dépôt dans le dossier resources/ :

cd /chemin/vers/votre-serveur-fivem/resources/
git clone https://github.com/AvarianKnight/pma-voice.git pma-voice

Cette méthode facilite les mises à jour ultérieures : un simple git pull dans le dossier pma-voice récupère la dernière version sans tout retransférer par FTP.

Étape 3 : configurer server.cfg

L'ordre de chargement des ressources dans server.cfg est critique. pma-voice doit démarrer après les ressources de base FiveM et avant vos scripts RP (framework, inventaire, téléphone, etc.) :

# Ressources de base FiveM
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure baseevents

# Voix (pma-voice)
ensure pma-voice

# Framework (ESX, QBCore, etc.) et scripts RP
ensure es_extended
# ensure qb-core

Un mauvais ordre de chargement est la cause la plus fréquente d'échec au démarrage de pma-voice. Si vous utilisez un framework avec une base de données MySQL (ESX Legacy, QBCore), les scripts liés aux bases de données doivent démarrer avant ceux qui en dépendent. Consultez notre guide de connexion MySQL pour serveur FiveM si votre base n'est pas encore configurée.

Étape 4 : configurer pma-voice

pma-voice se configure principalement via des convars (variables de configuration) ajoutées dans votre server.cfg, avant la ligne ensure pma-voice. Voici les réglages essentiels à configurer.

Mode audio

Choisissez un seul mode audio parmi les trois disponibles. Ne les combinez jamais, sous peine de comportement imprévisible :

Proximité et interface

# Interface micro à l'écran (1 = activée, 0 = désactivée)
setr voice_enableUi 1

# Changement de mode de proximité par touche (1 = activé)
setr voice_enableProximityCycle 1

# Touche pour changer la portée de voix (F11 par défaut)
setr voice_defaultCycle "F11"

# Mode de voix au spawn (1 = chuchoter, 2 = normal, 3 = crier)
setr voice_defaultVoiceMode 2

Radio et appels

# Activer le système radio (1 = oui)
setr voice_enableRadios 1

# Touche pour activer la radio (LMENU = Alt gauche)
setr voice_defaultRadio "LMENU"

# Volume radio par défaut (1-100)
setr voice_defaultRadioVolume 30

# Activer les appels téléphoniques (1 = oui)
setr voice_enableCalls 1

# Volume des appels (1-100)
setr voice_defaultCallVolume 60

# Effets audio submix radio/téléphone (nécessite voice_useNativeAudio)
setr voice_enableSubmix 1

# Animation de micro à l'épaule quand la radio est activée
setr voice_enableRadioAnim 1

Étape 5 : réseau et sécurité du serveur

pma-voice utilise le serveur Mumble intégré à FiveM : il passe par la même connexion que le jeu, sur le port 30120 (TCP et UDP par défaut). Aucun port supplémentaire n'est nécessaire pour la voix.

Configurer le pare-feu (firewall)

Si vous administrez un serveur VPS sous Ubuntu ou Debian, vérifiez que votre firewall autorise le port FiveM :

# Avec UFW (Ubuntu / Debian)
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw status

Si vous utilisez un port personnalisé dans server.cfg (endpoint_add_tcp / endpoint_add_udp), adaptez les règles du pare-feu en conséquence. Un firewall mal configuré est la cause la plus fréquente de connexion impossible au serveur.

Nom de domaine et DNS

Pour que vos joueurs se connectent via un nom de domaine plutôt qu'une adresse IP brute (par exemple play.monserveur.fr au lieu de 203.0.113.10:30120), créez un enregistrement DNS de type A pointant vers l'adresse IP de votre serveur VPS ou serveur dédié chez votre hébergeur. Côté FiveM, aucune configuration supplémentaire n'est requise : le client résout le DNS avant la connexion.

Étape 6 : tester l'installation

1. Console serveur : au démarrage, la console doit afficher le chargement de pma-voice sans erreur. Activez le mode debug pour plus de détails : setr voice_debugMode 1 dans server.cfg (1 = basique, 4 = verbeux).
2. Test en jeu : connectez-vous avec au moins deux joueurs. Un indicateur micro doit apparaître à l'écran. Appuyez sur F11 pour changer le mode de proximité (chuchoter, normal, crier).
3. Test de distance : placez deux joueurs à différentes distances et vérifiez l'atténuation progressive du son en mode 3D.
4. Test radio : si la radio est activée, vérifiez qu'un joueur peut rejoindre un canal et communiquer avec un autre joueur sur le même canal, quelle que soit la distance.

Maintenir pma-voice à jour

Mises à jour du script

pma-voice est activement maintenu. Vérifiez régulièrement le dépôt GitHub pour les nouvelles versions et les correctifs. Si vous avez installé via git clone, la mise à jour se fait en SSH :

cd /chemin/vers/resources/pma-voice
git pull origin master

Si vous avez transféré les fichiers manuellement (FTP ou panel), téléchargez la nouvelle version depuis GitHub et remplacez le contenu du dossier pma-voice. Faites toujours un backup du dossier avant de mettre à jour, au cas où la nouvelle version introduit une incompatibilité avec vos scripts existants.

Sauvegardes régulières

Incluez le dossier resources/pma-voice/ et votre server.cfg dans vos sauvegardes automatiques. Si votre serveur utilise un framework RP avec MySQL, sauvegardez aussi les bases de données : une perte de données joueurs est irréversible. Notre guide des sauvegardes FiveM détaille la stratégie de backup complète.

Dépannage : problèmes courants

pma-voice ne démarre pas (aucun log en console)

• Vérifiez l'orthographe exacte de ensure pma-voice dans server.cfg (avec le tiret).
• Vérifiez que le dossier dans resources/ s'appelle exactement pma-voice et contient fxmanifest.lua à la racine.
• Redémarrez complètement le serveur (quit dans la console, puis relancez) plutôt qu'un simple restart pma-voice.

Les joueurs ne s'entendent pas

• Vérifiez qu'OneSync est bien activé : set onesync on dans server.cfg.
• Vérifiez qu'aucune autre ressource vocale n'est chargée en même temps (SaltyChat, TokoVOIP). pma-voice est incompatible avec les autres systèmes vocaux.
• Si vous utilisez vMenu, désactivez le chat vocal intégré de vMenu.
• Testez avec au moins deux joueurs connectés simultanément.

Audio de mauvaise qualité ou coupures

• Vérifiez la bande passante disponible sur votre serveur VPS ou serveur dédié.
• Réduisez la portée de voix par défaut si le serveur est très fréquenté : plus de joueurs à portée signifie plus de flux audio à synchroniser.
• Si le CPU du serveur est saturé, la qualité vocale en souffre. Consultez notre guide d'optimisation des performances serveur FiveM.

Conflit avec d'autres scripts ou extensions

• Aucun de vos scripts ne doit appeler NetworkSetTalkerProximity, MumbleSetTalkerProximity, MumbleSetAudioInputDistance, MumbleSetAudioOutputDistance ou NetworkSetVoiceActive. Ces fonctions natives sont gérées exclusivement par pma-voice.
• Vérifiez les extensions et scripts tiers qui modifient le comportement audio ou la proximité vocale.

Questions fréquentes

pma-voice est-il gratuit ? Oui, entièrement gratuit et open source sous licence MIT. Méfiez-vous de tout site qui prétend le vendre.

Fonctionne-t-il avec ESX Legacy et QBCore ? Il est annoncé compatible avec la plupart des frameworks courants. Si votre framework utilise une base de données MySQL pour stocker les données joueurs, pma-voice n'interfère pas avec ces bases de données : il ne gère que la voix. Pour configurer MySQL avec votre framework, suivez notre guide MySQL pour serveur FiveM.

Faut-il un accès root pour installer pma-voice ? Non. Un accès au panel (Pterodactyl, txAdmin) ou un accès FTP au dossier resources/ suffit pour déposer les fichiers. L'accès root (SSH) est utile si vous administrez le serveur VPS vous-même : configurer le firewall, appliquer les mises à jour système, installer des packages.

pma-voice consomme-t-il beaucoup de RAM ? Non. L'empreinte mémoire de pma-voice est négligeable. C'est le serveur FiveM, le nombre de joueurs connectés et le nombre de scripts chargés qui déterminent la consommation de RAM et de CPU.

Peut-on utiliser pma-voice sur un serveur virtuel (VPS) ? Oui. Un VPS avec virtualisation KVM, 4 Go de RAM et un processeur rapide convient à la majorité des serveurs FiveM RP. L'important est la fréquence CPU mono-thread, pas le nombre de coeurs.

Faut-il ouvrir des ports supplémentaires pour la voix ? Non. pma-voice utilise le serveur Mumble intégré à FiveM, qui passe par le port 30120 (TCP et UDP). Vérifiez simplement que votre pare-feu autorise ce port.

Comment sécuriser un serveur FiveM avec pma-voice ? La sécurité du serveur ne dépend pas de pma-voice mais de votre configuration système : firewall actif, accès SSH par clé, mises à jour régulières du système et des scripts, protection anti-DDoS. Notre guide de sécurisation FiveM couvre le sujet en détail.

Si vous construisez votre serveur RP de A à Z, nos guides complémentaires vous accompagnent : installer ESX Legacy, protéger votre serveur contre les tricheurs et optimiser les performances de votre serveur FiveM.