> 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/game-mechanics/files-naming.md).

# Files Naming

Learn about GTA V Files Naming

## **Component & Prop File Naming**

Components and props are referred to as **drawables**, and they follow specific naming conventions. A drawable’s file name provides information about its **type**, **model ID**, and **skin tone data**.

### **Components:**

A component represents a core body part or clothing piece (e.g., a shirt, shoes, or hands).

* **Example**: `accs_000_u`
  * **accs**: Indicates the component type (undershirts).
  * **000**: This is the model number for the drawable (the first item in this category).
  * **\_u**: This suffix means the item is **universal** and does not use raced skin tone composition data.

To change the type of this drawable to a top (shirt), you would rename it to:

* **jbib\_000\_u**
  * **jbib**: Indicates this is now a top (component ID 11).
  * The `000` indicates it is the first top, and `_u` indicates universal skin tone data.

{% hint style="warning" %}
Changing `_u` to the raced `_r` suffix does not create skin tone support by itself. Raced texture naming and the related skin tone data must be configured together. See [Skin Tone Data](https://docs.gta.clothing/game-mechanics/skin-tone-data.md) for details.
{% endhint %}

### **Props:**

Props are items like hats, glasses, or other accessories. The naming convention is similar, but props don’t require skin tone data.

* **Example**: `p_eyes_000`
  * **p\_eyes**: Indicates this is an eye accessory (glasses or similar).
  * **000**: The model number for this prop.

Props do not use a component skin-tone suffix. They still need compatible attachment anchors and assets for the ped that wears them.

## **Texture File Naming**

For custom peds, the model identity and layout also matter. Streamed peds have separate component dictionaries, while packed peds combine entries in dictionaries named for the model. FiveM streamed names can include a caret, such as `your_model^uppr_000_u.ydd`, to map a file into the model's dictionary. DCT generates these names and the appropriate Singleplayer archive layout. Keep generated resource names intact instead of adding an `ig_` prefix or copying freemode collection names. See [Custom Peds](https://docs.gta.clothing/custom-addon-peds/custom-peds.md).

Textures that correspond to drawable models follow a similar convention, ensuring that the correct texture is applied to each drawable item. The texture file name must match the corresponding **drawable type** and **model number**.

### **Example:**

* **accs\_diff\_000\_a\_uni**
  * **accs**: Corresponding component (undershirts).
  * **diff**: This indicates the file is a diffuse texture.
  * **000**: The model number for the drawable (must match the model file).
  * **a**: The texture variation (first variation).
  * **uni**: Universal texture (no skin tone data).

If the drawable type changes, such as renaming the undershirt to a top, the texture file must also be renamed accordingly:

* **jbib\_diff\_000\_a\_uni**: Now corresponds to a top (jbib) drawable.

{% hint style="info" %}
YDD files can also contain embedded textures, so a separate YTD is not required in every valid setup. When external YTD textures are used, their names still need to match the drawable.
{% endhint %}

## **Alternation Models and Mesh Physics Files**

**Alternation models** are related numbered drawable models. Their purpose depends on the drawable type and generated metadata, so `_1`, `_2`, and `_3` do not have one universal meaning. For auto-resolution, append the number to the complete main-model base name and keep the files in the same folder.

* **Main model**: `accs_001_u.ydd`
* **First alternation model**: `accs_001_u_1.ydd`

See [Model Alternations](https://docs.gta.clothing/game-mechanics/model-alternations.md) for the supported first-person and hair-related uses.

**Mesh physics files** define the movement and physical properties of a cloth item, such as the way a jacket or cape might sway. These files follow the same naming conventions as their corresponding model files, but they end with `.yld`.

* **Main model**: `accs_001_u.ydd`
* **Matching mesh physics file**: `accs_001_u.yld`

When adding local files or folders, automatic related-file discovery includes matching binary files and CodeWalker `.ytd.xml`, `.yld.xml` and `_1`, `_2` or `_3` `.ydd.xml` companions. Keep the related files in the same folder and referenced DDS textures at the paths recorded in the XML. See [Auto Cloth Data Resolving](https://docs.gta.clothing/basics/good-to-know/auto-cloth-data-resolving.md).

By following these **naming conventions**, you ensure that all the files are properly linked within **Durty Cloth Tool**, allowing for easy management of textures, alternation models, and physics files in your projects.
