PMMS troubleshooting and FAQ

Always start with F8 (client) and the server console, then reproduce the problem. Errors sent by the server also show as notifications when Config.showNotifications = true.

The panel does not open

• The player lacks the command.pmms ACE: the key binding runs that command.
• The player changed the key in Settings › Key Bindings › FiveM.
• Config.keybind.vehicleOnly = true and the player is on foot.
• Config.keybind.enabled = false: only the /pmms command remains.

The panel opens but nothing responds

The resource folder is not named exactly pmms in lowercase. Interface callbacks are addressed to that name.

“No media player nearby”

• No entity of a Config.models model within Config.maxDiscoveryDistance (30 m by default).
• The player lacks pmms.anyEntity and the entity was not allowed by enableEntity.
• With allowPlayingFromVehicles = false, vehicles no longer count.

The media is refused

Player stuck by “one media per player”

A player’s reservation is set as soon as the server accepts their request, before the media loads. It is released when that player stops (end, stop, vehicle entity removed) or when the player disconnects. According to the code, if the media fails to load, the player is never created and the reservation stays until the player disconnects. To check in game with an invalid URL; if it happens, the player must reconnect, or set Config.oneMediaPerPlayer to false.

Black screen or no video

• The DUI page does not answer: F8 shows “Failed to initialize DUI browser: Could not connect to …”. Check that https://pmms-dui.mrpoulpiii.fr (or your page) is reachable from a browser.
• The media is http:// and no http DUI page is configured (see Integrations).
• The model’s renderTarget is wrong.
• Video was not enabled on this player (video option).
• Some YouTube videos refuse embedded playback: try another video.

Unexpected radio effect on GTA V

The first line of config.lua computes Config.isRDR with … or not TerraingridActivate. On the server this client native does not exist, so the expression is true even on GTA V, and so is Config.enableFilterByDefault (which equals Config.isRDR). The server applies this value to players started without a filter option: exports and default media players. They then start with the radio effect.

Fix without touching protected files: set filter = false in the export options and in Config.defaultMediaPlayers. Playback started by a player (panel, /pmms_play) gets the value computed by their client, false on GTA V, and is not affected. This behaviour comes from the original resource; it is deduced from the code and remains to be confirmed in game.

No Discord log

• set pmms_webhook is placed before exec @pmms/permissions.cfg, which resets it to empty.
• ConfigServer.logsEnabled = false.
• The webhook was deleted or regenerated on Discord.

Data files

models.json and defaultMediaPlayers.json are empty in the archive and are read when the server starts. If the console shows a JSON decoding error at that time, write {} in models.json and [] in defaultMediaPlayers.json, then restart. The server must be able to write these files to save settings made in game.

FAQ

Do I need to restart the server after a change? No: restart pmms is enough for config.lua, locales.lua and integrations/. For ACEs, use /pmms_refresh_perms.

Bar ambience sounds stop when I start music. That is Config.autoDisableStaticEmitters: the staticEmitters.lua emitters are muted while a media is audible.

Q also makes me take cover. Q is GTA V’s cover key. Change the key in the FiveM settings, or Config.keybind.key for new players.

The -veh and -notveh flags change nothing. They produce a vehicle option the code does not read; set “vehicle” in the panel.

If the problem persists, open a ticket on the MrPoulpi Labs Discord with F8, the server console, your config.lua and permissions.cfg without the webhook.