Barber shop

1. 01

   Coloca el recurso

   Descarga el script desde tu cuenta Tebex, copia la carpeta avenida_barber/ en tu directorio de recursos y añade ensure avenida_barber a la config del servidor, después de ensure oxmysql.

2. 02

   Ejecuta el SQL

   Ejecuta la sección [A] de INSTALL.sql en tu base de datos. La sección [B] es condicional, la cabecera del archivo dice cuándo la necesitas.

3. 03

   Revisa la config

   Abre config/config.lua. Los valores por defecto funcionan en la mayoría de servidores, y la única línea que conviene mirar es Config.Locale. Los precios, las tiendas y el comportamiento de la silla están en el archivo de al lado, config/barber.lua.

4. 04

   Verifica las integraciones

   Pon Config.Debug = true, reinicia y lee la consola: una línea por categoría de bridge nombra el target elegido. Ponlo de nuevo en false cuando las líneas coincidan con tu servidor, porque los comandos de diagnóstico que desbloquea provocan un tirón.

5. 05

   Date permisos de admin

   Añade add_ace group.admin avenida_barber.admin allow a la config del servidor y luego lanza /avenida_barber_check en juego para el informe completo.

Forzar una integración en vez de detectarla

La detección automática cubre la mayoría de servidores, y sondea el export real en lugar del estado del recurso. En un stack a medida, fuerza el target y la detección se salta por completo.

-- 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 públicos agrupados por dominio. Cada fila muestra la firma de la llamada y qué hace, no cómo lo hace.

Client

• GetHairbase

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

  La hair base que lleva el ped ahora mismo, o nil cuando el corte no necesita ninguna. Léela antes de llamar a ClearPedDecorations y devuélvela después, así el pelo conserva su sombreado en vez de quedarse como un gorro plano.

• GetTattoos

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

  Todos los tatuajes que este recurso mantiene en el ped. La barbería comparte la única ranura de decoraciones con la tinta, así que un redibujado que se olvide de esta lista borra tatuajes que el jugador ha pagado.

• GetSkinData

  exports['avenida_barber']:GetSkinData() Copiar

  El personaje tal y como lo guarda la barbería en memoria, con el pelo, la barba, las cejas y sus colores. Útil para guardar el look antes de que un uniforme de trabajo tome el control.

• ApplySkin

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

  Aplica una apariencia completa a un ped. Pásale el ped que quieres vestir, que puede ser un clon de vista previa en vez del jugador, para que un espejo o un selector de personaje muestren la misma cara.

• ApplyClothing

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

  Aplica solo la parte de ropa y deja intactos la cara y el pelo. Pon temporary en true para un conjunto que no debe guardarse en la base de datos, como un uniforme de prisión o un disfraz.

Ejemplos para copiar y pegar en los casos más habituales. Los metes en tu recurso, ajustas los valores y a producción.

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

• ¿Qué frameworks soporta realmente?
  QBCore, ESX y vRP, más un modo standalone que no necesita framework alguno y una rama `custom` en `bridges/framework.lua` para cualquier otra cosa. La detección se hace al arrancar y sondea el export real. Qbox y ox_core no tienen rama dedicada: pasan por la vía standalone o custom, no por un target probado.
• ¿Qué me cuesta vRP?
• ¿Funciona con el stack ox?
• ¿Puedo usarlo junto a avenida_tattoo y avenida_clotheshops?
• Falta un peinado en la lista
• La cabeza no sigue mi cursor
• ¿Puedo añadir otro idioma?
• ¿Cuánto cuesta cuando no hay nadie en la tienda?