Clothing store

1. 01

   Resource ablegen

   Hol dir das Script aus deinem Tebex-Konto, kopier den Ordner avenida_clotheshops/ in dein resources-Verzeichnis und füg ensure avenida_clotheshops 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

   Admin-Rechte vergeben

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

4. 04

   Den Katalog direkt im Spiel bepreisen

   Setz Config.DevMode.Enabled = true, geh in einen Laden und öffne den Editor. Leg Preise fest, blende aus, was du nicht verkaufst, und reservier für einen Job, was dorthin gehört. Alles landet in config/clothes_overrides.lua. Schalt DevMode danach wieder aus, jede Speicherung wird ohnehin serverseitig erneut geprüft.

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. Config.Debug steuert nur das Logging und ist nicht der Schalter für den Editor.

Eine Sektion auf drei Arten bepreisen

Jeder Laden deklariert seine Sektionen, und jede Sektion ihren Preismodus. Ein fester Satz für eine ganze Sektion, ein Multiplikator, der spätere Drawables teurer macht, oder eine Tabelle, wenn nur eine Handvoll Teile einen eigenen Preis verdienen.

-- 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 } },
        -- only these drawables are offered
        whitelist = { 12, 45, 51 },
    },
}

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

Client

• GetSkinData

  exports['avenida_clotheshops']:GetSkinData() Kopieren

  Das Outfit, das der Spieler trägt, Komponente für Komponente, samt Props. Genau das schreibt der Shop beim Kauf, es deckt sich also immer mit dem, was die Garderobe zeigt.

• ApplySkin

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

  Wendet ein komplettes Aussehen auf einen Ped an. Ein Outfit leert den Decoration-Slot, deshalb trägt dieser Aufruf danach die Arbeit von Barber und Tattoo wieder ein, statt blanke Haut zurückzulassen.

• ApplyClothing

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

  Wechselt die Kleidung und sonst nichts. Mit temporary auf true gilt das Outfit nur für die Session, genau so soll sich eine Uniform verhalten, die ein Job ausgibt.

Server

• GetBagStorage

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

  Die Kapazität, die ein Rucksack-Drawable mitbringt, Gewicht und Slots, oder nil, wenn das Drawable nichts fasst. Ruf den Export aus deiner Inventory-Resource auf, damit ein gekaufter Rucksack wirklich etwas fasst.

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

-- config/clothes_shops.lua
Config.Clothes.Shops[22] = {
    name       = 'Ponsonbys - Rockford Hills',
    payment    = 'bank',
    currency   = '$',
    tax        = 0.20,        -- +20% on the cart
    discount   = 0.00,
    outfitMode = true,
    blip = { sprite = 73, color = 4, scale = 0.7, coords = vec3(-708.2, -152.2, 37.4) },
    categories = {
        tops  = { enabled = true, price = { mode = 'fixed', base = 900 } },
        shoes = { enabled = true, price = { mode = 'fixed', base = 450 } },
    },
}

-- config/clothes_overrides.lua, or write it from the in-game editor
Overrides['tops'] = {
    [56] = { job = 'police', label = 'LSPD jacket' },
    [12] = { hidden = true },
    [31] = { restricted = true },   -- ACE permission
}

-- config/clothes.lua
Config.Clothes.RequireOwnership = false

-- how far from a store the server still accepts a purchase
Config.Clothes.PurchaseRange = 30.0

-- saved outfits per character, enforced server side
Config.Clothes.MaxOutfits = 30
Config.Clothes.MaxOutfitsRestricted = 50

local hairbase = exports['avenida_clotheshops']:GetHairbase()
local tattoos  = exports['avenida_clotheshops']:GetTattoos()

-- your own clothing 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

• Ein Spieler sagt, er habe Kleidung verloren, die ihm gehörte
  Prüf `Config.Clothes.RequireOwnership`. Das Register übernimmt beim ersten Mal, was ein Charakter ohnehin trägt, das Einschalten nimmt also niemandem seine Garderobe weg. Was es ablehnt, ist ein Schreibvorgang für ein Teil ohne Kauf dahinter, und genau das schickt ein manipulierter Client. Wenn eine deiner Resources Spieler in nie gekaufte Teile kleidet, registrier diese Käufe oder setz das Flag auf false.
• Der Katalog-Editor öffnet nicht
• Dieselbe Jacke taucht mehrfach auf
• Haare gehen durch einen Helm
• Brauchen die Outfit-Bilder etwas Zusätzliches?
• Welche Frameworks werden wirklich unterstützt?
• Kann ich es neben avenida_barber und avenida_tattoo laufen lassen?
• Was kostet es, wenn niemand einkauft?