Aller au contenu

Comment Installer PMA Voice sur FiveM : Guide Complet 2025

Comment Installer PMA Voice sur FiveM

Vous voulez ajouter un système de voix de qualité professionnelle à votre serveur FiveM ? PMA Voice est LA solution incontournable en 2025. Ce guide vous explique comment installer PMA Voice sur votre serveur FiveM hébergé, même si vous débutez complètement avec Elypsecloud !

PMA Voice transforme l’expérience RP de vos joueurs avec un système de voix 3D réaliste, des canaux radio personnalisés, et une qualité audio crystal clear. Plus de 80% des serveurs FiveM populaires l’utilisent déjà.

Suivez ce tutoriel étape par étape pour installer PMA Voice en moins de 15 minutes sur Pterodactyl et TXAdmin !

Qu’est-ce que PMA Voice et Pourquoi l’Installer ?

PMA Voice est un système de communication vocale avancé pour FiveM qui remplace le système de voix basique. Développé par la communauté, il offre :

Avantages de PMA Voice :

  • Audio 3D réaliste : La voix diminue avec la distance
  • Qualité HD : Compression audio optimisée
  • Canaux radio illimités : Parfait pour police, EMS, gangs
  • Chuchotement/Cri : Différents niveaux de voix
  • Compatible tous frameworks : ESX, QBCore, VRP, etc.
  • Performances optimisées : Consomme moins de ressources que les alternatives

Pourquoi choisir PMA Voice vs alternatives ?

FeaturePMA VoiceSaltyChatTokoVOIP
Gratuit✅❌❌
Installation simple✅❌❌
Support actif✅⚠️❌
Performances✅✅⚠️

Prérequis Avant Installation

Avant de commencer, vérifiez que vous avez :

Côté Serveur :

  • ✅ Serveur FiveM fonctionnel (OneSync activé recommandé)
  • ✅ Accès Pterodactyl Panel ou TXAdmin
  • ✅ Minimum 2 Go RAM libre
  • ✅ Droits administrateur sur votre hébergement

Côté Technique :

  • ✅ Connexion internet stable
  • ✅ Client FTP (FileZilla) ou accès fichiers web
  • ✅ Éditeur de texte (Notepad++, VS Code)

Versions Compatibles :

  • FiveM Server : Build 2545+ (recommandé : dernière version)
  • PMA Voice : Version 3.0+ (ce guide utilise la v3.2.1)

⚠️ Important : Sauvegardez votre serveur avant toute installation !

Étape 1 : Télécharger PMA Voice

Méthode Officielle (Recommandée) :

  1. Rendez-vous sur GitHub :
  2. Vérifiez le contenu : Le fichier ZIP doit contenir : pma-voice/ ├── client/ ├── server/ ├── config/ ├── fxmanifest.lua ├── README.md └── config.lua

Alternative : Clone Git

git clone https://github.com/AvarianKnight/pma-voice.git

⚠️ Attention aux faux sites : Téléchargez UNIQUEMENT depuis GitHub officiel !

Étape 2 : Upload sur Votre Serveur (Pterodactyl)

Via Pterodactyl Panel :

  1. Connectez-vous à votre Panel Pterodactyl
    • URL fournie par votre hébergeur (ex: panel.elypsecloud.com)
    • Identifiants reçus par email
  2. Accédez au File Manager :
    • Cliquez sur votre serveur FiveM
    • Onglet « Files » → « File Manager »
    • Naviguez vers le dossier resources/
  3. Créez le dossier PMA Voice :
    • Clic droit dans resources/ → « Create Folder »
    • Nommez-le exactement : pma-voice
  4. Upload des fichiers :
    • Sélectionnez le dossier pma-voice créé
    • Cliquez « Upload » → Glissez le contenu du ZIP
    • Attendez la fin de l’upload (barre verte = terminé)

Étape 3 : Configuration Basique

Modifier le config.lua :

  1. Ouvrez le fichier :
    • Dans File Manager : resources/pma-voice/config.lua
    • Double-clic pour éditer
  2. Configuration recommandée débutant : Config = {} -- Paramètres généraux Config.voiceTarget = 1 Config.microphoneAlwaysOn = false Config.enableSubmix = false Config.defaultVoiceRange = 8.0 Config.enableCameraTracking = false -- Niveaux de voix (distance en unités FiveM) Config.voiceModes = { {1.5, "Chuchoter"}, -- Mode 1 {8.0, "Normal"}, -- Mode 2 {15.0, "Crier"}, -- Mode 3 } -- Radio (optionnel pour début) Config.enableRadio = true Config.radioPressed = 244 -- Touche M par défaut Config.RadioTransmitRange = 1500.0
  3. Sauvegardez le fichier (Ctrl+S)

Étape 4 : Ajouter à server.cfg

Via TXAdmin (Méthode Simple) :

  1. Ouvrez TXAdmin dans votre navigateur
    • URL : http://votre-ip:40120 (ou fournie par hébergeur)
    • Connectez-vous avec vos identifiants
  2. Aller dans Settings :
    • Menu « Settings » → « FXServer »
    • Section « Server.cfg »
  3. Ajouter la ligne : Trouvez la section avec les autres ensure et ajoutez : ensure pma-voice
  4. Position importante : # Autres ressources de base ensure mapmanager ensure chat ensure spawnmanager ensure sessionmanager ensure hardcap ensure baseevents # PMA Voice - IMPORTANT : Après les ressources de base ensure pma-voice # Vos autres scripts après ensure esx_menu_default ensure es_extended

Via Pterodactyl Panel :

  1. File Manager → Racine du serveur
  2. Éditez server.cfg
  3. Ajoutez ensure pma-voice après les ressources de base
  4. Sauvegardez

⚠️ Ordre crucial : PMA Voice doit se charger APRÈS les ressources FiveM de base mais AVANT vos scripts RP !

Étape 5 : Test et Vérification

Démarrer le Serveur :

  1. Via TXAdmin :
    • Bouton « Start Server »
    • Surveillez les « Live Console » logs
  2. Via Pterodactyl :
    • Onglet « Console »
    • Bouton « Start »

Vérifier les Logs :

Logs SUCCESS à rechercher :

[  script:pma-voice] Resource pma-voice started successfully
[  script:pma-voice] PMA Voice version 3.2.1 initialized
[  script:pma-voice] Voice target set to 1

Logs ERROR à éviter :

❌ [ERROR] Failed to start resource pma-voice
❌ [WARNING] pma-voice manifest version mismatch  
❌ [ERROR] Unable to load config for pma-voice

Test In-Game :

  1. Connectez-vous à votre serveur
  2. Vérifiez l’interface : Un indicateur micro apparaît (coin d’écran)
  3. Test de proximité : Demandez à un ami de tester différentes distances
  4. Test radio : Appuyez sur M pour activer/désactiver

Configuration Avancée et Personnalisation

Touches Personnalisées :

Dans config.lua, personnalisez les contrôles :

Config.keys = {
    voiceRangeDown = 57, -- F10 pour diminuer portée voix
    voiceRangeUp = 344,  -- F11 pour augmenter portée voix  
    radioPressed = 244,   -- M pour radio
    radioEnabled = 243,   -- ~ pour activer/désactiver radio
}

Intégration Framework :

Pour ESX :

-- Dans votre script téléphone
exports['pma-voice']:setCallChannel(callId, callVolume)
exports['pma-voice']:setRadioChannel(radioChannel)

Pour QBCore :

-- Intégration automatique dans qb-radio
Config.RadioItem = 'radio' -- Item requis pour utiliser radio

Canaux Radio Personnalisés :

-- Canaux réservés pour factions
Config.PoliceFequency = 1 -- Police uniquement
Config.EMSFrequency = 2   -- Ambulance uniquement  
Config.RadioChannels = {
    [1] = "Police",
    [2] = "EMS", 
    [3] = "Taxi",
    [4] = "Mécano"
}

Dépannage : Problèmes Courants

❌ PMA Voice ne se lance pas

Symptômes : Aucun log PMA Voice dans la console Solutions :

  1. Vérifiez l’orthographe : ensure pma-voice (avec tiret)
  2. Vérifiez l’arborescence des fichiers
  3. Redémarrez complètement le serveur
  4. Vérifiez les permissions fichiers (chmod 755)

❌ Les joueurs ne s’entendent pas

Symptômes : Micro fonctionne mais aucun son reçu Solutions :

  1. Vérifiez OneSync activé : set onesync on
  2. Testez avec 2 joueurs minimum
  3. Vérifiez Config.voiceTarget = 1
  4. Redémarrez la ressource : restart pma-voice

❌ Audio de mauvaise qualité

Symptômes : Voix robotique, coupures, écho Solutions :

  1. Activez submix : Config.enableSubmix = true
  2. Vérifiez la bande passante serveur
  3. Réduisez defaultVoiceRange si surcharge
  4. Mise à jour vers dernière version PMA Voice

❌ Radio ne fonctionne pas

Symptômes : Touche M sans effet Solutions :

  1. Vérifiez Config.enableRadio = true
  2. Changez la touche : Config.radioPressed = 74 (H)
  3. Testez avec item radio si framework l’exige
  4. Vérifiez conflits avec autres scripts

❌ Crash serveur après installation

Symptômes : Serveur redémarre en boucle Solutions :

  1. Vérifiez version FiveM compatible (2545+)
  2. Supprimez temporairement : # ensure pma-voice
  3. Vérifiez logs détaillés pour conflits
  4. Testez sur serveur de test avant production

Questions Fréquemment Posées

PMA Voice est-il gratuit ? Oui, 100% gratuit et open-source. Méfiez-vous des sites qui le vendent !

Quelle différence avec SaltyChat ? PMA Voice est gratuit, plus simple à installer, et aussi performant. SaltyChat nécessite TeamSpeak et coûte cher.

Combien de joueurs peuvent utiliser PMA Voice ? Théoriquement illimité. Testé jusqu’à 1000+ joueurs simultanés sur de gros serveurs.

PMA Voice fonctionne-t-il avec tous les frameworks ? Oui : ESX, QBCore, VRP, vMenu, et frameworks custom. C’est framework-agnostic.

Peut-on personnaliser l’interface ? Oui, les fichiers HTML/CSS sont modifiables. Attention aux mises à jour qui écrasent vos changements.

PMA Voice consomme-t-il beaucoup de ressources ? Non, très optimisé. Consommation typique : 0.2-0.8ms selon le nombre de joueurs.

Comment ajouter plus de canaux radio ? Modifiez Config.maxRadioChannel = 100 dans config.lua. Chaque canal supporte théoriquement 999 joueurs.

PMA Voice fonctionne-t-il sur mobile ? Les clients mobiles (FiveM mobile mods) ont un support limité. Mieux vaut tester avant déploiement.

Conclusion : Votre Serveur FiveM Transformé

Félicitations ! Vous avez maintenant installé PMA Voice, le système de communication vocale le plus populaire de FiveM. Vos joueurs vont immédiatement remarquer la différence de qualité audio et d’immersion.

Récapitulatif Installation :

  1. ✅ Téléchargé PMA Voice depuis GitHub officiel
  2. ✅ Uploadé dans resources/pma-voice/
  3. ✅ Configuré config.lua selon vos besoins
  4. ✅ Ajouté ensure pma-voice dans server.cfg
  5. ✅ Testé en jeu avec succès

Prochaines Étapes Recommandées :

  • Intégrez avec votre système de téléphone/radio existant
  • Personnalisez les touches et interface selon votre communauté
  • Monitarez les performances régulièrement
  • Planifiez les mises à jour mensuelles

Ressource Utile :

PMA Voice va révolutionner l’expérience RP de votre serveur. Les joueurs vont rester plus longtemps, les interactions seront plus naturelles, et votre serveur va gagner en professionnalisme.

N’hésitez pas à expérimenter avec les paramètres avancés une fois que la base fonctionne parfaitement !

Besoin d’un Hébergement FiveM Professionnel ?

Éviter l’erreur n°15 commence par choisir le bon partenaire technique.
Elypsecloud propose des solutions d’hébergement FiveM spécialement optimisées pour éviter toutes ces erreurs :

🚀 VPS Gaming avec SSD NVMe et CPU haute fréquence
🛡️ Protection DDoS et monitoring 24/7 inclus
💾 Sauvegardes automatiques quotidiennes
🇫🇷 Support expert FiveM en français
⚡ Installation 1-clic avec TXAdmin pré-configuré

Offre spéciale lecteurs : -30% sur votre premier mois avec le code BLOG30

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *