Shops & Zones

Store Types

illenium-appearance supports four shop types:

Type	Sections Available
`clothing`	Components, Props
`barber`	Head Overlays (hair, beard, makeup, etc.)
`tattoo`	Tattoos
`surgeon`	Head Blend, Face Features

Defining Stores

Stores are defined in Config.Stores in shared/config.lua. Each store has a location and type:


Config.Stores = {
    {
        type = "clothing",
        coords = vec3(1693.32, 4823.48, 42.06),
        size = vec3(8, 8, 4),
        rotation = 45,
    },
    {
        type = "barber",
        coords = vec3(-814.31, -183.85, 37.57),
        size = vec3(6, 6, 4),
        rotation = 0,
    },
}

Polygon Zones

For irregularly shaped shops, use polygon zones:


{
    type = "clothing",
    usePoly = true,
    points = {
        vec3(1189.0, -3690.0, 36.0),
        vec3(1195.0, -3690.0, 36.0),
        vec3(1195.0, -3696.0, 36.0),
        vec3(1189.0, -3696.0, 36.0),
    },
}

Job/Gang Locked Stores

Restrict a store to a specific job or gang:


{
    type = "clothing",
    coords = vec3(461.69, -992.06, 30.69),
    size = vec3(8, 8, 4),
    rotation = 0,
    job = "police",   -- Only police can use this store
},
{
    type = "clothing",
    coords = vec3(100.0, 200.0, 30.0),
    size = vec3(6, 6, 4),
    rotation = 0,
    gang = "ballas",  -- Only ballas can use this store
},

Clothing Rooms

Job-specific clothing rooms where players can change into job outfits:


Config.ClothingRooms = {
    {
        coords = vec3(461.69, -992.06, 30.69),
        size = vec3(4, 4, 4),
        rotation = 0,
        job = "police",
    },
}

When Config.BossManagedOutfits = true, clothing rooms pull from the database. Otherwise, they use outfits defined in Config.Outfits.

Player Outfit Rooms

Outfit rooms restricted to specific CitizenIDs:


Config.PlayerOutfitRooms = {
    {
        coords = vec3(200.0, 300.0, 30.0),
        size = vec3(4, 4, 4),
        rotation = 0,
        citizenIDs = { "ABC12345", "DEF67890" },
    },
}

Leave citizenIDs empty or omit it to allow all players.

Target System

Set Config.UseTarget = true to use qb-target or ox_target instead of zone-based interactions.

Configure target peds in Config.TargetConfig:


Config.TargetConfig = {
    ["clothing"] = {
        model = "s_f_m_shop_high",
        scenario = "WORLD_HUMAN_STAND_MOBILE",
        icon = "fas fa-tshirt",
        label = "Clothing Store",
    },
    -- barber, tattoo, surgeon follow the same format
}

Shop Peds

NPC peds can be spawned at shop locations. Toggle with:


Config.EnablePedsForShops = true
Config.EnablePedsForClothingRooms = true
Config.EnablePedsForPlayerOutfitRooms = true