Core Skin (3 in 1)

1. 01

   Resource ablegen

   Hol dir das Script aus deinem Tebex-Konto, kopier den Ordner in dein resources-Verzeichnis und trag ensure avenida_core_skin hinter ensure oxmysql in deine Serverconfig ein. Behalte den Ordnernamen so, wie er ausgeliefert wird, genau so deklariert ihn das Manifest.

2. 02

   SQL ausführen, Abschnitt [A] komplett

   Abschnitt [A] enthält jede Tabelle, die die Resource besitzt, inklusive des Registers bezahlter Kleidung. Die Abschnitte [B], [C] und [D] sind bedingt, die Datei sagt dir, wann welcher gilt. [D] sind die Inventar-Items, nur nötig, wenn du Config.Clothes.GiveAsItems einschaltest, und genau den vergisst man.

3. 03

   Module wählen

   Öffne config/config.lua und setz Config.Modules. Ein Modul auf false kostet gar nichts: kein Blip, kein Interaktionspunkt, kein Thread, und seine Config wird nie gelesen. Prüf bei der Gelegenheit gleich Config.Locale.

4. 04

   Admin-Rechte vergeben

   Füg add_ace group.admin avenida_skin.admin allow und add_ace group.admin avenida_skin.vip allow ein. Das erste öffnet den Katalog-Editor im Spiel, das zweite schaltet frei, was du hinter die VIP-Liste legst.

5. 05

   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, und denk daran, dass es nur das Logging steuert, der Editor hat seinen eigenen Schalter.

Nur die Shops laufen lassen, die du brauchst

Die drei Module sind unabhängig voneinander. Wer schon einen Kleidungsladen hat, mit dem er zufrieden ist, behält Barbershop und Tattoo-Studio, und vom abgeschalteten Modul läuft nichts.

-- config/config.lua
Config.Modules = {
    Barber  = true,
    Tattoo  = true,
    Clothes = false,   -- no blip, no point, no thread
}

Config.Locale = 'en'

Config.Framework = 'auto'   -- 'qbcore' | 'esx' | 'vrp' | 'standalone' | 'custom'
Config.Notif     = 'auto'
Config.Interact  = 'auto'
Config.Clothing  = 'auto'

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

Client

• GetHairbase

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

  Die Hairbase, die der Ped gerade trägt. Das Bundle betreibt die drei Shops auf einem einzigen Decoration-Slot, das ist also die einzige Stelle zum Auslesen, egal, welchen Shop der Spieler zuletzt besucht hat.

• GetTattoos

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

  Die Tattoos, die der Ped gerade trägt. Da Barber, Ink und Garderobe sich hier eine Registry teilen, bekommst du eine Liste, statt drei Resources nach derselben Antwort zu fragen.

Server

• GetBagStorage

  exports['avenida_skin']:GetBagStorage(sex, drawable) --> { weight, slots } | nil Kopieren

  Was ein Rucksack-Drawable an Gewicht und Slots wert ist, gelesen aus der Garderoben-Config. Für ein Drawable, das nicht als Tasche deklariert ist, kommt nil zurück.

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

-- config/clothes_shops.lua
categories = {
    tops = {
        enabled = true,
        price   = { mode = 'fixed', base = 300 },
    },
    pants = {
        enabled = true,
        -- price = base + index * mult
        price   = { mode = 'multiplier', base = 100, mult = 2 },
    },
    mask = {
        enabled = true,
        price   = { mode = 'table', map = { [12] = 900, [45] = 1500 } },
    },
}

-- config/tattoo.lua
Config.Tattoo.Prices = {
    flat  = 1000,
    reset = 3000,   -- laser removal, per tattoo removed
}

Config.Tattoo.CollectionMultipliers = {
    multiplayer_overlays = 0.80,   -- base game, cheaper
    mpHipster_overlays   = 0.85,
    -- anything not listed stays at 1.0
}

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

Config.UI = {
    Tutorial          = true,
    Timecycle         = 'casino_brightroom',
    TimecycleFadeMs   = 400,
    DofStrength       = 0.1,
}

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

• Bundle oder die drei einzelnen Resources?
  Das Bundle, wenn du alle drei willst: Es kostet weniger und ist eine Sache zum Installieren und Aktualisieren. Die einzelnen Resources, wenn du nur eine oder zwei brauchst, oder wenn du schon einen Kleidungsladen hast, mit dem du zufrieden bist. Was du nie tun darfst: beide gleichzeitig laufen lassen. Sie würden je einen eigenen Blip setzen und je eine eigene Kopie desselben Charakters schreiben. Die Resource erkennt die Überschneidung und meldet das beim Start in der Konsole.
• Ich will nur Barbershop und Tattoo-Studio
• Behält das Bundle das bestehende Aussehen meiner Spieler?
• Welche Frameworks werden wirklich unterstützt?
• Funktioniert es mit dem ox-Stack?
• Was kostet mich vRP?
• Ein Spieler sagt, er habe Kleidung verloren, die ihm gehörte
• Was kostet es, wenn niemand im Shop ist?