Barber shop

1. 01

   Drop the resource

   Grab the script from your Tebex account, then copy the avenida_barber/ folder into your resources directory and add ensure avenida_barber to your server config, after ensure oxmysql.

2. 02

   Run the SQL

   Run section [A] of INSTALL.sql on your database. Section [B] is conditional, the file header says when you need it.

3. 03

   Check the config

   Open config/config.lua. The defaults work on most servers, the one line worth checking is Config.Locale. Prices, shops and chair behaviour live next door in config/barber.lua.

4. 04

   Verify the integrations

   Set Config.Debug = true, restart, and read the console: one line per bridge category names the target that was picked. Set it back to false once the lines match your server, the diagnostic commands it unlocks cost a frame hitch.

5. 05

   Grant yourself the admin features

   Add add_ace group.admin avenida_barber.admin allow to your server config, then run /avenida_barber_check in game for the full install report.

Force an integration instead of detecting it

Auto-detection covers most servers, and it probes the real export rather than the resource state. On a custom stack, force the target and detection is skipped entirely.

-- config/config.lua
Config.Locale    = 'en'
Config.UseOxLib  = true

Config.Framework = 'auto'   -- 'qbcore' | 'esx' | 'vrp' | 'standalone' | 'custom'
Config.Notif     = 'ox_lib' -- 'qbcore' | 'esx' | 'ox_lib' | 'okok' | 'vrp' | 'chat' | 'custom'
Config.Interact  = 'auto'   -- 'avenida' | 'ox_target' | 'qb-target' | 'standalone' | 'custom'
Config.Clothing  = 'auto'   -- 'qb' | 'illenium' | 'fivem-appearance' | 'esx_skin' | 'vrp' | 'table' | 'custom'

Config.Camera = {
    Sensitivity = 1.0,      -- rotation, zoom and height, clamped to 0.1 - 5.0
    InvertY     = false,
}

Public exports grouped by domain. Each row shows the call signature and what it does, not how it does it.

Client

• GetHairbase

  exports['avenida_barber']:GetHairbase() --> { c = collection, t = nameHash } | nil Copy

  The hair base decoration the ped wears right now, or nil when the haircut needs none. Read it before you call ClearPedDecorations, hand it back afterwards, and the hair keeps its shading instead of turning into a flat cap.

• GetTattoos

  exports['avenida_barber']:GetTattoos() --> { { c, t }, ... } Copy

  Every tattoo decoration this resource owns on the ped. The barber shares the single decoration slot with the ink, so a redraw that forgets this list wipes the tattoos a player paid for.

• GetSkinData

  exports['avenida_barber']:GetSkinData() Copy

  The character exactly as the barber holds it in memory, hair, beard, eyebrows and their colours included. Useful to snapshot a look before a job outfit takes over.

• ApplySkin

  exports['avenida_barber']:ApplySkin(data, ped) Copy

  Writes a full appearance onto a ped. Pass the ped you want to dress, which can be a preview clone rather than the player, so a mirror or a character select can show the same face.

• ApplyClothing

  exports['avenida_barber']:ApplyClothing(data, ped, temporary) Copy

  Applies the clothing part only, and leaves face and hair untouched. Set temporary to true for a costume that must not be written to the database, a prison outfit or a disguise.

Real-world copy-paste examples. Drop them into your own resource, tweak the values, ship.

-- config/config.lua
Config.Camera = {
    Sensitivity = 1.4,          -- faster drag
    InvertY     = true,
}

Config.UI = {
    Tutorial          = true,   -- first-run tour, replayable from the toolbar
    Sounds            = true,
    Blips             = true,

    Timecycle         = 'casino_brightroom',
    TimecycleStrength = 1.0,
    TimecycleFadeMs   = 400,    -- 0 makes it snap like a light switch

    DofStrength       = 0.1,    -- false drops the per-frame SetUseHiDof call
    DofPlanes         = { 0.4, 0.7, 2.2, 4.5 },
}

-- config/barber.lua
Config.Barber.ChairScene = false   -- menu opens on the spot

Config.Barber.Shops[9] = {
    BarberPedModel = 's_m_m_hairdress_01',
    Welcome        = vec3(-1282.60, -1116.60, 6.99),
    Blip           = { sprite = 71, color = 4, scale = 0.7 },
}

local hairbase = exports['avenida_barber']:GetHairbase()
local tattoos  = exports['avenida_barber']:GetTattoos()

ClearPedDecorations(PlayerPedId())
-- your own decoration work here

if hairbase then
    AddPedDecorationFromHashes(PlayerPedId(), hairbase.c, hairbase.t)
end
for _, dec in ipairs(tattoos) do
    AddPedDecorationFromHashes(PlayerPedId(), dec.c, dec.t)
end

AddEventHandler('avenida_barber:client:uiStateChanged', function(hidden)
    if hidden then
        exports['myhud']:hide()
    else
        exports['myhud']:show()
    end
end)

• Which frameworks does it actually support?
  QBCore, ESX and vRP, plus a standalone mode that needs no framework at all and a `custom` branch in `bridges/framework.lua` for anything else. Detection runs at startup and probes the real export. Qbox and ox_core have no dedicated branch: they run through the standalone or custom path, not through a tested target.
• What does vRP cost me?
• Does it work with the ox stack?
• Can I run it next to avenida_tattoo and avenida_clotheshops?
• A hairstyle is missing from the list
• The head does not follow my cursor
• Can I add another language?
• What does it cost when nobody is in a shop?