Outfits

illenium-appearance has three outfit systems: player outfits, boss-managed outfits, and static job outfits.

Player Outfits

Players can save, load, update, and delete personal outfits. Outfits store components, props, and the ped model.

Saving

Players save outfits via the outfit menu. Each outfit gets a unique name. Duplicate names are rejected.

Outfit Codes

Players can generate a share code for any outfit. Other players can import the outfit using this code. Codes are configurable length:

Config.OutfitCodeLength = 10

Commands

When Config.EnableJobOutfitsCommand = true:

• /joboutfits - Open job outfit menu
• /gangoutfits - Open gang outfit menu

Boss-Managed Outfits

When Config.BossManagedOutfits = true, job/gang bosses can create and manage uniforms for their employees.

How It Works

1. The boss uses /bossmanagedoutfits (ESX) or the management menu item
2. They can save the current appearance as a uniform, specifying:
   • Outfit name
   • Gender (male/female)
   • Minimum rank required to wear it
3. Employees see available uniforms in clothing rooms, filtered by their rank
4. Bosses can delete outfits they manage

Database

Boss outfits are stored in the management_outfits table:

CREATE TABLE management_outfits (
    id INT AUTO_INCREMENT PRIMARY KEY,
    job_name VARCHAR(50),
    type VARCHAR(10),        -- "Job" or "Gang"
    minrank INT DEFAULT 0,
    name VARCHAR(100),
    gender VARCHAR(10),
    model VARCHAR(50),
    components LONGTEXT,     -- JSON
    props LONGTEXT           -- JSON
);

Static Job Outfits

When Config.BossManagedOutfits = false, outfits are defined directly in config:

Config.Outfits = {
    ["police"] = {
        ["male"] = {
            {
                name = "Patrol Officer",
                outfitData = {
                    ["pants"] = { item = 24, texture = 0 },
                    ["torso2"] = { item = 55, texture = 0 },
                    ["shoes"] = { item = 25, texture = 0 },
                    -- ...
                },
                grades = { 0, 1, 2, 3 },
            },
        },
        ["female"] = {
            -- ...
        },
    },
}

Each outfit specifies which grades can access it via the grades array.

Uniform Persistence

When Config.PersistUniforms = true, the player’s current uniform is remembered across reconnects and logouts. The uniform is re-applied on login via the server-side uniform cache.

Selecting “Civilian Clothes” in the outfit menu removes the uniform and reloads the player’s saved skin.