Character Creator

Three settings in shared/config.lua shape the first-time character editor (and any startPlayerCustomization call that mirrors it).

Editable sections

Config.NewCharacterSections toggles which tabs a brand-new character can edit:

shared/config.lua

Config.NewCharacterSections = {
    Ped          = true,
    HeadBlend    = true,
    FaceFeatures = true,
    HeadOverlays = true,
    Components   = true,
    Props        = true,
    Tattoos      = true,
}

Section	What it exposes
`Ped`	The model picker (see selectable peds below).
`HeadBlend`	Parents / heritage / skin mix.
`FaceFeatures`	Nose, brow, cheek, jaw sliders.
`HeadOverlays`	Beard, eyebrows, makeup, blemishes, etc.
`Components`	Clothing (tops, legs, shoes, bags …).
`Props`	Hats, glasses, watches, bracelets.
`Tattoos`	The tattoo picker.

These are the same keys the startPlayerCustomization export accepts, so other scripts can open a matching editor.

Selectable peds

Config.Peds is the list of non-freemode models offered in the model picker (animals and story-mode peds). When the Ped section is enabled, players can switch to any model listed here:

shared/peds.lua

Config.Peds = {
    pedConfig = {
        {
            peds = {
                "a_c_boar",
                "a_c_cat_01",
                "a_f_m_beach_01",
                -- … hundreds of models
            },
        },
    },
}

Add or remove model names from the peds array to change what’s offered. getPedModel only resolves models that appear in this list - everything else is treated as a freemode ped.

Config.GenderBasedOnPed = true derives the male/female option sets from the chosen model. Leave it on unless you have a reason to force a gender.

Starting clothes

Config.InitialPlayerClothes is the default look applied to a fresh character, per gender, before they touch anything:

shared/config.lua

Config.InitialPlayerClothes = {
    Male = {
        Model      = "mp_m_freemode_01",
        Components = { { component_id = 0, drawable = 0, texture = 0 }, --[[ … ]] },
        Props      = { { prop_id = 0, drawable = -1, texture = -1 }, --[[ … ]] },
        Hair       = { color = 0, highlight = 0, style = 0, texture = 0 },
    },
    Female = { --[[ … ]] },
}

Field	Effect
`Model`	Starting freemode model for that gender.
`Components`	Default clothing as `{ component_id, drawable, texture }` entries.
`Props`	Default props; `-1` leaves a slot empty.
`Hair`	Default `{ color, highlight, style, texture }`.

Component and prop slot IDs are listed on the Image Previews page.

Get Started

Awoken Scripts

Editable sections

Selectable peds

Starting clothes

​Editable sections

​Selectable peds

​Starting clothes

Editable sections

Selectable peds

Starting clothes