> 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/getting-started/first-cloth-resource.md).

# First Cloth Resource

Learn how to create your first addon cloth resource

{% hint style="info" %}
This guide uses the default **MP Freemode** project target. To create a custom addon ped with its own model and clothes, follow [Create a Custom Ped Resource](https://docs.gta.clothing/custom-addon-peds/create-a-custom-ped-resource.md). For clothing that fits a story character, an animal or another ped in the game, follow [Add or Replace Custom Ped Clothes](https://docs.gta.clothing/custom-addon-peds/add-or-replace-custom-ped-clothes.md).
{% endhint %}

## Introduction

Durty Cloth Tool is an extensive tool allowing users to create add-on clothing packs for FiveM and Singleplayer. The discontinued alt:V and RageMP platforms remain available as deprecated build targets for legacy workflows.

{% hint style="info" %}
**Durty Cloth Tool is a Subscription based licensed Software Tool.** It is actively maintained and supported, please be aware an active Subscription is needed to use this powerful tool in its full glory. A project within the free limits builds without a license, so you can follow this guide for free. Head to [License Activation](https://docs.gta.clothing/getting-started/license-activation.md#buying-a-license) for more details.
{% endhint %}

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-92c4f31a8d4d0eb1b8ed534e3b9b14e114e38e6f%2Fv4-highlights-poster.webp?alt=media" alt="A 30 second tour of Durty Cloth Tool V4: custom addon peds, Texture Studio patches on the ped, bone weights in Model Studio, a texture painted in an outside editor and shown live on the ped, 3D model import, wet fabric and cloth physics, 3D tattoo placement, findings and the Texture Optimizer, a FiveM Enhanced build and the 3D Preview in its own window."><figcaption><p>Durty Cloth Tool V4 in 30 seconds.</p></figcaption></figure>

{% embed url="<https://gta.clothing/assets/media/v4/v4-highlights-mobile.mp4?v=88b22a58f69e>" %}
Durty Cloth Tool V4 in 30 seconds.
{% endembed %}

{% hint style="warning" %}
**Make sure to have Durty Cloth Tool installed and running before continuing** with this article, see [Quickstart](https://docs.gta.clothing/getting-started/quickstart.md) for a quick guide on how to Download, Install & Start Durty Cloth Tool.
{% endhint %}

{% hint style="info" %}
**If you have an active Durty Cloth Tool Subscription**, before starting, please see [License Activation](https://docs.gta.clothing/getting-started/license-activation.md) in order to run DCT in fully licensed mode.
{% endhint %}

## 1. Creating your first Cloth Project

Durty Cloth Tool opens on **Home**. Choose **Create a new project** and you land straight in an empty workspace, with no setup wizard to get through first. When you first save, DCT asks where to save the project file: the project name comes from the file name (letters become lowercase, and spaces and characters a folder name cannot hold are left out), and the project's data goes into that folder unless you chose another one in **Project Settings**. You can also set these up now, which is optional before a first build.

{% hint style="info" %}
See our article about the [User Interface](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md) for more information, and [Home & Quick Look](https://docs.gta.clothing/basics/useful-to-know/home-and-quick-look.md) for the Home screen.
{% endhint %}

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-97dc68e572d1014173b6510526a8d0d688e7b8cc%2Fimage.png?alt=media" alt="Durty Cloth Tool with a new, empty project: the item list says Drop clothing files, a folder or a zip here, or use Add below, and Item Details says Drawable details will appear after items are added."><figcaption><p>Durty Cloth Tool with an empty / new Project</p></figcaption></figure>

**Open the Project Settings** by clicking on "**⚙️Project Settings**" in the bottom right of the application (or press **Ctrl+K** and paste `>Project Settings`). This will open the Project Settings window, where you can set the following fields:

* **Project Name**\
  Enter a simple desired name for this cloth project
* **DLC Name**\
  Setting Project Name will automatically set the DLC Name too, you can keep it that way in most cases
* **Project data folder**\
  This is the folder where your Cloth Project keeps all its data, choose wisely. It is not where your build goes: you choose that build output folder in the **Build Project** window

{% hint style="info" %}
See our article about the [Durty Cloth Projects](https://docs.gta.clothing/basics/useful-to-know/durty-cloth-projects.md) for more information regarding the Durty Cloth Project format and [App & Project Settings](https://docs.gta.clothing/basics/good-to-know/app-and-project-settings.md) for detailed explanations regarding all available settings.
{% endhint %}

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-d5eb80d02ac65616ab92545661f4321c712bded6%2Fimage.png?alt=media" alt="Project Settings on its General page with the Name and DLC name of the project, the optional Author, Version and Description, and the Project data folder, whose path is blurred."><figcaption><p>Durty Cloth Tool Project Settings Window</p></figcaption></figure>

If you have done setting up your Cloth Project, you can **go ahead and quickly save it** in order to be able to continue working on it at some later point.

{% hint style="info" %}
It is considered as best practice to keep the .dctproj file near the project data folder, for example on the same directory level as the `clothproject_` folder of your Cloth Project.
{% endhint %}

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-487dcc06dafd1e26e9929a89c0bf2d33a54be574%2Fimage.png?alt=media" alt="The open Project menu with Save and Save as below New, Open, Recent Projects and Close project."><figcaption><p>Save the project from the Project menu, or press Ctrl+S.</p></figcaption></figure>

Congratulations, you have finished setting up your first Cloth Project 🥳. In the next steps we will continue by adding our first clothes to it 👕

## 2. Adding Clothes to your Cloth Project

Before adding clothes to your Cloth Project, we will quickly have to cover what exactly we consider a Cloth:

* **YDD File** (Drawable) is the game file format that holds cloth model information, **basically the model of the cloth** you are adding. YDD files can also contain embedded textures.
* **YTD File** (Texture) is the game file format that holds texture information, **basically a texture variation of the cloth** you are adding.

{% hint style="info" %}
See our article about [Drawable Types & Textures](https://docs.gta.clothing/game-mechanics/drawable-types-and-textures.md) for more information.
{% endhint %}

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-7991b664de2ffb99565cc04f7df3f4b132bdd99a%2Fimage.png?alt=media" alt="The Add menu under the item list with Add from file(s), Add from folder(s), Only male, Only female, Tattoo, Add facial overlay and From another source."><figcaption><p>Durty Cloth Tool Options for adding clothes</p></figcaption></figure>

Durty Cloth Tool offers many options for adding either male or female clothes to your cloth project. We will quickly cover them:

* :transgender\_symbol: **Add**, offers various methods to add clothes where the target gender will be automatically resolved.
* :man: **Add > Only male**, offers various methods to add specifically male clothes. Useful in cases where Add method is not able to determine the target gender automatically.
* :woman: **Add > Only female**, offers various methods to add specifically female clothes. Useful in cases where Add method is not able to determine the target gender automatically.
* :card\_box: **Add > From another source > Add from DCT package**, the most easy way to get clothes added. Imports `*.dctpackage` files which contain all information related to one or multiple clothes. See [Import & Export Formats](https://docs.gta.clothing/basics/useful-to-know/import-and-export-formats.md) for more details.

{% hint style="info" %}
In most cases ':transgender\_symbol: Add > :open\_file\_folder: Add from folder(s)' should be the best option as it should be able to automatically detect most of the information needed by the file names.
{% endhint %}

{% hint style="warning" %}
You will **require cloth files (YDD & YTD) in order to continue**.\
\
We **suggest to** [**check out Forge Hub**](https://forge.plebmasters.de/hub/Cloth)**, our GTA V Content publishing platform**. It features lots of free clothes from amazing creators.
{% endhint %}

{% hint style="info" %}
Want to create or edit the model yourself? Start with [Blender and Sollumz Setup](https://docs.gta.clothing/cloth-modding/blender-and-sollumz-setup.md) and follow the [Complete Cloth Modding Walkthrough](https://docs.gta.clothing/cloth-modding/complete-walktrough.md). The exported YDD/YTD XML can be added to this project directly.
{% endhint %}

In our test we will continue by downloading a simple female dress by Quixotic on Forge Hub: <https://forge.plebmasters.de/hub/Cloth/1680/dione_dress>

When downloaded and extracted it should contain a bunch of YDD and YTD files like this.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-18267382465f38621636dd292fa688877da75673%2Fimage.png?alt=media" alt=""><figcaption><p>Downloaded and extracted cloth files</p></figcaption></figure>

As you can see these file names don't contain any gender / ped name, this is why we have to select any of the options from ":woman: **Add > Only female**". In this case we will choose ":woman: **Add > Only female >** :open\_file\_folder: **Add from folder(s)**".

{% hint style="info" %}
See our article about [Auto Cloth Data Resolving](https://docs.gta.clothing/basics/good-to-know/auto-cloth-data-resolving.md) to better understand how Durty Cloth Tool automatically helps you resolve cloth information.
{% endhint %}

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-70cafa6be8f1b85c3eac58d51532a791588094d9%2Fadd-clothes-from-folder.webp?alt=media" alt="Animation: in the Appearance Items list, Add opens its menu, Only female and then Add from folder(s) are chosen, and after the folder is picked a new female Top appears in the list with its eight texture variations in the item details."><figcaption><p>Adding female clothes from a folder with Add > Only female > Add from folder(s)</p></figcaption></figure>

{% hint style="info" %}
**When adding High Heels or Clothes that support the Cut Hairs option (Hats, Masks etc)** on the right side for hairs, you can read [High Heels](https://docs.gta.clothing/basics/essential-knowledge/high-heels.md) and [Cutting Hairs](https://docs.gta.clothing/basics/essential-knowledge/cutting-hairs.md) to find out how to configure these specifically.
{% endhint %}

{% hint style="info" %}
If you have licensed DCT Version you can **make full use of our 3D Preview feature** in order to see your added clothes in much more detail. See this article for more information: [3D Previewing Clothes](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md)
{% endhint %}

{% hint style="info" %}
**Your added clothes got a ❗** :bulb: **or other icon in front of it**? In this case Durty Cloth Tool automatically recognized an issue with the added cloth or has some useful information for you about it, see our article about [Cloth Analysis Report](https://docs.gta.clothing/basics/essential-knowledge/cloth-analysis-report.md) for more information.
{% endhint %}

## 3. Building your Cloth Project to a Cloth Resource

If you have finished adding clothes and made sure you are happy with the options, you can open the build window (or press **Ctrl+K** and paste `>Build project`) to generate your desired GTA 5 addon cloth resource output.

On the **Output and target** tab, choose the output folder of your addon pack, pick FiveM or single player under it and, for FiveM, the edition your server runs, then give your clothing collection a unique, short name. The **Build overview** on the right shows what the build will make before you start.

{% hint style="info" %}
See our article about [Build Options](https://docs.gta.clothing/basics/essential-knowledge/build-options.md) for more information.
{% endhint %}

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-63959fa1ba9ce2c22ae4ad45569b221399ed3848%2Fbuild-output-tab.png?alt=media" alt="The Build Project window on its Output tab, with the tabs Output, Target, Replacement, Advanced, Names and Tag rules, the build output folder, the clothes collection name forgestudio with an example file name, and the Build overview: FiveM Legacy, Addon collection, 10 clothes and one resource, forgestudio, with 10 drawables. The output folder and destination are blurred."><figcaption><p>The Build Project window: set up the build on the tabs on the left and check the Build overview on the right.</p></figcaption></figure>

Pressing **Build project** creates your addon cloth resource in the selected output folder. The Finished page then says what was built; **Open output folder** shows the files. From here on you can take these files and copy it to your desired server resources folder.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-4bca7b320228fab5690d9d0790ba1f120afc758d%2Fbuild-complete.png?alt=media" alt="The Build Project window after a successful build: Build complete, Built resource for FiveM Legacy, the collapsed Build steps, the Resources section open with one resource, forgestudio, with 10 drawables, Next steps, and the buttons Open output folder, Build again and Close."><figcaption><p>The Finished page after a successful build.</p></figcaption></figure>

## 4. Profit

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2FrToQ5XLGMp5EFHiCT8Ei%2F4c62b8664b2aa5d5c16e080936e52a88.gif?alt=media&amp;token=e922bed1-8cbb-4ce3-98f5-a15c6c4dcef5" alt=""><figcaption></figcaption></figure>

You just created your first GTA 5 addon cloth resource yaaayyy!

{% hint style="success" %}
**Make sure to always save your project** using **Project > Save**, so you can always continue working on your GTA 5 addon cloth pack by adding, removing or replacing files.
{% endhint %}

Lets continue by testing your newly created GTA 5 addon cloth resource! Click on one of the cards below to continue. See you there 🚀

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Test your addon clothes</strong></td><td>See how to easily test your Addon Clothes 🧪</td><td><a href="https://docs.gta.clothing/getting-started/testing-addon-clothes.md">Testing Addon Clothes</a></td></tr><tr><td><strong>Dig into DCT Essential Knowledge</strong></td><td>Learn how to benefit from our powerful features 👕</td><td><a href="https://docs.gta.clothing/basics/essential-knowledge.md">Essential Knowledge</a></td></tr><tr><td><strong>Dive deeper</strong></td><td>Discover GTA V clothing game mechanics</td><td><a href="https://docs.gta.clothing/game-mechanics/drawable-types-and-textures.md">Drawable Types &amp; Textures</a></td></tr></tbody></table>
