DEFAULT APPEARANCE#

Overview#

When a new character is created, they start with the default appearance defined in InitialPlayerClothes. This uses the Schema v2 collection-based format.

Schema Version#

config/defaults.lua
Copy
InitialPlayerClothes = {
    male = {
        schema_version = 2,
        -- ... appearance data
    },
    female = {
        schema_version = 2,
        -- ... appearance data
    }
}

Model Selection#

Set the default ped model:

config/defaults.lua
Copy
InitialPlayerClothes = {
    male = {
        schema_version = 2,
        model = "mp_m_freemode_01"
    },
    female = {
        schema_version = 2,
        model = "mp_f_freemode_01"
    }
}

Head Blend (Heritage)#

Configure the default face blend:

config/defaults.lua
Copy
headBlend = {
    shapeFirst = 0,      -- First parent face shape(0-45)
    shapeSecond = 0,     -- Second parent face shape(0-45)
    shapeThird = 0,      -- Third blend shape
    skinFirst = 0,       -- First parent skin tone
    skinSecond = 0,      -- Second parent skin tone
    skinThird = 0,       -- Third skin blend
    shapeMix = 0.5,      -- Shape blend(0.0-1.0)
    skinMix = 0.5,       -- Skin blend(0.0-1.0)
    thirdMix = 0.0       -- Third blend amount
}

Components (Clothing)#

Define default clothing using collection-based references:

config/defaults.lua
Copy
components = {
    ["0"] = {  -- Face/Head
        collection = "base",
        localIndex = 0,
        texture = 0
    },
    ["1"] = {  -- Mask
        collection = "base",
        localIndex = 0,
        texture = 0
    },
    ["2"] = {  -- Hair
        collection = "base",
        localIndex = 0,
        texture = 0
    },
    ["3"] = {  -- Arms/Gloves
        collection = "base",
        localIndex = 15,
        texture = 0
    },
    ["4"] = {  -- Pants
        collection = "base",
        localIndex = 21,
        texture = 0
    },
    ["5"] = {  -- Bag
        collection = "base",
        localIndex = 0,
        texture = 0
    },
    ["6"] = {  -- Shoes
        collection = "base",
        localIndex = 34,
        texture = 0
    },
    ["7"] = {  -- Accessory
        collection = "base",
        localIndex = 0,
        texture = 0
    },
    ["8"] = {  -- Undershirt
        collection = "base",
        localIndex = 15,
        texture = 0
    },
    ["9"] = {  -- Vest
        collection = "base",
        localIndex = 0,
        texture = 0
    },
    ["10"] = {  -- Decals
        collection = "base",
        localIndex = 0,
        texture = 0
    },
    ["11"] = {  -- Torso
        collection = "base",
        localIndex = 15,
        texture = 0
    }
}

Component Properties:

Props (Accessories)#

Define default props:

config/defaults.lua
Copy
props = {
    ["0"] = {  -- Hat
        collection = "base",
        localIndex = -1,  -- -1 = no prop
        texture = 0
    },
    ["1"] = {  -- Glasses
        collection = "base",
        localIndex = -1,
        texture = 0
    },
    ["2"] = {  -- Ear
        collection = "base",
        localIndex = -1,
        texture = 0
    },
    ["6"] = {  -- Watch
        collection = "base",
        localIndex = -1,
        texture = 0
    },
    ["7"] = {  -- Bracelet
        collection = "base",
        localIndex = -1,
        texture = 0
    }
}

Face Features#

Configure 20 face feature sliders:

config/defaults.lua
Copy
faceFeatures = {
    nose_0 = 0.0,          -- Nose width
    nose_1 = 0.0,          -- Nose peak height
    nose_2 = 0.0,          -- Nose peak length
    nose_3 = 0.0,          -- Nose bone height
    nose_4 = 0.0,          -- Nose bone twist
    nose_5 = 0.0,          -- Nose bridge
    eyebrows_0 = 0.0,      -- Eyebrow height
    eyebrows_1 = 0.0,      -- Eyebrow depth
    cheeks_0 = 0.0,        -- Cheek bone height
    cheeks_1 = 0.0,        -- Cheek bone width
    cheeks_2 = 0.0,        -- Cheek width
    eyes_0 = 0.0,          -- Eye opening
    lips_0 = 0.0,          -- Lip thickness
    jaw_0 = 0.0,           -- Jaw bone width
    jaw_1 = 0.0,           -- Jaw bone depth
    chin_0 = 0.0,          -- Chin height
    chin_1 = 0.0,          -- Chin length
    chin_2 = 0.0,          -- Chin width
    chin_3 = 0.0,          -- Chin hole size
    neck_thikness = 0.0    -- Neck thickness
}

Overlays (Appearance)#

Configure face overlays (makeup, beard, etc.):

config/defaults.lua
Copy
overlays = {
    blemish = {
        style = 0,
        opacity = 0.0,
        color = 0
    },
    beard = {
        style = 0,
        opacity = 0.0,
        color = 0
    },
    eyebrows = {
        style = 0,
        opacity = 1.0,
        color = 0
    },
    aging = {
        style = 0,
        opacity = 0.0,
        color = 0
    },
    makeup = {
        style = 0,
        opacity = 0.0,
        color = 0
    },
    blush = {
        style = 0,
        opacity = 0.0,
        color = 0
    },
    complexion = {
        style = 0,
        opacity = 0.0,
        color = 0
    },
    sundamage = {
        style = 0,
        opacity = 0.0,
        color = 0
    },
    lipstick = {
        style = 0,
        opacity = 0.0,
        color = 0
    },
    freckles = {
        style = 0,
        opacity = 0.0,
        color = 0
    },
    chesthair = {
        style = 0,
        opacity = 0.0,
        color = 0
    },
    bodyblemish = {
        style = 0,
        opacity = 0.0,
        color = 0
    }
}

Hair Settings#

Configure hair color:

config/defaults.lua
Copy
hair = {
    color = 0,        -- Primary hair color(0-63)
    highlight = 0,    -- Highlight color(0-63)
    fade = 0          -- Fade style(if applicable)
}

Eye Color#

config/defaults.lua
Copy
eyeColor = 0  -- Eye color(0-31)

Tattoos#

config/defaults.lua
Copy
tattoos = {}  -- Empty array = no tattoos

To add default tattoos:

tattoos = {
    { collection = "mpbusiness_overlays", name = "MP_Busi_M_Chest_000" },
    { collection = "mpbusiness_overlays", name = "MP_Busi_M_LeftArm_000" }
}

Complete Example#

config/defaults.lua
Copy
InitialPlayerClothes = {
    male = {
        schema_version = 2,
        model = "mp_m_freemode_01",
        headBlend = {
            shapeFirst = 0, shapeSecond = 0, shapeThird = 0,
            skinFirst = 0, skinSecond = 0, skinThird = 0,
            shapeMix = 0.5, skinMix = 0.5, thirdMix = 0.0
        },
        components = {
            ["3"] = { collection = "base", localIndex = 15, texture = 0 },
            ["4"] = { collection = "base", localIndex = 21, texture = 0 },
            ["6"] = { collection = "base", localIndex = 34, texture = 0 },
            ["8"] = { collection = "base", localIndex = 15, texture = 0 },
            ["11"] = { collection = "base", localIndex = 15, texture = 0 }
        },
        props = {
            ["0"] = { collection = "base", localIndex = -1, texture = 0 },
            ["1"] = { collection = "base", localIndex = -1, texture = 0 }
        },
        faceFeatures = {
            nose_0 = 0.0, nose_1 = 0.0, nose_2 = 0.0,
            -- ... all 20 features
        },
        overlays = {
            eyebrows = { style = 0, opacity = 1.0, color = 0 },
            -- ... all overlays
        },
        hair = { color = 0, highlight = 0, fade = 0 },
        eyeColor = 0,
        tattoos = {}
    }
}

Next Steps#