Barber shop

1. 01

   Coloque o resource

   Baixe o script pela sua conta Tebex, copie a pasta avenida_barber/ para o seu diretório de resources e adicione ensure avenida_barber na config do servidor, depois de ensure oxmysql.

2. 02

   Rode o SQL

   Rode a seção [A] do INSTALL.sql no seu banco. A seção [B] é condicional, o cabeçalho do arquivo diz quando você precisa dela.

3. 03

   Confira a config

   Abra config/config.lua. Os padrões funcionam na maioria dos servidores, a única linha que vale olhar é Config.Locale. Preços, lojas e comportamento da cadeira ficam no arquivo do lado, config/barber.lua.

4. 04

   Verifique as integrações

   Coloque Config.Debug = true, reinicie e leia o console: uma linha por categoria de bridge nomeia o alvo escolhido. Volte para false quando as linhas baterem com o seu servidor, os comandos de diagnóstico que ele libera custam um engasgo no frame.

5. 05

   Libere os poderes de admin para você

   Adicione add_ace group.admin avenida_barber.admin allow na config do servidor e depois rode /avenida_barber_check no jogo para o relatório completo.

Forçar uma integração em vez de detectar

A detecção automática cobre a maioria dos servidores, e ela testa o export real em vez do estado do resource. Numa stack customizada, force o alvo e a detecção é pulada 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 domínio. Cada linha mostra a assinatura da chamada e o que ela faz, não como faz.

Client

• GetHairbase

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

  A hairbase que o ped usa neste momento, ou nil quando o corte não precisa de nenhuma. Leia ela antes de chamar ClearPedDecorations e devolva depois: assim o cabelo mantém o sombreado em vez de virar um capacete liso.

• GetTattoos

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

  Todas as tatuagens que este resource mantém no ped. A barbearia compartilha o único slot de decoração com a tinta, então um redraw que esquece essa lista apaga tatuagens que o jogador pagou.

• GetSkinData

  exports['avenida_barber']:GetSkinData() Copiar

  O personagem do jeito que a barbearia guarda ele na memória, com cabelo, barba, sobrancelhas e as cores de cada um. Útil para guardar o visual antes de um uniforme de trabalho tomar o lugar dele.

• ApplySkin

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

  Escreve uma aparência completa num ped. Passe o ped que você quer vestir, que pode ser um clone de preview em vez do jogador, para um espelho ou uma tela de seleção de personagem mostrar o mesmo rosto.

• ApplyClothing

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

  Aplica só a parte de roupas e deixa o rosto e o cabelo intactos. Coloque temporary como true para uma roupa que não deve ir para o banco, tipo um uniforme de presidiário ou um disfarce.

Exemplos de copiar e colar para os casos mais comuns. Você cola na sua resource, ajusta os valores e já está em produção.

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

• Quais frameworks ele realmente suporta?
  QBCore, ESX e vRP, mais um modo standalone que não precisa de framework nenhum e um caminho `custom` em `bridges/framework.lua` para qualquer outro caso. A detecção roda no start e testa o export real. Qbox e ox_core não têm caminho dedicado: eles passam pelo caminho standalone ou custom, não por um alvo testado.
• O que o vRP me custa?
• Funciona com a stack ox?
• Posso rodar junto com avenida_tattoo e avenida_clotheshops?
• Falta um corte de cabelo na lista
• A cabeça não segue o meu cursor
• Posso adicionar outro idioma?
• Quanto custa quando não tem ninguém na loja?