esx_barbershop

esx_barbershop places barber shops on the map where players pay to change their hairstyle, beard, eyebrows, makeup, lipstick and ear accessories. It reuses the esx_skin menu in restricted mode and saves the result server-side, with an automatic refund if saving fails.

OverviewCopy Anchor Link

In-game flow:

1. The player walks into one of the 7 default shop markers and presses E.
2. The esx_skin menu opens, limited to the fields listed below.
3. After confirming with "Yes", the server checks distance and money, charges Config.Price and saves the skin.
4. "No", leaving the marker or a failed payment reloads the previous look.

Editable fields: hair_1, hair_2, hair_color_1, hair_color_2, beard_1 to beard_4, eyebrows_1 to eyebrows_4, makeup_1 to makeup_4, lipstick_1 to lipstick_4, ears_1, ears_2.

InstallationCopy Anchor Link

There is no SQL file. Make sure esx_skin (which exports SaveSkin) starts first:

ensure es_extended
ensure esx_lib
ensure skinchanger
ensure esx_skin
ensure esx_barbershop

ConfigurationCopy Anchor Link

All keys live in config.lua.

Default shop positions:

Config.Shops = {
	vector3(-814.3, -183.8, 36.6),
	vector3(136.8, -1708.4, 28.3),
	vector3(-1282.6, -1116.8, 6.0),
	vector3(1931.5, 3729.7, 31.8),
	vector3(1212.8, -472.9, 65.2),
	vector3(-32.9, -152.3, 56.1),
	vector3(-278.1, 6228.5, 30.7)
}

CallbacksCopy Anchor Link

Both callbacks are registered with xLib.callback.registerCompat, so they work with xLib.callback and ESX.TriggerServerCallback.

esx_barbershop:payCopy Anchor Link

xLib.callback('esx_barbershop:pay', false, function(paid, reason) end, skin)

Returns paid (boolean) and, on failure, a reason string. Reasons set by this resource: player_unavailable, rate_limited, not_near_shop, invalid_appearance:payload:expected_table, payment_pending, insufficient_funds, payment_failed, appearance_save_failed, appearance_save_error, appearance_save_rejected, resource_stopped. esx_skin can pass its own reasons through as well (for example appearance_scope_mismatch:sex).

The server:

• rate limits each player (2 requests, refilled 1 per 2 seconds),
• requires the player within Config.ShopDistance of a shop,
• locks the account with xPlayer.beginAccountOperation() and allows only one pending payment per identifier,
• calls exports.esx_skin:SaveSkin(source, skin, finish, 'barber') and refunds the price with reason Haircut Refund if the save does not succeed.

esx_barbershop:checkMoneyCopy Anchor Link

xLib.callback('esx_barbershop:checkMoney', false, function(canPay) end)

Returns true when the player is near a shop and has at least Config.Price cash.

Server eventsCopy Anchor Link

esx_barbershop:payCopy Anchor Link

TriggerServerEvent('esx_barbershop:pay', skin)

Legacy net event that runs the same logic as the callback without returning a result. The bundled client uses the callback.

Client eventsCopy Anchor Link

Local events fired by the marker zones:

Common issuesCopy Anchor Link

• Purchase failed notification, money returned. esx_skin rejected the save. Check the server console for [esx_barbershop] Appearance save failed and the reason; usually esx_skin is outdated and has no SaveSkin export.
• "Not enough money" although the bank is full. Only cash (money account) is used.
• Look resets after relog. The save failed or another skin script overwrote the skin. Make sure only one appearance resource writes to users.skin.

RelatedCopy Anchor Link

• esx_skin
• skinchanger
• esx_clotheshop
• esx_accessories

Frequently asked questions