> ## Documentation Index
> Fetch the complete documentation index at: https://docs.awokenlabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Character Creator

> Control the new-character editor - sections, selectable peds, and starting clothes.

Three settings in `shared/config.lua` shape the first-time character editor (and any [`startPlayerCustomization`](/resources/awoken-appearance/exports#opening-the-editor) call that mirrors it).

## Editable sections

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

```lua shared/config.lua theme={"dark"}
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`](/resources/awoken-appearance/exports#opening-the-editor) 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:

```lua shared/peds.lua theme={"dark"}
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.

<Note>
  `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.
</Note>

## Starting clothes

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

```lua shared/config.lua theme={"dark"}
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](/resources/awoken-appearance/configuration/image-previews) page.