Clothing store

1. 01

   Drop the resource

   Grab the script from your Tebex account, then copy the avenida_clotheshops/ folder into your resources directory and add ensure avenida_clotheshops to your server config, after ensure oxmysql.

2. 02

   Run the SQL

   Run section [A] of INSTALL.sql on your database. Section [B] is conditional, the file header says when you need it.

3. 03

   Grant the admin permissions

   Add add_ace group.admin avenida_clotheshops.admin allow and add_ace group.admin avenida_clotheshops.vip allow to your server config. The first one opens the catalogue editor, the second unlocks whatever you put behind the VIP list.

4. 04

   Price the catalogue from in game

   Set Config.DevMode.Enabled = true, walk into a store and open the editor. Set prices, hide what you do not sell, restrict what belongs to a job. Everything lands in config/clothes_overrides.lua. Turn DevMode back off when you are done, it is checked again server side on every save.

5. 05

   Verify the integrations

   Set Config.Debug = true, restart, and read the console: one line per bridge category names the target that was picked. Config.Debug only controls logging, it is not the editor switch.

Price a section three different ways

Each store declares its own sections, and each section its own pricing mode. A flat rate for a whole section, a multiplier that makes later drawables dearer, or a table when only a handful of pieces deserve their own price.

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

Public exports grouped by domain. Each row shows the call signature and what it does, not how it does it.

Client

• GetSkinData

  exports['avenida_clotheshops']:GetSkinData() Copy

  The outfit the player wears, component by component, props included. This is what the store writes on purchase, so it is always in step with what the wardrobe shows.

• ApplySkin

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

  Applies a complete appearance to a ped. Applying an outfit clears the decoration slot, so this call puts the barber and tattoo work back afterwards rather than leaving a bare skin.

• ApplyClothing

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

  Changes the clothes and nothing else. With temporary set to true the outfit lives for the session only, which is how a uniform handed out by a job should behave.

Server

• GetBagStorage

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

  The capacity a backpack drawable grants, weight and slots, or nil when that drawable carries nothing. Call it from your inventory resource so a bag bought in the store actually holds something.

Real-world copy-paste examples. Drop them into your own resource, tweak the values, ship.

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

• A player says they lost clothes they owned
  Check `Config.Clothes.RequireOwnership`. The ledger seeds a character from what they are already wearing the first time it sees them, so turning it on does not take a wardrobe away. What it does refuse is a write for a garment with no purchase behind it, which is also what a tampered client sends. If a resource of yours dresses players in pieces they never bought, either register those purchases or set the flag to false.
• The catalogue editor does not open
• The same jacket appears several times
• Hair goes through a helmet
• Do outfit pictures need anything installed?
• Which frameworks does it actually support?
• Can I run it next to avenida_barber and avenida_tattoo?
• What does it cost when nobody is shopping?