Configuration

Complete configuration guide for Oxide Clothing stores, barbers, surgeons, and system settings.

All configuration options for oxide-clothing are in config.lua.


Player Models

Female Models

Config.WomanPlayerModels = {
    'mp_f_freemode_01',  -- Default freemode female
    'a_f_m_beach_01',
    -- ... additional models
}

Male Models

Config.ManPlayerModels = {
    'mp_m_freemode_01',  -- Default freemode male
    'a_m_m_beach_01',
    -- ... additional models
}

Note: mp_f_freemode_01 and mp_m_freemode_01 are the only models that support full customization (heritage, features, overlays). Other models only support clothing changes.


Clothing Stores

Define clothing store locations:

Config.Stores = {
    {
        coords = vector3(72.25, -1399.1, 29.37),
        heading = 0.0,
        name = "Strawberry",
    },
    {
        coords = vector3(-703.77, -152.26, 37.41),
        heading = 0.0,
        name = "Rockford Hills",
    },
    -- Add more stores...
}

Store Options

PropertyTypeDescription
coordsvector3Store location
headingnumberPed heading when customizing
namestringStore display name

Barber Shops

Define barber shop locations:

Config.Barbers = {
    {
        coords = vector3(-814.31, -183.82, 37.57),
        heading = 0.0,
        name = "Rockford Hills",
    },
    -- Add more barbers...
}

Barbers allow modification of:

  • Hair style and color
  • Facial hair (beard)
  • Eyebrows
  • Makeup

Plastic Surgeons

Define plastic surgeon locations:

Config.Surgeons = {
    {
        coords = vector3(300.0, -600.0, 43.0),
        heading = 0.0,
        name = "Downtown",
    },
}

Surgeons allow modification of:

  • Face features (20 sliders)
  • Overlays (blemishes, ageing, etc.)
  • Eye color

Job Locker Rooms

Configure job-specific outfit locations:

Config.JobOutfits = {
    ['police'] = {
        coords = vector3(450.0, -980.0, 30.0),
        outfits = {
            {
                name = "Patrol Uniform",
                components = {
                    [1] = { drawable = 0, texture = 0 },   -- Mask
                    [3] = { drawable = 55, texture = 0 },  -- Torso
                    [4] = { drawable = 35, texture = 0 },  -- Legs
                    [6] = { drawable = 25, texture = 0 },  -- Shoes
                    [8] = { drawable = 58, texture = 0 },  -- Undershirt
                    [11] = { drawable = 55, texture = 0 }, -- Torso2
                },
                props = {
                    [0] = { drawable = 46, texture = 0 },  -- Hat
                },
            },
            {
                name = "SWAT Uniform",
                components = { ... },
                props = { ... },
            },
        },
    },
    ['ambulance'] = {
        coords = vector3(300.0, -600.0, 43.0),
        outfits = { ... },
    },
}

Component IDs

IDComponent
0Face
1Mask
2Hair
3Torso
4Legs
5Bag
6Shoes
7Accessory
8Undershirt
9Kevlar
10Badge
11Torso2

Prop IDs

IDProp
0Hat
1Glasses
2Ear
6Watch
7Bracelet

Zone Settings

Configure interaction zones:

Config.ZoneRadius = 2.0          -- Interaction radius
Config.ZoneHeight = 3.0          -- Zone height
Config.UseTarget = true          -- Use qb-target instead of proximity

Camera Settings

Config.CameraOffset = 2.0        -- Camera distance from player
Config.CameraAngles = {
    face = { offset = 0.6, height = 0.6 },
    body = { offset = 1.2, height = 0.0 },
    full = { offset = 2.0, height = 0.0 },
}

Debug Mode

Enable debug logging:

Config.Debug = true

When enabled, prints detailed logs to F8 console with [oxide-clothing] prefix.