Flake Wearables

Overview

Flake Wearables adds equippable clothing accessories to your server. Players use an item to open a context menu, select from available presets, and the component is applied directly to their ped through illenium-appearance. Items are removed from inventory on equip and restored on unequip.

Features

• Six Categories — Chains, Watches, Bags, Bulletproof Vests, Decals, T-Shirts.
• Context Menu UI — Clean ox_lib menu for browsing and equipping.
• Gender Support — Separate male and female drawable/texture presets.
• illenium-appearance — Saves and restores wearables with player outfits.
• Item-Based — Each wearable is a usable inventory item.
• Easy Presets — Add new styles by editing simple Lua tables.

Requirements

Installation

Step 1 — Drop the Resource

Place the flake_wearables folder into your server's resources directory and add to server.cfg:

Step 2 — Add Items

Add each wearable item to your ox_inventory/data/items.lua (or QB inventory equivalent). Each item requires:

• usable = true
• close = true (optional — closes inventory on use)

['chain_gold'] = {
    label  = 'Gold Chain',
    weight = 100,
    stack  = false,
    close  = true,
    usable = true,
},

Step 3 — Configure

Edit shared.lua to map your inventory item names to wearable categories. See the Adding Items section below.

File Structure

flake_wearables/
├── wearables/
│   ├── chains.lua   -- Chain presets (escrow-ignored)
│   ├── watches.lua  -- Watch presets (escrow-ignored)
│   ├── bag.lua      -- Bag presets (escrow-ignored)
│   ├── bproof.lua   -- Bulletproof vest presets (escrow-ignored)
│   ├── decals.lua   -- Decal presets (escrow-ignored)
│   └── tshirt.lua   -- T-shirt presets (escrow-ignored)
├── client/
│   └── main.lua     -- Menu logic, component application
├── server/
│   └── main.lua     -- Item registration, callbacks
├── shared.lua   -- Item-to-category mapping (escrow-ignored)
└── fxmanifest.lua  -- Resource manifest

Configuration

All preset files and shared.lua are escrow-ignored and fully editable.

Item Mapping

shared.lua maps inventory item names to wearable categories. When a player uses any item in the list, the script opens the context menu for that category.

Config.Chains = {
    Items = {
        'chain_gold',
        'chain_silver',
        'chain_diamond',
    },
}

Categories

Adding Items

Adding a new wearable style takes three steps.

Step 1 — Add Inventory Item

Register the item in your inventory config:

['chain_ruby'] = {
    label  = 'Ruby Chain',
    weight = 100,
    stack  = false,
    close  = true,
    usable = true,
},

Step 2 — Map to Category

Add the item name to the correct list in shared.lua:

Config.Chains.Items = {
    'chain_gold',
    'chain_silver',
    'chain_ruby',  -- new
}

Step 3 — Add Preset

Open the corresponding preset file (e.g. wearables/chains.lua) and add the drawable data:

Config.Chains.Presets.Chains.chain_ruby = {
    male = {
        drawable = 15,
        texture  = 0,
    },
    female = {
        drawable = 15,
        texture  = 0,
    },
}

Troubleshooting