Skip to main content

Player::setHeadOverlay

OverlayID ranges from 0 to 12, index from 0 to _GET_NUM_OVERLAY_VALUES(overlayID)-1, and opacity from 0.0 to 1.0.
First and second color you can take in the list of hair colors.
List of colors: https://wiki.rage.mp/wiki/Makeup_Colors

OverlayIDPartIndex
0Blemishes0-23
1Facial Hair0-28
2Eyebrows0-33
3Ageing0-14
4Makeup0-74
5Blush0-32
6Complexion0-11
7Sun Damage0-10
8Lipstick0-9
9Moles/Freckles0-17
10Chest Hair0-16
11Body Blemishes0-11
12Add Body Blemishes0-1

To disable any overlay use 255 as index.

Syntax​

Client-Side

player.setHeadOverlay(overlayID, index, opacity, firstColor, secondColor);

// The variation of this function for peds (mp.peds) does not take values to set the overlay color. It uses the syntax used in the native.
ped.setHeadOverlay(overlayID, index, opacity);

Server-Side

player.setHeadOverlay(overlayID, [index, opacity, firstColor, secondColor]);

Required Arguments​

  • overlayID: int
  • index: int
  • opacity: float
  • firstColor: int
  • secondColor: int

Return value​

  • Undefined

Example​

C# Serverside Example

private static readonly string[] headOverlayNames = { "blemishes", "facialHair", "eyebrows", "ageing", "makeup", "blush", "complexion", "sunDamage", "lipstick", "molesFreckles", "chestHair", "bodyBlemishes", "addBodyBlemishes" };

private static HeadOverlay CreateHeadOverlay(Byte index, Byte color, Byte secondaryColor, float opacity)
{
return new HeadOverlay
{
Index = index,
Color = color,
SecondaryColor = secondaryColor,
Opacity = opacity
};
}

[Command("beard")]
public void Beard(Client c, byte Index, byte Color, byte SeconardyColor, byte Opacity)
{
Dictionary<int, HeadOverlay> headOverlays = new Dictionary<int, HeadOverlay>();
headOverlays.Add(1, CreateHeadOverlay((byte)Index, (byte)Color, (byte)SeconardyColor, (byte)Opacity));
c.SetHeadOverlay(1, headOverlays[1]);
}

Testexamples use Command:
beard 1 0 0 1 = Set beard 1 with PrimaryColor 0 SecondardyColor 0 and opacity 1 (use opacity 0 for invisible, 1 for full visible)
beard 2 22 0 1 = Set beard 1 with PrimaryColor 22(red) SecondardyColor 0 and opacity 1 (use opacity 0 for invisible, 1 for full visible)
Restriction: Command can just handle 0, 1 on opacity but it is a byte and can have a value from 0.0 - 1.0