Installation — PMMS | MrPoulpi Labs

Installer PMMS MrPoulpi Labs — dossiers pmms et httpmanager, lignes server.cfg, permissions, webhook Discord, fichiers de données et premier essai à deux joueurs.

But : faire fonctionner PMMS sur votre serveur et vérifier la lecture synchronisée. Fichiers concernés : le dossier [pmms] de l’archive et votre server.cfg.

Prérequis

Élément	Exigence observée dans l’archive
httpmanager	Obligatoire (`dependency "httpmanager"`), livré dans l’archive. `pmms/server.lua` appelle son export `createHttpHandler` au démarrage.
Jeu	GTA V (FiveM) ou RedM : le manifeste déclare `gta5` et `rdr3`.
Framework	Aucun : les droits passent par les ACE de FiveM.
Chat	Facultatif : `/pmms_presets` et les suggestions de commandes utilisent les événements du chat par défaut.

Étapes

Copiez le dossier [pmms] dans resources. Gardez les noms pmms et httpmanager en minuscules : les rappels NUI de pmms dépendent du nom exact de la ressource.
Ajoutez à server.cfg :
```
exec @pmms/permissions.cfg
set pmms_webhook ""
ensure httpmanager
ensure pmms
```
permissions.cfg se termine lui-même par set pmms_webhook "" : votre ligne set doit donc venir après le exec pour être prise en compte.
Relisez les permissions. Le permissions.cfg livré autorise tous les joueurs à jouer n’importe quelle URL (pmms.customUrl et pmms.anyUrl). Pour restreindre, voir Permissions et URL.
Logs Discord (facultatif) : remplacez la valeur vide par votre webhook :
```
set pmms_webhook "https://discord.com/api/webhooks/…"
```
Utilisez set, jamais setr, et ne placez pas le webhook dans config.lua : ce fichier est envoyé aux clients.
Fichiers de données : models.json et defaultMediaPlayers.json reçoivent les réglages enregistrés en jeu. Ils sont vides dans l’archive. Le serveur doit pouvoir écrire dans le dossier de la ressource.
Démarrez le serveur, ou refresh puis ensure httpmanager et ensure pmms dans la console.

Premier essai

Console serveur et F8 : aucune erreur rouge au démarrage de httpmanager et pmms.
Approchez-vous d’une radio, d’une enceinte (prop_boombox_01 par exemple) ou montez dans un véhicule, puis appuyez sur Q (ou tapez /pmms) : le panneau s’ouvre et liste le lecteur proche.
Collez une URL YouTube et lancez la lecture : le son part de l’entité et baisse quand vous vous éloignez.
Avec un second joueur à côté : il entend le même média, au même moment.
Devant une télévision du jeu (prop_tv_flat_01), activez la vidéo : l’image s’affiche sur l’écran.
Si le webhook est défini : un message « Lien PMMS lancé » arrive sur Discord.

Résultat attendu : lecture synchronisée, son spatialisé, vidéo sur l’écran, log reçu.

Erreurs fréquentes

Dossier renommé en PMMS ou [PMMS]/Pmms : le panneau s’ouvre mais les boutons ne répondent pas. Renommez en minuscules.
httpmanager absent ou arrêté : pmms ne démarre pas ou affiche une erreur sur exports.httpmanager.
Webhook déclaré avant exec @pmms/permissions.cfg : la ligne set pmms_webhook "" du fichier l’écrase, aucun log n’arrive.
Q ne fait rien : le joueur a déjà associé une autre touche dans Paramètres › Raccourcis clavier › FiveM, ou Config.keybind.vehicleOnly = true et il est à pied.
Vidéo noire sur l’écran : la page DUI https://pmms-dui.mrpoulpiii.fr est injoignable depuis le client, ou l’URL du média est en http:// (voir Intégrations).

Mise à jour

Avant de remplacer la ressource, sauvegardez config.lua, config.server.lua, locales.lua, integrations/, permissions.cfg, et surtout models.json et defaultMediaPlayers.json, qui contiennent ce que vos administrateurs ont enregistré en jeu. Reportez vos réglages dans les nouveaux fichiers plutôt que de recopier les anciens par-dessus.