> For the complete documentation index, see [llms.txt](https://docs.gta.clothing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gta.clothing/custom-addon-peds/custom-peds.md).

# Custom Peds

Create custom addon peds with their own model, skeleton and clothes, or clothing for other game peds, and understand slots and resource layouts

Durty Cloth Tool makes clothing for the **MP Freemode** characters and for **custom peds**. A custom ped project targets one ped model, such as a story character, an animal, another game ped or a **custom addon ped** you authored with its own model, skeleton and clothes. Choose **Custom ped** in **Project Settings > Ped & Body**.

{% hint style="warning" %}
Custom ped setup, clothing editing, building and previewing require an active **Advanced or Ultimate license**. Features with their own higher license requirement keep that requirement.
{% endhint %}

## Choose your workflow

| You want to                                                                                           | Choose in Ped & Body                                                                      | Follow                                                                                                                |
| ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Create a new spawnable ped with its own model, skeleton and clothes                                   | **Custom ped > Custom Addon Ped**                                                         | [Create a Custom Ped Resource](https://docs.gta.clothing/custom-addon-peds/create-a-custom-ped-resource.md)           |
| Turn a human character you made into a new spawnable ped, rigged from an installed ped of your game   | Nothing: Durty Cloth Tool creates the custom ped project for you (rigging needs Ultimate) | [Custom Ped in Blender](https://docs.gta.clothing/plugins/creator-link/blender/custom-ped.md)                         |
| Add or replace clothing for a ped that is already in the game, such as a story character or an animal | **Custom ped > Game Ped**                                                                 | [Add or Replace Custom Ped Clothes](https://docs.gta.clothing/custom-addon-peds/add-or-replace-custom-ped-clothes.md) |
| Make freemode clothing and preview it on a matching body                                              | **MP Freemode**                                                                           | [Custom Ped Preview Support](https://docs.gta.clothing/basics/good-to-know/custom-ped-preview.md)                     |

New and existing projects default to **MP Freemode**, with the usual male and female clothing workflow. A custom preview body in a freemode project does not change its build target.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-987cacb5cc8f92574a38adda868bf25c06ac2fc1%2Fcustom-ped-addon-ped.png?alt=media" alt="Project Settings, Ped &#x26; Body with Custom ped selected, Custom Addon Ped as the ped source with its help text, and Behaviour metadata set to use the metadata included with the files."><figcaption><p>Custom ped in Project Settings > Ped &#x26; Body, with Game Ped or Custom Addon Ped as the ped source.</p></figcaption></figure>

{% hint style="warning" %}
Older Durty Cloth Tool builds cannot open projects saved by the current build, so keep a copy of a project before you convert it to a custom ped or share it with someone on an older build.
{% endhint %}

## Model, skeleton and clothes

The **model name** identifies the ped you spawn. Its skeleton defines the bones to which clothing is attached. Clothing made for another skeleton does not become compatible by renaming its files or changing a component slot.

A complete ped can need several kinds of files:

| File                           | What it supplies                                                                     |
| ------------------------------ | ------------------------------------------------------------------------------------ |
| YFT                            | The ped skeleton and related model data                                              |
| YDD                            | Body and clothing models, sometimes including embedded textures                      |
| YTD                            | External textures                                                                    |
| Variation YMT                  | Available component and prop variations and their appearance metadata                |
| `peds.meta`                    | Model identity, layout and behavior references                                       |
| Referenced assets and metadata | Animation, expression, creature, cloth physics and other data required by that setup |

Importing a skeleton does not create animations or physics for it. Start with compatible assets and resolve missing-reference findings before building. A dependency can come from the installed game, files included in your project, or a required resource declared by the imported setup.

## Streamed and packed peds

**Streamed** peds use separate clothing dictionaries. They can support additional clothing collections without replacing the original clothes. **Packed** peds store several drawable entries together in combined dictionaries. Editing their clothes requires rebuilding those dictionaries, so use an explicit replacement project when targeting an existing packed ped.

New authored setups use streamed layout by default. Imported setups retain the layout declared by their metadata. The [Sollumz clothing guide](https://docs.sollumz.org/tutorials/basic-clothes-editing) explains these two layouts and their separate skeleton files.

Examples in GTA V Legacy build 3889:

| Ped                                           | Layout   | What to consider                                   |
| --------------------------------------------- | -------- | -------------------------------------------------- |
| `s_m_m_gentransport`, `ig_money`, `csb_money` | Packed   | Use a complete addon copy or explicit replacement  |
| `player_zero`, `player_two`                   | Streamed | Use their own skeleton and appearance dependencies |
| `a_c_chop`                                    | Streamed | An animal can also have streamed components        |
| `a_c_crow`, `a_c_sharkhammer`                 | Packed   | The rig and behavior are specific to the animal    |

These are file-layout observations, not a promise that every clothing mechanic works on these models.

## What model prefixes mean

Prefixes are naming conventions. They do not select a skeleton or establish clothing support. You can use a suitable unique name for a new ped; DCT does not require `ig_`.

| Family       | Conventional meaning or use                                                                                 |
| ------------ | ----------------------------------------------------------------------------------------------------------- |
| `A_C`        | Animals                                                                                                     |
| `A_F`, `A_M` | Ambient female and male characters                                                                          |
| `S_F`, `S_M` | Scenario female and male characters                                                                         |
| `G_F`, `G_M` | Gang female and male characters                                                                             |
| `U_F`, `U_M` | Unique female and male characters                                                                           |
| `CS`, `CSB`  | Cutscene character families                                                                                 |
| `IG`         | In-game story character family                                                                              |
| `MP`         | Multiplayer models, including models other than freemode                                                    |
| `PLAYER`     | Main playable story characters                                                                              |
| `HC`         | Heist crew naming family                                                                                    |
| `P`          | Player-related examples include `p_franklin_02` and `p_michael_02`; inspect the complete model and metadata |
| `SLOD`       | Simplified level-of-detail models                                                                           |

Where present, `Y`, `M` and `O` commonly indicate young, middle-aged and old. These labels describe the name, not technical compatibility. See the [Cfx ped model reference](https://docs.fivem.net/docs/game-references/ped-models/) for listed models and categories.

## Components, props and available tools

GTA uses numbered component slots and prop anchors. Their usual freemode labels do not always describe another ped correctly. For example, `berd` does not always contain a mask, and `hand` does not always contain a bag. DCT retains the engine slot identifiers when presenting custom clothes.

An empty supported slot can receive clothing. An unsupported slot cannot. Prop support also depends on the target's anchors and assets.

DCT uses the selected ped to show the applicable item options, preview controls, findings and validation settings. Unsupported imported settings remain recoverable, and build findings name active content that cannot be represented.

{% hint style="warning" %}
**Not available for custom peds:** freemode body presets, body fitting and the freemode rig repairs. A ped made from your own character offers [Rig to this ped's body](https://docs.gta.clothing/plugins/creator-link/blender/custom-ped.md#rig-clothes-to-your-peds-body) instead. Tattoos and facial overlays are placed on the MP Freemode characters only. Facial blending, raced skin, hair alternates, heels and other specialized mechanics need compatible assets and metadata; copying the corresponding freemode settings alone is not enough.
{% endhint %}

The project default appearance refers to ordinary clothing items and textures. Editing an item edits the same clothing used in that default. In preview, temporary selections override defaults and explicitly worn items override those selections.

## Scripts and clothing numbers

For scripts, identify clothing by **model, collection and local index**. Freemode global index offsets do not apply to an arbitrary custom ped. See [Cfx collection-based natives](https://docs.fivem.net/docs/scripting-manual/using-new-game-features/collection-based-natives/).

{% hint style="warning" %}
Always test a custom ped in the game you build for: spawning, default and random appearances, clothing changes, animation, ragdoll and LODs. A correct file build cannot prove how every authored rig behaves in game.
{% endhint %}

## See also

* [Create a Custom Ped Resource](https://docs.gta.clothing/custom-addon-peds/create-a-custom-ped-resource.md)
* [Custom Ped](https://docs.gta.clothing/plugins/creator-link/blender/custom-ped.md) in Blender
* [Add or Replace Custom Ped Clothes](https://docs.gta.clothing/custom-addon-peds/add-or-replace-custom-ped-clothes.md)
* [3D Previewing Clothes](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md)
* [Thumbnails & Visual Exports](https://docs.gta.clothing/basics/good-to-know/thumbnails-and-exports.md)
* [Build Options](https://docs.gta.clothing/basics/essential-knowledge/build-options.md)
