pmms - FiveM/RedM synchronized media player

pmms (Poodle's MultiMedia System) allows players to play music/video from entities such as phonographs, radios or TVs.

Features

• NUI-based, using MediaElement.js to support HTML5 media, HLS, YouTube, and more.

• Synchronized between players.

• Multiple entities can play different things at the same time.

• Dynamic sound attenuation based on whether the player and entity are in the same interior room.

• Optional immersive filter can be applied to any audio.

• Play video on a TV screen or scaleform with DUI (FiveM), or on a screen displayed above the entity (RedM).

• Play audio inside or outside of vehicles.

• Permissions system and ability to lock entities so only certain players can control them.

• Configure default entities which are spawned and play music/video automatically.

• Audio visualizations via Wave.js.

Examples

Dependencies

• httpmanager

Installing

1. Install all dependencies.

2. Place the files from this repository in a new folder in your resources directory.

   Example: resources/[local]/pmms

   Note

   The name of the resource must be in all lowercase in order for it to function properly. This is due to how NUI callbacks work.

3. Add the following in server.cfg:

   exec @pmms/permissions.cfg
   start pmms
   

Permissions

The default permissions allow members of group.admin full access to pmms, while other players will only be able to perform basic interactions with media players and only be able to play preset songs (those defined in Config.presets in config.lua).

To allow all players to be able to play custom URLs, in permissions.cfg, uncomment or add the following line:

add_ace builtin.everyone pmms.customUrl allow

Even with this ace, URLs will be restricted to those allowed by Config.allowedUrls, which includes generally safe sites such as YouTube. To allow players to use URLs from other sites, you can either add the appropriate pattern to Config.allowedUrls, or uncomment or add the following line to remove the restriction entirely:

add_ace builtin.everyone pmms.anyUrl allow

Keep in mind that media played with pmms is loaded individually by all players, meaning each player will be accessing the URL from their own connection. Therefore, allowing any player to play a random URL can present some risk of exposing players' IP addresses to an attacker playing something from their own web server and logging the connections.

Commands

Exports

Server-side

startByNetworkId

handle = exports.pmms:startByNetworkId(netId, options)

Starts playing something on a networked media player entity, using its network ID.

Media player options

options is a table of options for the new media player.

startByCoords

handle = exports.pmms:startByCoords(x, y, z, options)

Starts playing something on a non-networked media player entity, using its coordinates on the world map.

For options, refer to Media player options.

startScaleform

handle = exports.pmms:startScaleform(scaleform, options)

Starts playing something on a standalone scaleform screen.

For options, refer to Media player options.

Scaleform options

scaleform is a table of options for the scaleform screen.

stop

exports.pmms:stop(handle)

Stops a media player and removes its handle.

pause

exports.pmms:pause(handle)

Pause or resume a media player.

lock

exports.pmms:lock(handle)

Locks an active media player so that only privileged users can interact with it.

unlock

exports.pmms:unlock(handle)

Unlocks an active media player so anyone can interact with it.

mute

exports.pmms:mute(handle)

Mutes an active media player.

unmute

exports.pmms:unmute(handle)

Unmutes an active media player.

Client-side

enableEntity

exports.pmms:enableEntity(entity)

Allows the player to use a particular entity if they do not have the pmms.anyEntity ace.

disableEntity

exports.pmms:disableEntity(entity)

Disables the use of this entity for a player without the pmms.anyEntity ace.

createMediaPlayer

entity = exports.pmms:createMediaPlayer(options)

Creates a new networked entity which the player can use as a media player.

createMediaPlayer options

deleteMediaPlayer

exports.pmms:deleteMediaPlayer(entity)

Deletes an entity created by createMediaPlayer.