Barber shop

1. 01

   Resource ablegen

   Hol dir das Script aus deinem Tebex-Konto, kopier den Ordner avenida_barber/ in dein resources-Verzeichnis und füg ensure avenida_barber hinter ensure oxmysql in deine Serverconfig ein.

2. 02

   SQL ausführen

   Führ Abschnitt [A] von INSTALL.sql auf deiner Datenbank aus. Abschnitt [B] ist bedingt, der Dateikopf sagt, wann du ihn brauchst.

3. 03

   Config durchsehen

   Öffne config/config.lua. Die Defaults passen auf den meisten Servern, die einzige Zeile, die du wirklich prüfen solltest, ist Config.Locale. Preise, Salons und Stuhlverhalten liegen nebenan in config/barber.lua.

4. 04

   Integrationen prüfen

   Setz Config.Debug = true, starte neu und lies die Konsole: Eine Zeile pro Bridge-Kategorie nennt das gewählte Target. Setz es wieder auf false, sobald die Zeilen zu deinem Server passen. Die freigeschalteten Diagnosebefehle kosten einen Frame-Hitch.

5. 05

   Admin-Rechte geben

   Füg add_ace group.admin avenida_barber.admin allow in deine Serverconfig ein und ruf dann im Spiel /avenida_barber_check für den vollen Bericht auf.

Eine Integration erzwingen, statt sie zu erkennen

Die Auto-Erkennung deckt die meisten Server ab, und sie prüft den echten Export statt nur den Resource-Status. Auf einem eigenen Stack erzwingst du das Target, dann entfällt die Erkennung komplett.

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

Öffentliche Exports nach Bereich gruppiert. Jede Zeile zeigt die Signatur und was der Export macht, nicht wie er es macht.

Client

• GetHairbase

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

  Die Hairbase, die der Ped gerade trägt, oder nil, wenn der Haarschnitt keine braucht. Lies sie aus, bevor du ClearPedDecorations aufrufst, und trag sie danach wieder ein, sonst wird aus den Haaren eine flache Kappe.

• GetTattoos

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

  Alle Tattoo-Decorations, die diese Resource auf dem Ped hält. Der Barbershop teilt sich den einzigen Decoration-Slot mit dem Ink-Studio, und ein Redraw ohne diese Liste löscht Tattoos, für die der Spieler bezahlt hat.

• GetSkinData

  exports['avenida_barber']:GetSkinData() Kopieren

  Der Charakter genau so, wie der Barber ihn im Speicher hält, samt Haaren, Bart, Augenbrauen und deren Farben. Praktisch, um einen Look festzuhalten, bevor ein Job-Outfit übernimmt.

• ApplySkin

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

  Schreibt ein komplettes Aussehen auf einen Ped. Übergib den Ped, den du anziehen willst. Das darf auch ein Vorschau-Klon statt des Spielers sein, damit Spiegel oder Charakterauswahl dasselbe Gesicht zeigen.

• ApplyClothing

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

  Wendet nur die Kleidung an und lässt Gesicht und Haare unangetastet. Setz temporary auf true für ein Outfit, das nicht in die Datenbank soll, etwa Gefängniskleidung oder eine Verkleidung.

Praxisnahe Copy-Paste-Beispiele. In deine eigene Resource kopieren, Werte anpassen, fertig.

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

• Welche Frameworks werden wirklich unterstützt?
  QBCore, ESX und vRP, dazu ein Standalone-Modus, der gar kein Framework braucht, und ein `custom`-Zweig in `bridges/framework.lua` für alles andere. Die Erkennung läuft beim Start und prüft den echten Export. Qbox und ox_core haben keinen eigenen Zweig: Sie laufen über den Standalone- oder Custom-Pfad, nicht über ein getestetes Target.
• Was kostet mich vRP?
• Funktioniert es mit dem ox-Stack?
• Kann ich es neben avenida_tattoo und avenida_clotheshops laufen lassen?
• Eine Frisur fehlt in der Liste
• Der Kopf folgt meinem Cursor nicht
• Kann ich eine Sprache ergänzen?
• Was kostet es, wenn niemand im Shop ist?