Barber shop

1. 01

   Déposez la ressource

   Récupérez le script depuis votre compte Tebex, copiez le dossier avenida_barber/ dans votre dossier resources et ajoutez ensure avenida_barber à votre config serveur, après ensure oxmysql.

2. 02

   Passez le SQL

   Exécutez la section [A] d'INSTALL.sql sur votre base. La section [B] est conditionnelle, l'en-tête du fichier dit quand elle s'applique.

3. 03

   Vérifiez la config

   Ouvrez config/config.lua. Les valeurs par défaut conviennent à la plupart des serveurs, la seule ligne à regarder est Config.Locale. Les prix, les boutiques et le comportement du fauteuil vivent à côté, dans config/barber.lua.

4. 04

   Contrôlez les intégrations

   Mettez Config.Debug = true, redémarrez, et lisez la console : une ligne par catégorie de bridge nomme la cible retenue. Repassez à false une fois que les lignes correspondent à votre serveur, les commandes de diagnostic qu'il débloque coûtent un à-coup.

5. 05

   Donnez-vous les droits admin

   Ajoutez add_ace group.admin avenida_barber.admin allow à votre config serveur, puis lancez /avenida_barber_check en jeu pour le rapport complet.

Forcer une intégration au lieu de la détecter

La détection automatique couvre la plupart des serveurs, et elle sonde l'export réel plutôt que l'état de la ressource. Sur une stack maison, forcez la cible et la détection est entièrement court-circuitée.

-- 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,
}

Exports publics groupés par domaine. Chaque ligne montre la signature d'appel

Client

• GetHairbase

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

  La décoration de racine de cheveux portée à l'instant, ou nil quand la coupe n'en demande aucune. Lisez-la avant d'appeler ClearPedDecorations et rendez-la ensuite : les cheveux gardent leur ombrage au lieu de devenir un casque uni.

• GetTattoos

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

  Tous les tatouages que cette ressource possède sur le ped. Le barbier partage l'unique emplacement de décoration avec l'encre : un redraw qui oublie cette liste efface des tatouages payés par le joueur.

• GetSkinData

  exports['avenida_barber']:GetSkinData() Copier

  Le personnage tel que le barbier le tient en mémoire, cheveux, barbe, sourcils et leurs couleurs compris. Pratique pour photographier un look avant qu'une tenue de métier prenne la main.

• ApplySkin

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

  Écrit une apparence complète sur un ped. Passez le ped à habiller, qui peut être un clone de prévisualisation plutôt que le joueur : un miroir ou une sélection de personnage montrent ainsi le même visage.

• ApplyClothing

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

  Applique la moitié vêtements seulement, et laisse le visage et les cheveux intacts. Mettez temporary à true pour un costume qui ne doit pas partir en base : une tenue de prison, un déguisement.

Exemples copier-coller pour les cas courants. À déposer dans ta ressource, ajuster les valeurs, et c'est en prod.

-- 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)

• Quels frameworks sont réellement supportés ?
  QBCore, ESX et vRP, plus un mode standalone qui ne demande aucun framework et une branche `custom` dans `bridges/framework.lua` pour le reste. La détection tourne au démarrage et sonde l'export réel. Qbox et ox_core n'ont pas de branche dédiée : ils passent par le chemin standalone ou custom, pas par une cible testée.
• Qu'est-ce que vRP me coûte ?
• Est-ce que ça marche avec la stack ox ?
• Puis-je le faire tourner à côté de avenida_tattoo et avenida_clotheshops ?
• Une coiffure manque dans la liste
• La tête ne suit pas mon curseur
• Puis-je ajouter une langue ?
• Combien ça coûte quand personne n'est en boutique ?