Dépannage et FAQ PMMS
Diagnostiquer PMMS — panneau fermé, boutons inactifs, écran noir, média refusé, joueur bloqué par « un média par joueur », filtre inattendu, logs absents, fichiers de données.
Commencez toujours par F8 (client) et la console serveur, puis reproduisez le problème. Les erreurs envoyées par le serveur s’affichent aussi en notification quand Config.showNotifications = true.
Le panneau ne s’ouvre pas
- Le joueur n’a pas l’ACE
command.pmms: le raccourci exécute cette commande. - La touche a été changée par le joueur dans Paramètres › Raccourcis clavier › FiveM.
Config.keybind.vehicleOnly = trueet le joueur est à pied.Config.keybind.enabled = false: seule la commande/pmmsreste.
Le panneau s’ouvre mais rien ne répond
Le dossier de la ressource n’est pas nommé exactement pmms en minuscules. Les rappels de l’interface sont adressés à ce nom.
« No media player nearby »
- Aucune entité d’un modèle de
Config.modelsà moins deConfig.maxDiscoveryDistance(30 m par défaut). - Le joueur n’a pas
pmms.anyEntityet l’entité n’a pas été autorisée parenableEntity. - Avec
allowPlayingFromVehicles = false, les véhicules ne comptent plus.
Le média est refusé
| Message | Cause |
|---|---|
| You must select from one of the pre-defined songs | Pas de pmms.customUrl et l’argument n’est pas un preset. |
| You do not have permission to play the specified URL | URL hors de Config.allowedUrls et pas de pmms.anyUrl. |
| You do not have permission to play a song on a locked media player | Lecteur par défaut verrouillé, pas de pmms.manage. |
| This player is busy | Le lecteur est réservé à un autre joueur qui passe à la suite de la file. |
| Vous avez déjà un média en cours… | Config.oneMediaPerPlayer, voir ci-dessous. |
Joueur bloqué par « un média par joueur »
La réservation d’un joueur est posée dès que le serveur accepte sa demande, avant le chargement du média. Elle est levée quand ce lecteur s’arrête (fin, arrêt, entité véhicule supprimée) ou quand le joueur se déconnecte. D’après le code, si le média échoue au chargement, le lecteur n’est jamais créé et la réservation reste jusqu’à la déconnexion du joueur. À vérifier en jeu avec une URL invalide ; si le cas se produit, le joueur doit se reconnecter, ou passez Config.oneMediaPerPlayer à false.
Écran noir ou vidéo absente
- La page DUI ne répond pas : F8 affiche « Failed to initialize DUI browser: Could not connect to … ». Vérifiez que
https://pmms-dui.mrpoulpiii.fr(ou votre page) est joignable depuis un navigateur. - Le média est en
http://et aucune page DUIhttpn’est configurée (voir Intégrations). - Le
renderTargetdu modèle est incorrect. - La vidéo n’a pas été activée sur ce lecteur (option
video). - Certaines vidéos YouTube refusent la lecture intégrée : testez une autre vidéo.
Effet radio inattendu sur GTA V
La première ligne de config.lua calcule Config.isRDR avec … or not TerraingridActivate. Sur le serveur, cette native client n’existe pas, donc l’expression vaut true même sur GTA V, et Config.enableFilterByDefault (qui vaut Config.isRDR) aussi. Le serveur applique cette valeur aux lecteurs démarrés sans option filter : exports et lecteurs par défaut. Ils démarrent alors avec l’effet radio.
Solution sans toucher aux fichiers protégés : précisez filter = false dans les options des exports et dans Config.defaultMediaPlayers. Les lectures lancées par un joueur (panneau, /pmms_play) reçoivent la valeur calculée par son client, false sur GTA V, et ne sont pas concernées. Ce comportement vient de la ressource d’origine ; il est déduit du code et reste à confirmer en jeu.
Aucun log Discord
set pmms_webhookest placé avantexec @pmms/permissions.cfg, qui le remet à vide.ConfigServer.logsEnabled = false.- Le webhook a été supprimé ou régénéré côté Discord.
Fichiers de données
models.json et defaultMediaPlayers.json sont vides dans l’archive et sont lus au démarrage du serveur. Si la console affiche une erreur de décodage JSON à ce moment, écrivez {} dans models.json et [] dans defaultMediaPlayers.json, puis redémarrez. Le serveur doit pouvoir écrire dans ces fichiers pour enregistrer les réglages faits en jeu.
FAQ
Faut-il redémarrer le serveur après une modification ?
Non : restart pmms suffit pour config.lua, locales.lua et integrations/. Pour les ACE, utilisez /pmms_refresh_perms.
Les sons d’ambiance du bar s’arrêtent quand je lance une musique.
C’est Config.autoDisableStaticEmitters : les émetteurs de staticEmitters.lua sont coupés tant qu’un média est audible.
Q me met aussi à couvert.
Q est la touche de couverture de GTA V. Changez la touche dans les paramètres FiveM, ou Config.keybind.key pour les nouveaux joueurs.
Les options -veh et -notveh ne changent rien.
Elles produisent une option vehicle que le code ne lit pas ; réglez « véhicule » dans le panneau.
Si le problème persiste, ouvrez un ticket sur le Discord MrPoulpi Labs avec F8, la console serveur, vos config.lua et permissions.cfg sans le webhook.