✂️ NPC Hairs & Beards

Documentation relating to the jo_hairdresser_npc add-on for the Hairdresser script.

Buy the add-on

1. Installation

WARNING

The Hairdresser script is required to use this add-on.

To install jo_hairdresser_npc:

• Drag and drop the resource into your resources folder
  • jo_hairdresser_npc
• Add this ensure to your server.cfg after ensure jo_hairdresser
  • ensure jo_hairdresser_npc

Congratulations, the NPC Hairs & Beards add-on is ready to use!

2. Usage

Go to a hairdresser and open the hairdresser menu.

When the add-on is enabled, compatible hairdresser entries open an intermediate source menu where players can choose between:

• Natives - Browse the normal Hairdresser styles
• NPC - Browse NPC styles added by the add-on

This intermediate Natives / NPC choice appears for:

• Hair - Choose between native hair styles and NPC hair styles
• Beard - Choose between native beard styles and NPC beard styles

Female characters can also receive a dedicated Beard entry when female NPC beard data is available.

In the NPC menus, you can:

• Browse NPC hair - Preview and buy NPC hair components
• Browse NPC beards - Preview and buy NPC beard components
• Remove a component - Select the shaved option to remove the current NPC category
• Change color presets - Use the color slider on compatible NPC entries
• Switch payment options - Choose between available prices when multiple options exist

Changes are previewed on the player before purchase.

The add-on includes 668 NPC style choices:

Sex	Category	Choices
Male	Hair	339
Male	Full beard	65
Male	Mustache	39
Male	Mutton chops	24
Male	Chin beard	22
Male total		489
Female	Hair	166
Female	Hair bonnet	9
Female	Beards	4
Female total		179

Available categories depend on the character sex and the enabled prices in the configuration.

If Hair & Beard Coloring is installed and started, compatible NPC components can use the external color palette.

The NPC add-on keeps the purchase flow delegated to the main Hairdresser script, so pricing, payment, persistence, and success feedback stay shared with the normal hairdresser menus.

3. Configuration

The configuration file is config.lua in the resource root. Do not edit this file directly as your changes may be lost during updates. Instead, use overwriteConfig.lua to store your customizations.

• config.lua - Default configuration maintained by developers. Do not modify this file.
• overwriteConfig.lua - This is where you place only the values you want to override.

How to customize the configuration

1. Open /overwriteConfig.lua
2. Find the value you want to change in config.lua (e.g., Config.language )
3. Copy only that line into overwriteConfig.lua
4. Edit the copied value to your liking

The script loads config.lua first, then overwriteConfig.lua overwrites only the values you redefine. This ensures your customizations are preserved when updating the script.

Loading configuration...