Clothing

aty_clothing

A modern character customization system for FiveM with support for ESX and QBCore frameworks.

📋 Features

• Character creation with heritage, face features, clothing, accessories
• Multiple shop types (clothing stores, barber shops, tattoo shops)
• Wardrobe system for saving outfits
• Shop ownership system with rent and balance management
• Multi-language support (English, Turkish)
• Modern Vue.js UI with image previews

---

🔧 Dependencies

• oxmysql - Database
• ox_lib - UI components and notifications
• PolyZone - Zone detection (optional)

---

🔌 Developer Integration & APIs

We provide a comprehensive, framework-agnostic integration API. All technical details, exports, events, framework compatibility layers, and practical examples have been organized into a dedicated integration guide.

API Capabilities Overview:

• Customized Shop Triggers: Open menus with restricted categories (e.g., face, hair, or tattoos only) and unique pricing.
• Wardrobe Integrations: Programmatically hook personal drawers for apartments, housing, and organization locker rooms.
• Ped Skin Accessors: Instant client-side and server-side exports to read or write ped skin data.
• Database Utilities: Framework-independent methods to fetch or save player skins and outfit collections.
• Backward Compatibility: Seamless out-of-the-box event handling compatibility for qb-clothing/qb-clothes and esx_skin/skinchanger.

---

⚙️ Configuration

Locale

Set the language in shared/locale.lua:

Locale = 'en'  -- English
Locale = 'tr'  -- Turkish

Shop Configuration

Configure shops in config.lua:

Config.Shops = {
    {
        id = "clothing_1",
        type = "market",
        label = "Clothing Store",
        coords = vector3(123.0, 456.0, 78.0),
        price = 50000,
        weeklyRent = 5000,
        allowedCategories = {"clothes", "accessories"}
    }
}

Wardrobe Configuration

Configure wardrobes in config.lua:

Config.Wardrobes = {
    {
        coords = vector3(123.0, 456.0, 78.0),
        job = nil,  -- nil = public, "police" = job-locked
        allowedCategories = {"clothes", "accessories"}
    }
}

---

📁 Skin Data Structure

{
    -- Model
    sex = 0,  -- 0 = male, 1 = female

    -- Heritage
    mom = 0,
    dad = 0,
    face_md_weight = 0.5,
    skin_md_weight = 0.5,

    -- Face features
    nose_1 = 0.0,
    nose_2 = 0.0,
    -- ... (all face shape values)

    -- Clothing
    tshirt_1 = 0,
    tshirt_2 = 0,
    torso_1 = 0,
    torso_2 = 0,
    pants_1 = 0,
    pants_2 = 0,
    shoes_1 = 0,
    shoes_2 = 0,
    -- ... (all clothing values)

    -- Accessories
    helmet_1 = -1,
    helmet_2 = 0,
    glasses_1 = -1,
    glasses_2 = 0,
    -- ... (all accessory values)

    -- Hair & Makeup
    hair_1 = 0,
    hair_2 = 0,
    hair_color_1 = 0,
    hair_color_2 = 0,
    beard_1 = 0,
    beard_2 = 0,
    -- ... (all hair/makeup values)
}