💈SLEEK BARBER SHOPS

Here check the installation guide

Barber shop resource for FiveM — business management, NPC employees, minigame, duty system, and modern UI.

Features

• Auto-detection of ESX / QBCore and appearance manager

• 7 pre-configured locations (Davis, Rockford Hills, Vespucci, Mirror Park, Paleto Bay, Sandy Shores, Hawick)

• Business system with worker/owner ranks and revenue split

• NPC employees with passive income, salary, and happiness system

• Supply system — shops consume supplies per service

• Minigame — optional ox_lib skillCheck

• Duty system — clock in/out with auto-off-duty on distance

• Favorites — save and load looks

• Modern NUI with configurable colors, blur, particles, and sounds

• ox_target / qb-target or classic marker + keypress

• 8 services: hair, beard, eyebrows, eyes, makeup, lipstick, blush, chest hair

• 9 banking integrations (ESX, QB, neon-boss, OKOK, FD, TGG, WASABI, CODEM, JUSTBANKING)

• Discord webhooks, multi-language (EN/ES/FR), camera sync, invoice system, hat auto-removal, free hair coupon

Requirements

Dependency	Required
ox_lib	Yes
oxmysql or mysql-async	Yes
ESX or QBCore	Yes
A clothing resource (illenium-appearance, qb-clothing, or esx_skin)	Recommended
ox_target or qb-target	Optional

Installation

Step 1 — Place the resource

Copy forge-barber into your server's resources/ directory.

Step 2 — Database

Auto-creates tables on first start (Config.AutoMigrateDB = true). Tables: forge_business (shared with forge-tattoo) and barber_favorites.

For manual setup, import INSTALL_SQL.sql.

Step 3 — server.cfg

ensure ox_lib
ensure forge-barber

ox_lib must start before forge-barber.

Step 4 — Create jobs (if using business mode)

ESX:

INSERT INTO `jobs` (`name`, `label`) VALUES
('barber1', 'Barber Shop - Davis'),
('barber2', 'Barber Shop - Rockford Hills'),
('barber3', 'Barber Shop - Vespucci'),
('barber4', 'Barber Shop - Mirror Park'),
('barber5', 'Barber Shop - Paleto Bay'),
('barber6', 'Barber Shop - Sandy Shores'),
('barber7', 'Barber Shop - Hawick');

QBCore — add equivalent entries in qb-core/shared/jobs.lua.

Step 5 — Start your server

The resource auto-detects your framework and appearance manager. Edit config/config.lua and config/shops.lua to customize.

Configuration

File	Purpose
config/config.lua	Master config — economy, NPCs, supplies, minigame, UI, markers, camera
config/shops.lua	Shop locations, coordinates, business settings
config/translation.lua	UI and notification text (EN/ES/FR)
config/bridge_client.lua	Client framework bridge (usually no edits needed)
config/bridge_server.lua	Server framework bridge (usually no edits needed)

Auto-detection

What	How
Framework	es_extended running → ESX, qb-core running → QB
Appearance Manager	First started wins: illenium-appearance → qb-clothing → esx_skin

To override, set Config.AppearanceManager = 'esx_skin' directly in config.lua.

Shop Locations

Defined in config/shops.lua. Ships with 7 locations:

Key	Location	Default Job	Business
barber_davis	Davis	barber1	Yes
barber_rockford	Rockford Hills	barber2	No
barber_vespucci	Vespucci	barber3	No
barber_mirror	Mirror Park	barber4	No
barber_paleto	Paleto Bay	barber5	No
barber_sandy	Sandy Shores	barber6	No
barber_hawick	Hawick	barber7	No

Adding a new shop

Copy an existing entry in shops.lua, change coordinates and job name. Set isBusiness = false for a public self-service shop.

Business & Economy

Revenue split

Config.CompanySharePercent = 80   -- Goes to the shop balance
Config.WorkerSharePercent  = 20   -- Goes to the worker's pocket

Payment routing

Built-in balance (default):

Config.UseBuiltinBalance = true

External banking:

Config.UseBuiltinBalance = false
Config.SocietyMethod = 'ESX'   -- ESX, QB, FORGE, OKOK, FD, TGG, WASABI, CODEM, JUSTBANKING

Neon-Boss

Config.UseNeonBossMenu = true

Routes all money through neon-boss. Each shop's assignedJob must be registered in neon-boss.

NPC Employees

• Hire from Config.NPCPool (8 candidates with skill levels 1–4)

• Pool rotates every NPCRotationMinutes (120 min)

• Max MaxNPCEmployees (3) per shop

• Salary = level × NPCSalaryPerLevel every NPCSalaryIntervalMin minutes

Passive income

When EnableExtraSales = true:

Income = ExtraSaleBase × (Level ^ ExtraSaleLevelExp) × HappinessMod × TeamBonus

Happiness

Level	Modifier	Cause
3 Happy	×1.00	Supplies OK
2 Okay	×0.75	Normal
1 Unhappy	×0.35	Supplies below 50
0 Miserable	×0.00	Supplies below 10 — NPC may quit

Supply System

Shops consume SupplyPerService (2) units per service. Owners restock via the management panel at SupplyUnitPrice ($50) per unit. Max capacity: DefaultSupplyMax (100). Running out blocks all services.

Other Systems

System	Key Settings
Minigame	UseMiniGame, MinigameDifficulty — ox_lib skillCheck
Duty	DutyMaxDistance, DutyCheckInterval — auto-off-duty on distance
Interaction	TargetMode, TargetScript — ox_target/qb-target or markers
UI	Full color palette in Config.UIColors, blur, particles, volume
Camera	Zone presets in Config.CamAngles, FOV range
Webhooks	Discord sale notifications — URL in bridge_server.lua
Translations	Config.Locale — 'en', 'es', 'fr'

Skin Manager Compatibility

Most skin managers include a built-in barber shop. When forge-barber is running, the skin manager should disable its own barber blips/zones to avoid duplicates.

Does my skin manager need modification?

Skin Manager	Needs Modification?
esx_skin / skinchanger	No — works out of the box
illenium-appearance (ESX)	Yes
illenium-appearance (QB)	Yes
fivem-appearance (ESX)	Yes
qb-clothing (QB)	Yes
rcore_clothing	No — compatible natively

Pre-modified downloads

Don't want to modify it yourself? Use the version that already includes full forge compatibility:

155KB

ESX fivem appareance.zip

archive

Open

239KB

ESX ILLENIUM.zip

archive

Open

239KB

ILLENIUM QB.zip

archive

Open

26KB

qb clothing.zip

archive

Open

These versions auto-detect all three forge scripts (tattoo, barber, clothes). When a forge script is running, the skin manager disables its own overlapping shop and calls the appropriate export after every appearance load.

QB-Clothing users

If qb-clothing is your appearance manager, it needs this event handler in client/main.lua to persist barber changes across reconnects:

RegisterNetEvent('qb-clothing:setSkinData', function(type, index, texture)
    if not skinData then return end
    if skinData[type] then
        skinData[type].item    = index
        skinData[type].texture = texture
    end
    ApplySkinData()
end)

The pre-modified qb-clothing download already includes this.

Support

Join our Discord — installation help, bug reports, feature requests.

License

© CodeForge — All rights reserved.