Player List 2.0.0

Requires RAGE Multiplayer 1.1.0 and above.

This resource adds a GTA Online like player list to your server.

 

Installing

Put playerlist into your server's client_packages directory, then add require('playerlist'); to client_packages/index.js.

 

Controls

Z = Toggle player list visibility.

PageUp = Move to the next page.

PageDown = Move to the previous page.

 

Customization

You have the ability to customize how a player is displayed in the list. Here's a list of shared variable keys used for customization:

PlayerListColor = This shared variable is used to specify which background color the player will have in the list. Uses an integer (HUD color ID), so go check the wiki.

PlayerListTag = This shared variable is used to give players a crew/clan tag next to their name in the list. Setting this value to more than 5 characters isn't recommended since the scaleform displays up to 5 characters. (deprecated in 2.0)

 

Crew Tag API (Serverside - v2.0 and above)

// Sets the crew tag of a player.
// "tag" being empty will reset player's crew tag.
// "tag" should not be more than 4 or 5 characters to prevent visual annoyances
player.setCrewTag(tag, {
    crewIsPrivate, // Boolean - makes the crew tag background a rectangle if true, indicates player owned clans
    crewIsRockstar, // Boolean - adds the Rockstar Games logo to the crew tag display if true
    playerCrewRank, // Number - player's rank in their crew, refer to crew ranks list below, ignored if crewIsPrivate is false
    crewTagColor // Array of numbers (red, green, blue) - the crew color
});

// Resets the crew tag of a player.
player.resetCrewTag();

// Crew ranks
Leader = 0 (100% crew color "strip" display)
Commissioner = 1 (80% crew color "strip" display)
Lieutenant = 2 (60% crew color "strip" display)
Representative = 3 (40% crew color "strip" display)
Muscle = 4 (20% crew color "strip" display)
Member = 5 (no crew color "strip" display)

 

Various crew tags:

 

Credits

TomGrobbe - mp_mm_card_freemode scaleform research

@rgnbgnhnd @Jer - Testing

 

Notes

• This script uses mp.gui.chat.show function to toggle chat visibility when a player opens/closes the player list. Meaning if you have a custom chat, this resource might fail to toggle chat visibility.

 

Source code is available on GitHub in case you don't want to download: https://github.com/root-cause/ragemp-playerlist