Gamer Tags

Gamer tags are the overhead displays shown above player characters. They consist of multiple components that can be individually toggled. Use CreateMpGamerTagWithCrewColor and related natives to manage them. Store the created tag handle, update only the components your interface needs, and remove the tag when its player or ped is no longer relevant.

Quick Usage

-- Create a gamer tag for a ped
local tag = CreateMpGamerTagWithCrewColor(ped, "PlayerName", false, false, "", 0, 0, 0, 0)
 
-- Show components
SetMpGamerTagVisibility(tag, 0, true)  -- Show name
SetMpGamerTagVisibility(tag, 2, true)  -- Show health/armour bar
 
-- Set tag colour
SetMpGamerTagColour(tag, 0, 116)  -- Set name colour
 
-- Remove when done
RemoveMpGamerTag(tag)

All Gamer Tag Components