Jump to content
RAGE Multiplayer Community

Hair Overlays 1.0.0

   (2 reviews)

1 Screenshot

About This File

This resource adds hair overlays/hair tattoos/hair decals for freemode male and freemode female. Hair overlays are used in GTA Online for better looking hair.

 

Requirements

 

Installing

  • Put the files you downloaded in their respective places
  • Install mp.game.data if you haven't installed it yet
  • Add require('hair-overlay') to client_packages/index.js
  • All done

 

Clientside API

/**
 * Call after updating the local player's hair style on clientside.
 * Useful for barber shop preview and other customization related scripts.
 */
mp.players.local.applyHairOverlay();

 

Serverside API

/**
 * Call after updating a player's hair style on serverside.
 * Not using this function might cause visual desync until the player is restreamed in to other players.
 */
player.applyHairOverlay();

 

Example

Commands used during development:

// Clientside (https://rage.mp/files/file/296-better-clientside-commands/ - for addCommand clientside)
// /client_sethair 72 0 0
mp.events.addCommand("client_sethair", (hair, color, highlight) => {
    hair = Number(hair);
    color = Number(color);
    highlight = Number(highlight);

    mp.players.local.setComponentVariation(2, hair, 0, 2);
    mp.players.local.setHairColor(color, highlight);
    mp.players.local.applyHairOverlay();
});

// Serverside
// /sethair 72 0 0
mp.events.addCommand("sethair", (player, _, hair, color, highlight) => {
    hair = Number(hair);
    color = Number(color);
    highlight = Number(highlight);

    player.setClothes(2, hair, 0, 2);
    player.setHairColor(color, highlight);
    player.applyHairOverlay();
});

 

Notes

  • Streamed in freemode male/freemode female players will always receive a hair overlay, meaning no more 100% bald characters.
  • Local player won't have a hair overlay until applyHairOverlay function is used. (either locally or from serverside)
  • clearFacialDecorations function is used to remove the old hair overlay on clientside. Meaning if you have other scripts that use setFacialDecoration, applied facial decoration(s) will be removed after a hair overlay change.
  • Hair overlays are retrieved from the game, the problem with this approach is earlier hair styles (drawable 1 to 20? something like that) for both freemode male/freemode female lacks decal information which causes the resource to apply the fallback/default hair overlay. (fm_hair_fuzz)
  • Unless they have forced component information (check mp_m_freemode_01_gunrunning_hair_shop.meta for forced decal component example), third party hair styles will apply the fallback/default hair overlay. (fm_hair_fuzz)
  • Also on GitHub: https://github.com/root-cause/ragemp-hair-overlays

Edited by rootcause

  • Like 2
 Share


User Feedback

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest

Jer

   3 of 3 members found this review helpful 3 / 3 members

NICE HAIRS

Link to review
×
×
  • Create New...