> 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/add-or-replace-custom-ped-clothes.md).

# Add or Replace Custom Ped Clothes

Add clothing collections to streamed game peds or rebuild the clothes of an existing packed ped

Use this workflow to make clothing for a ped in your installed GTA V game. The ped's layout determines how you can change its clothes. To import authored files or a complete ped resource as a new model, use [Create a Custom Ped Resource](https://docs.gta.clothing/custom-addon-peds/create-a-custom-ped-resource.md).

{% hint style="warning" %}
Custom ped projects require an active **Advanced or Ultimate license** and a GTA V installation that contains the ped. Projects saved by this version cannot be opened by older Durty Cloth Tool builds.
{% endhint %}

## Choose the source

* Choose **Game Ped** to edit an installed ped. DCT keeps its model name and prepares replacement output for that ped.
* Choose **Custom Addon Ped** when importing files for a separately spawnable model. Its output name is assigned in **Build Project**.

`ig_` does not mean streamed. For example, `ig_money` is packed while `player_zero` is streamed in GTA V Legacy. Both have clothing components, but their output layouts differ. See [Custom Peds](https://docs.gta.clothing/custom-addon-peds/custom-peds.md).

## Set up an existing game ped

1. Set the GTA V installation in DCT to the edition and build that contains the ped.
2. Create a project and open **Project Settings > Ped & Body > Custom ped**. Saving first is optional.
3. Choose **Game Ped**, then search for or enter its **Source model name**.
4. Wait for automatic validation. The field shows whether the name is valid, and DCT loads the skeleton and clothes. An invalid name leaves the current setup intact.
5. Add clothes made for that ped's rig, or edit the imported clothing items. Choose defaults and preview the result.
6. Open **Build Project** (or press **Ctrl+K** and paste `>Build project`), review **Replace an existing ped** and build for FiveM or Singleplayer. The existing model name is kept.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-49f28fc4edf05fd491e479637189f95d81df8ab3%2Fcustom-ped-game-ped.png?alt=media" alt="Project Settings, Ped &#x26; Body with Custom ped and Game Ped selected, A_C_Chop validated as the Source model name with a check mark, Ped loaded successfully and a collapsed Default appearance."><figcaption><p>A Game Ped setup with a validated source model.</p></figcaption></figure>

In 3D Preview, **Original base-game clothes** lets you compare the installed ped's original clothes without changing the project. It includes base-game components and props, not separately installed addon collections. These choices are temporary: wear project items before saving a default appearance. New Custom Addon Ped projects do not show this browser.

{% hint style="info" %}
Game dependencies use the configured installation. You do not need to name an external ped resource for a stock game ped.
{% endhint %}

## Replace existing clothes

**Game Ped** prepares replacement output by default. For packed peds, DCT rebuilds the complete affected dictionaries and keeps the entries outside the editable clothes.

* Keep untouched clothing items when existing scripts or metadata depend on their indices. Removing an item moves the later items of that slot down, and the build log names each slot whose numbers moved.
* Resolve missing source entries before building a complete replacement.
* Review the whole set of clothes before installation, not only the item you changed. Packed peds can share a dictionary among several components or props, and a partial collection of loose clothing files cannot replace that dictionary.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-b973841774defc5ebcda5d7a35869976d461ec63%2Fgame-ped-build-replace.png?alt=media" alt="Build Project for a Game Ped project of a_m_y_hipster_01 with FiveM Resource and Legacy chosen: Source model name a_m_y_hipster_01, the Replace an existing ped section expanded with its explanation and Replace an existing ped ticked, and the Build overview with the mode Replace an existing ped, 18 drawables and the resource hipster_outfits as a Replacement collection."><figcaption><p>Replace an existing ped in Build Project, with the replacement resource in the build overview.</p></figcaption></figure>

{% hint style="warning" %}
A replacement changes that ped for every resource that uses the model. Install the generated replacement resource and avoid loading another resource that replaces the same model or dictionaries. Keep the original project and resource so you can restore them. In Singleplayer, install the generated addon-DLC replacement without editing the original game archives.
{% endhint %}

## Additional collections for streamed peds

For a streamed game ped, you can turn off the advanced **Replace an existing ped** option in **Build Project** to build an additional clothing collection instead. Packed peds require replacement.

In collection mode, unchanged base items remain references to the existing ped. Editing a base item creates a clothing addition for the collection instead of overwriting its original drawable. A clothing collection alone cannot supply a missing base model.

Use the generated model, collection and local indices in your clothing script. FiveM's [collection-based natives](https://docs.fivem.net/docs/scripting-manual/using-new-game-features/collection-based-natives/) avoid relying on global drawable offsets that change when other collections load.

## Validate the result

1. Check the generated resource information and default appearance.
2. Test the target model in the game. Verify existing variations as well as new ones, including texture selection and props.
3. Test animation and ragdoll with the actual skeleton, and check different LOD distances.

For FiveM, also check resource restart and appearance synchronization between clients. If a framework resets the model or clothes after spawning, update its integration to use the selected model and collection coordinates. DCT hides integrations whose output cannot represent the custom ped correctly.

The [new custom ped guide](https://docs.gta.clothing/pages/ShDxXAflJV2hZZ5yCanJ#id-5.-build-and-install) explains the generated default-appearance helper and deployment requirements.

## See also

* [Custom Peds](https://docs.gta.clothing/custom-addon-peds/custom-peds.md)
* [Create a Custom Ped Resource](https://docs.gta.clothing/custom-addon-peds/create-a-custom-ped-resource.md)
* [Build Options](https://docs.gta.clothing/basics/essential-knowledge/build-options.md)
