Le système de voix par défaut de FiveM fait le travail minimum. Pour une vraie immersion RP, avec de la voix 3D qui s'atténue à la distance et des canaux radio propres, la communauté utilise très largement pma-voice, un projet gratuit et open source. Voici comment l'installer proprement.
Qu'est-ce que pma-voice
pma-voice est un système de communication vocale avancé pour FiveM, maintenu par la communauté sur GitHub. Il remplace le système de voix basique par une voix 3D réaliste (le volume diminue avec la distance), des canaux radio configurables, plusieurs niveaux de voix (chuchoter, parler, crier), et une compatibilité annoncée avec la plupart des frameworks (ESX, QBCore, et frameworks maison).
Prérequis avant installation
- Un serveur FiveM fonctionnel, avec OneSync activé (recommandé pour la synchronisation audio entre joueurs).
- Un accès au gestionnaire de fichiers de votre panel (Pterodactyl inclus sur nos offres FiveM) ou à txAdmin.
- Une sauvegarde récente de votre serveur avant toute installation.
Utilisez toujours une version récente de l'artefact FXServer. Les versions anciennes causent régulièrement des incompatibilités avec les ressources communautaires activement maintenues, pma-voice y compris.
Étape 1 : télécharger pma-voice
Téléchargez la dernière version stable depuis le dépôt GitHub officiel du projet, jamais depuis un site tiers : des copies modifiées avec du code malveillant circulent régulièrement sous le nom de ressources FiveM populaires. Le dossier téléchargé doit contenir un fichier fxmanifest.lua à la racine : c'est le signe d'une ressource FiveM valide.
Étape 2 : installer sur votre serveur
- Connectez-vous à votre panel (Pterodactyl ou équivalent).
- Ouvrez le gestionnaire de fichiers et naviguez vers
resources/. - Créez un dossier nommé exactement
pma-voice, casse comprise. - Uploadez-y le contenu du dossier téléchargé.
Étape 3 : ajouter à server.cfg
L'ordre de chargement compte : pma-voice doit démarrer après les ressources de base de FiveM (mapmanager, chat, spawnmanager, sessionmanager, baseevents), mais avant vos scripts RP (framework, inventaire, etc.).
# Ressources de base
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure baseevents
# Voix
ensure pma-voice
# Vos scripts RP ensuite
ensure es_extendedÉtape 4 : configuration de base
Le fichier config.lua, à la racine du dossier pma-voice, permet d'ajuster les distances de voix par mode (chuchoter, normal, crier), d'activer ou non la radio, et de personnaliser les touches assignées. Les valeurs par défaut fonctionnent pour démarrer : ajustez-les progressivement une fois le système validé en jeu plutôt que de tout personnaliser avant le premier test. Pour les touches et canaux radio précis, référez-vous à la documentation à jour du dépôt GitHub, ces réglages évoluent avec les versions.
Étape 5 : tester
- Démarrez le serveur et surveillez la console au démarrage : elle doit confirmer que la ressource pma-voice a démarré sans erreur.
- Connectez-vous en jeu avec au moins deux joueurs : un indicateur micro doit apparaître à l'écran.
- Testez la voix à différentes distances pour vérifier l'atténuation 3D.
- Testez la radio si vous l'avez activée.
Dépannage : problèmes courants
Aucun log pma-voice au démarrage
Vérifiez l'orthographe exacte de ensure pma-voice (avec le tiret), l'arborescence des fichiers dans resources/, et redémarrez complètement le serveur plutôt qu'un simple restart de la ressource.
Les joueurs ne s'entendent pas
Vérifiez qu'OneSync est bien activé (set onesync on dans server.cfg) et testez avec au moins deux joueurs connectés simultanément : seul en jeu, il n'y a personne à entendre.
Audio de mauvaise qualité ou coupures
Vérifiez la bande passante disponible sur votre serveur et 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.
Questions fréquentes
pma-voice est-il gratuit ? Oui, entièrement gratuit et open source. Méfiez-vous de tout site qui prétend le vendre.
Fonctionne-t-il avec tous les frameworks ? Il est annoncé compatible avec la plupart des frameworks courants (ESX, QBCore et autres), mais vérifiez la documentation du projet pour votre configuration précise avant de l'intégrer en production.
Une fois votre système vocal en place, pensez à la sécurité globale du serveur : notre guide sur la protection contre les tricheurs couvre les bases. Et si vous partez tout juste de zéro, notre guide de mise en place d'un serveur FiveM et notre guide d'installation d'ESX Legacy posent les fondations avant d'ajouter des ressources comme celle-ci.