> 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/changelogs.md).

# Changelogs

Learn more about Current and Previous Releases of Durty Cloth Tool

## General Information

🔽Find the latest Version of Durty Cloth Tool on the [Official Website](https://gta.clothing).

👚Check out Pleb Masters: Forge if you are interested in retrieving file paths for modding GTA V clothes: <https://forge.plebmasters.de/clothes/>

🛟Join our discord for support: <https://discord.plebmasters.de>

📝Please consider **supporting me on Patreon to get access to a full license + support** for this tool: <https://www.patreon.com/plebmasters>

✅Also **visit our website** for more information: <https://gta.clothing>

## Durty Cloth Tool v4.0 (30.07.26)

{% hint style="info" %}
Durty Cloth Tool 4 rolled out over several releases. **v4.0.1** was the first stable v4 build, and **v4.0.3** brings everything below to the Release channel: it ships on the Experimental channel as 4.0.3-experimental.1 first, then as stable 4.0.3 from the same build. No stable v4.0.2 was released; the v4.0.2 builds were Experimental only. The highlights and full changelog below cover the whole v4 line, with the per release breakdown at the end.
{% endhint %}

{% hint style="warning" %}
Projects and item packages saved by Durty Cloth Tool 4 cannot be opened by older builds, which leave them closed and unchanged. Keep a backup if you may need to open a project in an older build. See [Durty Cloth Projects](https://docs.gta.clothing/basics/useful-to-know/durty-cloth-projects.md#project-format).
{% endhint %}

## ✨Update highlights

Durty Cloth Tool 4 is the largest release so far. Here are the parts worth knowing about. The full changelog below lists every change in one line each.

### ☁️ Cloud projects and GitHub sync

Keep projects in sync through DCT Cloud or GitHub, share them with a team and see other people's changes arrive while you work. See [Project Sync](https://docs.gta.clothing/share-and-sync/project-sync.md) and [Sync a Project with GitHub](https://docs.gta.clothing/share-and-sync/sync-a-project-with-github.md).

### 🎖️ Texture Studio

Edit cloth textures with pictures, text, patches, embroidery and badge finishes while the ped updates in 3D, and export layered PSD files and UV templates; the layers stay editable in the project. See [Texture Studio](https://docs.gta.clothing/basics/good-to-know/texture-studio.md).

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-a2c2b1efd44d052e044016c6b6906a19832f1910%2Ftexture-studio-layers.png?alt=media" alt="Texture Studio docked next to Item Details on the Top 002 Tshirt, with two Shoulder patch layers and a FORGE text layer. FORGE is selected on the back of the canvas with its handles and the Finish stage set to Vinyl, both patches sit on the front, and the 3D Preview shows FORGE across the back of the ped."><figcaption><p>Texture Studio on a T-shirt: a text layer on the back and two shoulder patches on the front, shown on the ped while you work.</p></figcaption></figure>

### 🧵 Model Studio (Experimental)

Sculpt, select, re-weight and fit clothing on the ped in one draft, see where the body comes through while you work, and save together with your Texture Studio edits. See [Model Studio (Experimental)](https://docs.gta.clothing/basics/good-to-know/model-studio.md).

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-914488221de8261c25954dc8f28ab87b4bb7cc80%2Fmodel-studio-docked.png?alt=media" alt="Model Studio with a hooded top on the ped and its editing controls around the view."><figcaption><p>Model Studio: edit the cloth and review its changes in the same workspace.</p></figcaption></figure>

### 🔌 Creator Link and live texture editing

Paint in Photoshop, Photopea, GIMP, Krita, PhotoCraft or Substance 3D Painter, model in Blender, or use any image editor, and see each change on the ped in DCT's 3D preview while you work. See [Creator Link Plugins](https://docs.gta.clothing/plugins/creator-link.md) and [Live Texture Editing / Preview](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#live-texture-editing-preview).

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-f1387180b8823ba8094376dc776fa3a260d7f9b1%2Flive-on-the-ped-krita.png?alt=media" alt="Krita with the Durty Cloth Tool docker showing Live on the ped and Unsaved in project while two orange stripes are painted on a burgundy hoodie texture, next to the 3D Preview of Durty Cloth Tool showing the same stripes on the ped."><figcaption><p>Paint in Krita and see every stroke on the ped in Durty Cloth Tool. Photoshop, Photopea, GIMP and Substance 3D Painter work the same way.</p></figcaption></figure>

### 🧍 Custom peds (Experimental)

Make clothing projects for custom addon peds and other game peds, turn a human character you made into a custom ped from Blender, and rig clothes to its own body. See [Custom Peds](https://docs.gta.clothing/custom-addon-peds/custom-peds.md) and [Create a Custom Ped Resource](https://docs.gta.clothing/custom-addon-peds/create-a-custom-ped-resource.md).

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-6dbdfbdedb9f28e2a0035220dbf997220faad366%2Fped-create.png?alt=media" alt="Create a custom ped project after reviewing the character in Blender."><figcaption><p>Create the project after reviewing your character.</p></figcaption></figure>

### 🪡 Fit and add clothing from Blender (Experimental)

Fit clothing from Marvelous Designer, CLO, FBX, OBJ or glTF to the freemode body with the Blender add-on's experimental Garment Fitting, make it game ready and add it to your project. See [Garment Fitting](https://docs.gta.clothing/plugins/creator-link/blender/garment-fitting.md) and [Add to a Durty Cloth Tool Project](https://docs.gta.clothing/plugins/creator-link/blender/add-to-a-project.md).

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-2739cc83924d51cf99b2f51a2230aab014bb2da4%2Fgarment-fit-view.png?alt=media" alt="Review a fitted cloth in the Blender add-on."><figcaption><p>Review the fitted cloth before preparing it for the project.</p></figcaption></figure>

### 📥 3D model import

Import clothing from GLB, glTF and Sims 4 packages, or FBX, OBJ, BLEND, DAE, STL and PLY through Blender, fit it on the freemode body and add it as drawables. See [3D model import (Experimental)](https://docs.gta.clothing/basics/useful-to-know/import-and-export-formats.md#id-3d-model-import-experimental).

### 🖋️ Tattoos and facial overlays

Tattoo designs place one image several times for either gender and any body part, you can place and preview them on the ped in 3D, and game facial overlays can be replaced. See [Tattoos & Overlays](https://docs.gta.clothing/tattoos-makeup-and-overlays/addon-tattoos.md) and [Facial Overlays & Makeup](https://docs.gta.clothing/tattoos-makeup-and-overlays/facial-overlays-and-makeup.md).

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-220b53aac34a3296f550ab9a9ae0e1c1182a93c5%2Ftattoo-edit-in-3d.png?alt=media" alt="Edit in 3D on a leg tattoo, with its move, turn and scale handles on the ped in the 3D Preview."><figcaption><p>Edit in 3D: drag, turn and scale a tattoo directly on the ped.</p></figcaption></figure>

### 🔍 In-game Clothing Inspector

FiveM builds can include the Clothing Inspector: try on every streamed cloth, tattoo and facial overlay in game, with thumbnails, limit warnings and a link back to DCT. See [Set Up the Clothing Inspector on Your FiveM Server](https://docs.gta.clothing/how-to-guides/set-up-the-clothing-inspector-on-your-fivem-server.md) and [Test Clothing In Game with the Clothing Inspector](https://docs.gta.clothing/how-to-guides/test-clothing-in-game-with-the-clothing-inspector.md).

### ⌨️ Command palette

Find any action, window, setting, item or texture variation from the search field in the menu bar or with Ctrl+K, with your pinned rows and what your selection can do listed first. See [Command palette](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#command-palette).

### 🎮 FiveM Enhanced and both editions

Build FiveM clothing for Legacy, Enhanced or both in one run, with the same clothing numbers in both folders. See [Build Clothing for FiveM Enhanced](https://docs.gta.clothing/how-to-guides/build-for-fivem-enhanced.md).

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-c31618be635819d3cb890fdf4a84890edb0af334%2Fenhanced-poster.webp?alt=media" alt="The Build Project window with the FiveM edition set to Enhanced."><figcaption><p>Select the FiveM edition.</p></figcaption></figure>

### 🕰️ Project History and the Findings and History tabs

Restore a whole project, one drawable or a texture variation after important edits, return to a named checkpoint in one click, and see each item's findings and past versions beside its settings. See [Project History](https://docs.gta.clothing/basics/useful-to-know/project-history.md) and [Findings and History tabs](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#findings-and-history-tabs).

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-a6cf7287de1edc424234a377a210c73b34ea0792%2Fhistory-poster.webp?alt=media" alt="Review project history and earlier changes."><figcaption><p>Review project history and earlier changes.</p></figcaption></figure>

### 🆓 What free projects and each license include

Free projects hold up to 30 drawables, 10 per type and gender, and now build without a license for every target except custom peds. Ultimate options stay visible but locked until you have Ultimate. See [Free, Advanced and Ultimate](https://docs.gta.clothing/getting-started/license-activation.md#free-advanced-and-ultimate).

### 🎁 Try Ultimate free for 7 days

Every Ultimate tool free for 7 days: start the trial from Home or when DCT asks you for a license, and nothing is charged if you turn renewal off before it ends. See [Try Ultimate free for 7 days](https://docs.gta.clothing/getting-started/license-activation.md#try-ultimate-free-for-7-days).

## v4 Full Changelog

Related improvements are grouped by feature so you can see what V4 offers in one place.

### Added

* **Cloud projects and GitHub sync**: Keep projects in sync through DCT Cloud or GitHub, share them with a team and see other people's changes arrive while you work. See [Project Sync](https://docs.gta.clothing/share-and-sync/project-sync.md) and [Sync a Project with GitHub](https://docs.gta.clothing/share-and-sync/sync-a-project-with-github.md).
* **Buy, upgrade and renew in the app**: Buy, upgrade or renew a license inside Durty Cloth Tool. It installs on this PC right away, so you can continue where you left off. See [Buying a License](https://docs.gta.clothing/getting-started/license-activation.md#buying-a-license).
* **Try Ultimate free for 7 days**: Every Ultimate tool free for 7 days: start the trial from Home or when DCT asks you for a license, and nothing is charged if you turn renewal off before it ends. See [Try Ultimate free for 7 days](https://docs.gta.clothing/getting-started/license-activation.md#try-ultimate-free-for-7-days).
* **Account, license and Discord sign-in**: Sign in with Discord to your Durty Cloth Tool account, manage your license and activate this PC from Account & License. See [License Activation](https://docs.gta.clothing/getting-started/license-activation.md).
* **Shared preview links**: Share a preview link: selected clothing or the outfit in the 3D Preview opens as a 3D page on gta.clothing that anyone with the link can view for 30 days. See [Share a Preview Link](https://docs.gta.clothing/how-to-guides/share-a-preview-link.md).
* **Home and Quick Look**: Home shows your projects, account, license and what is new at a glance, and Quick Look inspects clothing files without creating a project, also from the Explorer right-click menu. See [Home & Quick Look](https://docs.gta.clothing/basics/useful-to-know/home-and-quick-look.md).
* **First steps and sample project**: Home has first steps and a sample project: sign in, read the quickstart guide, then try adding, previewing, fixing and building six Forge Studios pieces before you use your own clothes. See [Home & Quick Look](https://docs.gta.clothing/basics/useful-to-know/home-and-quick-look.md).
* **Undo and redo in the editor**: Ctrl+Z undoes your latest change in the editor and Ctrl+Y redoes it: edits, moves, added or removed items, bulk edits, and repairs or optimizations with a restore point. See [Undo and redo in the editor](https://docs.gta.clothing/basics/useful-to-know/project-history.md#undo-and-redo-in-the-editor).
* **Command palette**: Find any action, window, setting, item or texture variation from the search field in the menu bar or with Ctrl+K, with your pinned rows and what your selection can do listed first. See [Command palette](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#command-palette).
* **Dockable workspace**: Arrange the editor, preview, findings and logs around your workflow. See [Workspace layout](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#workspace-layout) and [The docked workspace](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#the-docked-workspace).
* **Thumbnails, large previews, a thumbnail grid and text-only rows**: Browse clothing and variations with thumbnails and larger hover previews, as rows with large previews, as a thumbnail grid or as text-only rows. See [Cached previews inside the app](https://docs.gta.clothing/basics/good-to-know/thumbnails-and-exports.md#cached-previews-inside-the-app).
* **Filters, tags, sections and search**: Find clothing with filters, colour tags, saved presets, ranked search and one section per tag. See [Drawable Filters & Tags](https://docs.gta.clothing/basics/good-to-know/drawable-filters-and-tags.md) and [Integrated Search](https://docs.gta.clothing/basics/good-to-know/integrated-search.md).
* **Duplicate, reorder, rename and retype many items**: Duplicate clothing and props, drag several items into a new order or move them to a position number, rename many at once with find and replace, shuffle drawable order with a seed, and change the type of several drawables in one step. See [Find and replace names](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#find-and-replace-names), [Move to position](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#move-to-position) and [Items Position Number](https://docs.gta.clothing/basics/essential-knowledge/items-position-number.md).
* **Bulk metadata editing**: Apply shared metadata to a selection or a filtered project in one action. See [Bulk Metadata Editing](https://docs.gta.clothing/basics/good-to-know/bulk-metadata-editing.md).
* **Export credits and metadata**: Export the creators, store links and metadata of a whole pack or of a selection as a Markdown table for your README or as a CSV file for spreadsheets. See [Export credits for a README or a spreadsheet](https://docs.gta.clothing/basics/useful-to-know/creator-info.md#export-credits-for-a-readme-or-a-spreadsheet).
* **Custom keyboard shortcuts**: Assign or change shortcuts for menu actions and preview controls in Options. See [Customizing shortcuts](https://docs.gta.clothing/basics/useful-to-know/shortcuts.md#customizing-shortcuts).
* **Fourteen interface languages**: Use Durty Cloth Tool in fourteen languages, now also Italian, Polish, Turkish, Indonesian and Thai, with its plugins and gta.clothing following your choice. See [App & Project Settings](https://docs.gta.clothing/basics/good-to-know/app-and-project-settings.md).
* **Cloth physics and wind**: Preview YLD cloth movement with animation and adjustable wind, and keep a YLD XML companion with its clothing in packages and builds. See [Cloth physics (YLD)](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#cloth-physics-yld) and [Creating Cloth Physics (YLD)](https://docs.gta.clothing/cloth-modding/cloth-physics-yld.md).
* **Outfits on the 3D Preview ped**: Try several clothes together, switch any slot of the ped to game clothes, props or project items on the Outfit tab, save what the ped wears as named outfits in the project, and load a Menyoo character. See [Outfit tab](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#outfit-tab).
* **Body Presets and ped profiles**: Save the body parts and skeleton your clothing needs as reusable Body Presets or per-cloth profiles, so the 3D preview shows it on the right body. See [Custom Ped Preview Support](https://docs.gta.clothing/basics/good-to-know/custom-ped-preview.md).
* **Check clipping in poses**: See where the body comes through a cloth in game poses such as raised arms, sitting and kneeling, with the worst moment marked in 3D and an experimental fix. See [Check clipping in poses](https://docs.gta.clothing/how-to-guides/optimize-clothing-models-and-textures.md#check-clipping-in-poses).
* **Texture Studio**: Edit cloth textures with pictures, text, patches, embroidery and badge finishes while the ped updates in 3D, and export layered PSD files and UV templates; the layers stay editable in the project. See [Texture Studio](https://docs.gta.clothing/basics/good-to-know/texture-studio.md).
* **Painting, selections and logos across seams**: Texture Studio paints with a brush, an eraser and two fills, on the canvas or straight onto the ped, picks colours with an eyedropper, keeps strokes inside a selection, and wraps a logo across UV seams. See [Paint](https://docs.gta.clothing/basics/good-to-know/texture-studio.md#paint).
* **Fabric bases, wear and a material shelf**: Texture Studio covers a cloth with knit, twill, canvas, leather, denim, camouflage and other fabric bases, adds worn edges and dirt that follow its shape, and keeps logos and designs on a shelf for every project. See [Fabric bases](https://docs.gta.clothing/basics/good-to-know/texture-studio.md#fabric-bases) and [The material shelf](https://docs.gta.clothing/basics/good-to-know/texture-studio.md#the-material-shelf).
* **Model Studio (Experimental)**: Sculpt, select, re-weight and fit clothing on the ped in one draft, see where the body comes through while you work, and save together with your Texture Studio edits. See [Model Studio (Experimental)](https://docs.gta.clothing/basics/good-to-know/model-studio.md).
* **Creator Link and live texture editing**: Paint in Photoshop, Photopea, GIMP, Krita, PhotoCraft or Substance 3D Painter, model in Blender, or use any image editor, and see each change on the ped in DCT's 3D preview while you work. See [Creator Link Plugins](https://docs.gta.clothing/plugins/creator-link.md) and [Live Texture Editing / Preview](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#live-texture-editing-preview).
* **Recolour textures and colourways**: Give a texture variation a new colour with a live 3D view, or add several colours or a whole palette as separate variations in one run. See [Recolour a texture variation](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#recolour-a-texture-variation).
* **Compare textures side by side**: Compare two variations, a finding against its earlier version, or a Texture Optimizer run's before and after, with linked zoom and pan. See [Compare textures](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#compare-textures).
* **Tattoos and facial overlays**: Tattoo designs place one image several times for either gender and any body part, you can place and preview them on the ped in 3D, and game facial overlays can be replaced. See [Tattoos & Overlays](https://docs.gta.clothing/tattoos-makeup-and-overlays/addon-tattoos.md) and [Facial Overlays & Makeup](https://docs.gta.clothing/tattoos-makeup-and-overlays/facial-overlays-and-makeup.md).
* **Fit and add clothing from Blender (Experimental)**: Fit clothing from Marvelous Designer, CLO, FBX, OBJ or glTF to the freemode body with the Blender add-on's experimental Garment Fitting, make it game ready and add it to your project. See [Garment Fitting](https://docs.gta.clothing/plugins/creator-link/blender/garment-fitting.md) and [Add to a Durty Cloth Tool Project](https://docs.gta.clothing/plugins/creator-link/blender/add-to-a-project.md).
* **Fit clothing to custom bodies (Experimental)**: Fit to Body (Experimental) creates fitted clothing copies for a project body preset, selected Torso and legs or a custom ped's own body, with adjustable fit and animated review. See [Fit clothing to a custom body (Experimental)](https://docs.gta.clothing/basics/good-to-know/custom-ped-preview.md#fit-clothing-to-a-custom-body-experimental).
* **Fit, retarget and merge clothing in 3D**: Fit and retarget existing clothing in 3D, or merge up to four compatible clothing models into a new item, with experimental Ultimate tools. See [Fit or combine existing clothing (Experimental)](https://docs.gta.clothing/how-to-guides/optimize-clothing-models-and-textures.md#fit-or-combine-existing-clothing-experimental).
* **Custom peds (Experimental)**: Make clothing projects for custom addon peds and other game peds, turn a human character you made into a custom ped from Blender, and rig clothes to its own body. See [Custom Peds](https://docs.gta.clothing/custom-addon-peds/custom-peds.md) and [Create a Custom Ped Resource](https://docs.gta.clothing/custom-addon-peds/create-a-custom-ped-resource.md).
* **3D model import**: Import clothing from GLB, glTF and Sims 4 packages, or FBX, OBJ, BLEND, DAE, STL and PLY through Blender, fit it on the freemode body and add it as drawables. See [3D model import (Experimental)](https://docs.gta.clothing/basics/useful-to-know/import-and-export-formats.md#id-3d-model-import-experimental).
* **Add built resources, zips and folders**: Bring existing clothing packs, projects, exports, zips and folders of resources into your project after reviewing them, with every model and texture they hold. See [Importing from a built resource](https://docs.gta.clothing/basics/useful-to-know/import-and-export-formats.md#importing-from-a-built-resource).
* **Find and remove duplicates**: Review identical clothing and texture variations, and the same model saved in different files, side by side, then remove, merge or keep them, or delete a suggested merge instead. See [Handling Duplicate Clothing Automatically](https://docs.gta.clothing/basics/essential-knowledge/cloth-analysis-report.md#handling-duplicate-clothing-automatically).
* **Find missing files**: Find a project's missing model and texture files in any folder and copy them back, or remove the drawables that lost their files in one undoable step. See [Missing files](https://docs.gta.clothing/basics/essential-knowledge/cloth-analysis-report.md#missing-files) and [Missing Files](https://docs.gta.clothing/basics/useful-to-know/durty-cloth-projects.md#missing-files).
* **Fix safe findings**: Fix safe findings in the Error List repairs every finding that keeps the look, such as missing mip maps, on all drawables at once under one restore point. See [Fix safe findings](https://docs.gta.clothing/basics/essential-knowledge/cloth-analysis-report.md#fix-safe-findings).
* **Heels, hat hair cuts and rig repairs**: Set high heel heights and hat hair cuts automatically, and repair heels, cuttable hair and some broken freemode rigs with visual guidance. See [High Heels](https://docs.gta.clothing/basics/essential-knowledge/high-heels.md), [Cutting Hairs](https://docs.gta.clothing/basics/essential-knowledge/cutting-hairs.md) and [Rigging and Weight Painting](https://docs.gta.clothing/cloth-modding/rigging-and-weight-painting.md).
* **Model Optimizer**: Reduce clothing polygons and generate missing LODs with a before-and-after preview. See [Model Optimizer](https://docs.gta.clothing/basics/essential-knowledge/model-optimizer.md).
* **Texture Optimizer and UV space**: Review and optimize texture sizes, compression and mip maps for clothing, tattoo designs and facial overlays, and reduce texture space wasted around the parts your clothing uses. See [Texture Optimizer](https://docs.gta.clothing/basics/essential-knowledge/texture-optimizer.md).
* **Normal and specular map generation**: Create missing normal and specular maps for supported clothing. See [Normal & Specular Maps](https://docs.gta.clothing/basics/good-to-know/normal-and-specular-maps.md).
* **Thumbnail and image exports**: Generate clothing images for one item or a whole project, then sync changes to a folder. See [Thumbnail Generator](https://docs.gta.clothing/basics/good-to-know/thumbnails-and-exports.md#thumbnail-generator) and [Generate Thumbnails for a Whole Project](https://docs.gta.clothing/how-to-guides/generate-thumbnails-for-a-project.md).
* **GLB export**: Export clothing as GLB models for use outside DCT, with all texture variations of a drawable in one file as colours you switch between. See [GLB export](https://docs.gta.clothing/basics/good-to-know/thumbnails-and-exports.md#glb-export).
* **Written files are checked before they replace your output**: Every build reads back the files it wrote before they replace your previous output, and a problem keeps the previous output and names the file. See [Build Button](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#build-button).
* **Build without saving a project**: Build a new project without saving it first: add clothes and press Build, and the Build window suggests the resource name and output folder. See [Build without saving the project first](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#build-without-saving-the-project-first).
* **Build without items that have errors**: When a few items have errors, a build can leave them out for this build only, so the rest of a large pack still builds. See [Build Button](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#build-button) and [Review and Tune Project Findings](https://docs.gta.clothing/how-to-guides/review-and-tune-project-findings.md).
* **What changed since the last build**: See what changed since your last build: the Build window lists added, changed, removed and moved clothing, and the item list marks it. See [Build Button](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#build-button).
* **FiveM Enhanced and both editions**: Build FiveM clothing for Legacy, Enhanced or both in one run, with the same clothing numbers in both folders. See [Build Clothing for FiveM Enhanced](https://docs.gta.clothing/how-to-guides/build-for-fivem-enhanced.md).
* **A question before add-on clothing for FiveM Enhanced**: Building add-on clothing for FiveM Enhanced asks first and says what Cfx's fix of 11 November 2026 needs on the server. See [Build Clothing for FiveM Enhanced](https://docs.gta.clothing/how-to-guides/build-for-fivem-enhanced.md).
* **Clothing YMT limits, 128 drawables and server checks**: Choose whether FiveM Legacy packs use FiveM's raised limit on clothing YMT files, see how many YMT slots a Singleplayer pack takes, limit every drawable type to 128 per resource, and check a server's resources folder for combined clothing limits. See [Game Limits and Crashes](https://docs.gta.clothing/game-mechanics/game-limits-and-crashes.md) and [FiveM server resources](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#fivem-server-resources).
* **Automatic resource splitting**: Build large projects as several coordinated resources when one pack is not enough, and choose how the extra resources and stream folders are named. See [Automatic Resource Splitting](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#automatic-resource-splitting) and [Build and Manage Large Clothing Resources](https://docs.gta.clothing/how-to-guides/build-large-clothing-resources.md).
* **Replacement packs**: Replace a known DLC, base-game clothing or a named collection for each generated pack, and see slot by slot what changes in game. See [Pack Replacements (Advanced)](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#pack-replacements-advanced).
* **Asset Escrow clothing**: Organize clothing from several Asset Escrow resources in one FiveM project, and keep your own uploads under the size limit with escrow-ready output. See [Work with Asset Escrow Clothing](https://docs.gta.clothing/how-to-guides/use-asset-escrow-clothing.md).
* **In-game Clothing Inspector**: FiveM builds can include the Clothing Inspector: try on every streamed cloth, tattoo and facial overlay in game, with thumbnails, limit warnings and a link back to DCT. See [Set Up the Clothing Inspector on Your FiveM Server](https://docs.gta.clothing/how-to-guides/set-up-the-clothing-inspector-on-your-fivem-server.md) and [Test Clothing In Game with the Clothing Inspector](https://docs.gta.clothing/how-to-guides/test-clothing-in-game-with-the-clothing-inspector.md).
* **Shop labels, prices and outfit metadata**: Give drawables and texture variations a shop label, and set prices and forced or variant outfit items per texture variation. See [Shop Meta File](https://docs.gta.clothing/game-mechanics/shop-meta-file.md).
* **Project History and the Findings and History tabs**: Restore a whole project, one drawable or a texture variation after important edits, return to a named checkpoint in one click, and see each item's findings and past versions beside its settings. See [Project History](https://docs.gta.clothing/basics/useful-to-know/project-history.md) and [Findings and History tabs](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#findings-and-history-tabs).
* **Updates and What's New**: Choose Release or Experimental, review changes and follow download progress inside DCT. See [Updates & Channels](https://docs.gta.clothing/basics/good-to-know/updates-and-channels.md).
* **Settings and license come along from V3**: When you update from V3, your settings and license come along to V4. See [Updating from V3](https://docs.gta.clothing/getting-started/updating-from-v3.md).
* **Feedback, error reports and usage data**: Send feedback from the editor's top bar, the Help menu or Home, add details to automatic error reports, and know that DCT shares usage data, which you can switch off in Options. See [Usage Data & Feedback](https://docs.gta.clothing/basics/good-to-know/usage-data-and-feedback.md) and [Send feedback](https://docs.gta.clothing/basics/useful-to-know/logs.md#send-feedback).
* **Settings other creators used**: Tools can suggest the settings other creators used on the same kind of cloth, and DCT shares the settings you accept while signed in, which you can switch off in Options. See [Shared Tool Settings](https://docs.gta.clothing/basics/good-to-know/shared-tool-settings.md).

### Improved

* **License marks and hiding tools you lack**: Paid tools carry a crown for Ultimate or a key for any license while your plan lacks them, and Options > Menus and tools can hide Ultimate tools and tidy the right-click menus. See [App & Project Settings](https://docs.gta.clothing/basics/good-to-know/app-and-project-settings.md).
* **Item list, Item Details and notes**: The item list shows a male and female switch with counts, what stops the build and each model's triangles, Item Details is organized around the item's name and actions, and items can carry a note. See [Main Workspace Area](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#main-workspace-area) and [Behaviour Flags](https://docs.gta.clothing/game-mechanics/behaviour-flags.md#how-to-set-behaviour-flags-in-durty-cloth-tool).
* **One Add menu, a Tools menu and a project summary**: One Add menu with the gender inside it, a Tools menu for the project tools, new tattoos placed in 3D on the ped, and a status bar that shows what the project holds. See [User Interface](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md) and [Tools Menu](https://docs.gta.clothing/basics/useful-to-know/durty-cloth-projects.md#tools-menu).
* **3D Preview camera, controls and lighting**: Frame clothes easily from the front, back or a side, check UVs with a checker, test them with more animations, and switch floor, wireframe, auto rotate and lighting with one click; Preview tools can move into their own window. See [Camera and framing](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#camera-and-framing) and [Scene](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#scene).
* **Materials, fabric looks and less body clipping in the 3D Preview**: Inspect hair, fur, see-through clothing and skin tones more faithfully, try one-click fabric looks such as Rain-soaked or Muddy, and hide skin poking through clothes while you look. See [Material simulation](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#material-simulation) and [Reduce body clipping in preview](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#reduce-body-clipping-in-preview).
* **Rigging, import fitting and pose checks online**: Rig to freemode body, import fitting, pose checks and custom ped rigging work while you are signed in and online; automatic rig repairs and the pose check need no GTA V installation. See [Internet access for paid tools](https://docs.gta.clothing/getting-started/license-activation.md#internet-access-for-paid-tools) and [Rigging and Weight Painting](https://docs.gta.clothing/cloth-modding/rigging-and-weight-painting.md).
* **Tools explain themselves and say why a button is greyed out**: 3D tools say what they do, with an example and their controls, and a greyed-out button says what to do first, next to it and when you point at it. See [Tattoos and facial overlays](https://docs.gta.clothing/tattoos-makeup-and-overlays/addon-tattoos.md), [Rigging and Weight Painting](https://docs.gta.clothing/cloth-modding/rigging-and-weight-painting.md), [3D model import](https://docs.gta.clothing/basics/useful-to-know/import-and-export-formats.md#id-3d-model-import-experimental) and [Model Studio (Experimental)](https://docs.gta.clothing/basics/good-to-know/model-studio.md).
* **Adding clothing files**: Add clothes, packages, projects, exports and built resources from files or folders with one review, including models with embedded textures. See [Adding clothing files and folders](https://docs.gta.clothing/basics/useful-to-know/import-and-export-formats.md#adding-clothing-files-and-folders) and [Auto Cloth Data Resolving](https://docs.gta.clothing/basics/good-to-know/auto-cloth-data-resolving.md).
* **Clothing checks and their fixes**: Find more clothing problems, each with what it means in game and a direct fix, and repair dark or patchy shading inside DCT with Clean up model. See [Cloth Analysis Report](https://docs.gta.clothing/basics/essential-knowledge/cloth-analysis-report.md) and [Review and Tune Project Findings](https://docs.gta.clothing/how-to-guides/review-and-tune-project-findings.md).
* **Error List and Project logs**: Search, filter, copy and export findings and project logs, jump to the clothing they name, and ignore reviewed exceptions. See [The Error List Window](https://docs.gta.clothing/basics/essential-knowledge/cloth-analysis-report.md#the-error-list-window) and [Logs](https://docs.gta.clothing/basics/useful-to-know/logs.md).
* **Optimizers and settings in plain words**: The optimizers open with a few plain answers, such as fitting the triangle budget, and the optimizers, the Material Editor, Options and Project settings say in plain words what they change and when they can change the look. See [Plain answers or all options](https://docs.gta.clothing/basics/essential-knowledge/model-optimizer.md#plain-answers-or-all-options) and [Optimizing Clothes](https://docs.gta.clothing/basics/essential-knowledge/optimizing-clothes.md).
* **Calmer Options, dialogs and notices**: Options and Project Settings share one calm layout, questions and messages say what their buttons do, and notices stay with DCT instead of floating over other programs. See [App & Project Settings](https://docs.gta.clothing/basics/good-to-know/app-and-project-settings.md) and [Notices and dialogs](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#notices-and-dialogs).
* **Build Project**: Review the target, destination and resources before building, see what each target makes and how files will be named, and keep your output folder safe. See [Build Options](https://docs.gta.clothing/basics/essential-knowledge/build-options.md).
* **Legacy multiplayer targets**: alt:V and RageMP builders are marked as deprecated. See [Target Resource Type](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#target-resource-type).
* **Saving in the background, with recovery**: Project > Save and Ctrl+S save in the background while you keep working, and a failed save keeps your changes and offers a way out. See [Automatic Backup Save System](https://docs.gta.clothing/basics/useful-to-know/durty-cloth-projects.md#automatic-backup-save-system).
* **Large-project performance**: Start, open, import, browse, save, rebuild and optimize large projects with less waiting. See [Durty Cloth Projects](https://docs.gta.clothing/basics/useful-to-know/durty-cloth-projects.md).

### Fixed

* **AltGr characters in text boxes**: Typing a character that needs AltGr in a text box, such as € on a German keyboard or ą and ł on a Polish one, no longer runs a Ctrl+Alt shortcut like the Error List. See [Shortcuts](https://docs.gta.clothing/basics/useful-to-know/shortcuts.md).
* **Replace packs: heels, hat hair and Gunrunning**: Heels and hat hair options in FiveM replace packs also work on shoes and hats past Rockstar's own count, and a pack that replaces Gunrunning replaces its clothing collection, not its hair collection. See [Pack Replacements (Advanced)](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#pack-replacements-advanced) and [High Heels](https://docs.gta.clothing/basics/essential-knowledge/high-heels.md).
* **Your own hairs under masks and hoods outside FiveM**: Singleplayer, alt:V and RageMP packs switch your own hairs under your own masks and hooded tops, within what the game can handle, and the 3D Preview shows a hair's mask or hood model only where the game will. See [Cutting Hairs](https://docs.gta.clothing/basics/essential-knowledge/cutting-hairs.md).
* **Models with same-named embedded textures**: Export as XML works again for models that embed two textures under the same name, and the Embedded Textures editor keeps every name unique. See [Embedded Textures Editor](https://docs.gta.clothing/basics/good-to-know/embedded-textures-editor.md).
* **An Ultimate license locked to another PC**: Account & License names an Ultimate license locked to another PC and links a support ticket to have it moved here, instead of offering to buy Ultimate again. See [Move your license to another PC](https://docs.gta.clothing/getting-started/license-activation.md#move-your-license-to-another-pc).
* **Add texture in Item Details**: Add and Add dummy under a drawable's textures in Item Details add a texture again; they did nothing, and only Ctrl+Shift+T or drag and drop added one. See [Main Workspace Area](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#main-workspace-area).
* **Auto-hidden 3D Preview stays shut**: An auto-hidden (unpinned) 3D Preview no longer slides open over Item Details and shuts again on its own; it opens when you click its tab or use 3D Preview. See [Workspace layout](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#workspace-layout).
* **XML import of DDS files with a shorter mip chain**: XML drawables and textures import again when a DDS lists more mip levels than it holds, by Add, drag and drop or from a connected app, instead of failing as an unsupported format. See [Adding clothing files and folders](https://docs.gta.clothing/basics/useful-to-know/import-and-export-formats.md#adding-clothing-files-and-folders).
* **License stays locked to the same PC**: A license activated in DCT stays locked to the PC it was activated on, instead of sometimes reading as locked to another device on the same PC. See [Why is my license locked to one PC?](https://docs.gta.clothing/getting-started/license-activation.md#why-is-my-license-locked-to-one-pc).

### Breaking

* **Files open in this version or a newer one**: Projects, item packages, exports and saved materials made with this version open only in this version or a newer one. See [Project Format](https://docs.gta.clothing/basics/useful-to-know/durty-cloth-projects.md#project-format).
* **What free projects and each license include**: Free projects hold up to 30 drawables, 10 per type and gender, and now build without a license for every target except custom peds. Ultimate options stay visible but locked until you have Ultimate. See [Free, Advanced and Ultimate](https://docs.gta.clothing/getting-started/license-activation.md#free-advanced-and-ultimate).

#### v4.0.1

```markdown
The first stable Durty Cloth Tool 4 release.

- Release and Experimental update channels, in-app release notes and launcher recovery to Release
- Installers, portable downloads and in-app updates from one protected public update service, with signature-checked metadata and hash-verified packages
- Settings, update state and licenses kept outside replaceable application files
- Cached clothing and texture thumbnails with larger hover previews
- GLB model export and still image rendering of clothing variations
- Camera autofocus, skin-tone overlays and cropped screenshots in the 3D Preview
- YLD XML component mesh-physics support
- Projects from a newer DCT format rejected before migration, autosave or rewriting
- Installer shortcut, launcher startup and licensed startup fixes
```

#### v4.0.3

The first stable release since v4.0.1. It ships on the Experimental channel as 4.0.3-experimental.1 first, then as stable 4.0.3 from the same build; the v4.0.2 Experimental builds led up to it. Everything since v4.0.1, in the groups of the full changelog above:

* **Added**: [Cloud projects and GitHub sync](https://docs.gta.clothing/share-and-sync/project-sync.md), [Buy, upgrade and renew in the app](https://docs.gta.clothing/getting-started/license-activation.md#buying-a-license), [Try Ultimate free for 7 days](https://docs.gta.clothing/getting-started/license-activation.md#try-ultimate-free-for-7-days), [Account, license and Discord sign-in](https://docs.gta.clothing/getting-started/license-activation.md), [Shared preview links](https://docs.gta.clothing/how-to-guides/share-a-preview-link.md), [Home and Quick Look](https://docs.gta.clothing/basics/useful-to-know/home-and-quick-look.md), [First steps and sample project](https://docs.gta.clothing/basics/useful-to-know/home-and-quick-look.md), [Undo and redo in the editor](https://docs.gta.clothing/basics/useful-to-know/project-history.md#undo-and-redo-in-the-editor), [Command palette](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#command-palette), [Dockable workspace](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#workspace-layout), [Thumbnails, large previews, a thumbnail grid and text-only rows](https://docs.gta.clothing/basics/good-to-know/thumbnails-and-exports.md#cached-previews-inside-the-app), [Filters, tags, sections and search](https://docs.gta.clothing/basics/good-to-know/drawable-filters-and-tags.md), [Duplicate, reorder, rename and retype many items](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#find-and-replace-names), [Bulk metadata editing](https://docs.gta.clothing/basics/good-to-know/bulk-metadata-editing.md), [Export credits and metadata](https://docs.gta.clothing/basics/useful-to-know/creator-info.md#export-credits-for-a-readme-or-a-spreadsheet), [Custom keyboard shortcuts](https://docs.gta.clothing/basics/useful-to-know/shortcuts.md#customizing-shortcuts), [Fourteen interface languages](https://docs.gta.clothing/basics/good-to-know/app-and-project-settings.md), [Cloth physics and wind](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#cloth-physics-yld), [Outfits on the 3D Preview ped](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#outfit-tab), [Body Presets and ped profiles](https://docs.gta.clothing/basics/good-to-know/custom-ped-preview.md), [Check clipping in poses](https://docs.gta.clothing/how-to-guides/optimize-clothing-models-and-textures.md#check-clipping-in-poses), [Texture Studio](https://docs.gta.clothing/basics/good-to-know/texture-studio.md), [Painting, selections and logos across seams](https://docs.gta.clothing/basics/good-to-know/texture-studio.md#paint), [Fabric bases, wear and a material shelf](https://docs.gta.clothing/basics/good-to-know/texture-studio.md#fabric-bases), [Model Studio (Experimental)](https://docs.gta.clothing/basics/good-to-know/model-studio.md), [Creator Link and live texture editing](https://docs.gta.clothing/plugins/creator-link.md), [Recolour textures and colourways](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#recolour-a-texture-variation), [Compare textures side by side](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#compare-textures), [Tattoos and facial overlays](https://docs.gta.clothing/tattoos-makeup-and-overlays/addon-tattoos.md), [Fit and add clothing from Blender (Experimental)](https://docs.gta.clothing/plugins/creator-link/blender/garment-fitting.md), [Fit clothing to custom bodies (Experimental)](https://docs.gta.clothing/basics/good-to-know/custom-ped-preview.md#fit-clothing-to-a-custom-body-experimental), [Fit, retarget and merge clothing in 3D](https://docs.gta.clothing/how-to-guides/optimize-clothing-models-and-textures.md#fit-or-combine-existing-clothing-experimental), [Custom peds (Experimental)](https://docs.gta.clothing/custom-addon-peds/custom-peds.md), [3D model import](https://docs.gta.clothing/basics/useful-to-know/import-and-export-formats.md#id-3d-model-import-experimental), [Add built resources, zips and folders](https://docs.gta.clothing/basics/useful-to-know/import-and-export-formats.md#importing-from-a-built-resource), [Find and remove duplicates](https://docs.gta.clothing/basics/essential-knowledge/cloth-analysis-report.md#handling-duplicate-clothing-automatically), [Find missing files](https://docs.gta.clothing/basics/essential-knowledge/cloth-analysis-report.md#missing-files), [Fix safe findings](https://docs.gta.clothing/basics/essential-knowledge/cloth-analysis-report.md#fix-safe-findings), [Heels, hat hair cuts and rig repairs](https://docs.gta.clothing/basics/essential-knowledge/high-heels.md), [Model Optimizer](https://docs.gta.clothing/basics/essential-knowledge/model-optimizer.md), [Texture Optimizer and UV space](https://docs.gta.clothing/basics/essential-knowledge/texture-optimizer.md), [Normal and specular map generation](https://docs.gta.clothing/basics/good-to-know/normal-and-specular-maps.md), [Thumbnail and image exports](https://docs.gta.clothing/basics/good-to-know/thumbnails-and-exports.md#thumbnail-generator), [GLB export](https://docs.gta.clothing/basics/good-to-know/thumbnails-and-exports.md#glb-export), [Written files are checked before they replace your output](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#build-button), [Build without saving a project](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#build-without-saving-the-project-first), [Build without items that have errors](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#build-button), [What changed since the last build](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#build-button), [FiveM Enhanced and both editions](https://docs.gta.clothing/how-to-guides/build-for-fivem-enhanced.md), [A question before add-on clothing for FiveM Enhanced](https://docs.gta.clothing/how-to-guides/build-for-fivem-enhanced.md), [Clothing YMT limits, 128 drawables and server checks](https://docs.gta.clothing/game-mechanics/game-limits-and-crashes.md), [Automatic resource splitting](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#automatic-resource-splitting), [Replacement packs](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#pack-replacements-advanced), [Asset Escrow clothing](https://docs.gta.clothing/how-to-guides/use-asset-escrow-clothing.md), [In-game Clothing Inspector](https://docs.gta.clothing/how-to-guides/set-up-the-clothing-inspector-on-your-fivem-server.md), [Shop labels, prices and outfit metadata](https://docs.gta.clothing/game-mechanics/shop-meta-file.md), [Project History and the Findings and History tabs](https://docs.gta.clothing/basics/useful-to-know/project-history.md), [Updates and What's New](https://docs.gta.clothing/basics/good-to-know/updates-and-channels.md), [Settings and license come along from V3](https://docs.gta.clothing/getting-started/updating-from-v3.md), [Feedback, error reports and usage data](https://docs.gta.clothing/basics/good-to-know/usage-data-and-feedback.md), [Settings other creators used](https://docs.gta.clothing/basics/good-to-know/shared-tool-settings.md).
* **Improved**: [License marks and hiding tools you lack](https://docs.gta.clothing/basics/good-to-know/app-and-project-settings.md), [Item list, Item Details and notes](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#main-workspace-area), [One Add menu, a Tools menu and a project summary](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md), [3D Preview camera, controls and lighting](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#camera-and-framing), [Materials, fabric looks and less body clipping in the 3D Preview](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#material-simulation), [Rigging, import fitting and pose checks online](https://docs.gta.clothing/getting-started/license-activation.md#internet-access-for-paid-tools), [Tools explain themselves and say why a button is greyed out](https://docs.gta.clothing/tattoos-makeup-and-overlays/addon-tattoos.md), [Adding clothing files](https://docs.gta.clothing/basics/useful-to-know/import-and-export-formats.md#adding-clothing-files-and-folders), [Clothing checks and their fixes](https://docs.gta.clothing/basics/essential-knowledge/cloth-analysis-report.md), [Error List and Project logs](https://docs.gta.clothing/basics/essential-knowledge/cloth-analysis-report.md#the-error-list-window), [Optimizers and settings in plain words](https://docs.gta.clothing/basics/essential-knowledge/model-optimizer.md#plain-answers-or-all-options), [Calmer Options, dialogs and notices](https://docs.gta.clothing/basics/good-to-know/app-and-project-settings.md), [Build Project](https://docs.gta.clothing/basics/essential-knowledge/build-options.md), [Legacy multiplayer targets](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#target-resource-type), [Saving in the background, with recovery](https://docs.gta.clothing/basics/useful-to-know/durty-cloth-projects.md#automatic-backup-save-system), [Large-project performance](https://docs.gta.clothing/basics/useful-to-know/durty-cloth-projects.md).
* **Fixed**: [AltGr characters in text boxes](https://docs.gta.clothing/basics/useful-to-know/shortcuts.md), [Replace packs: heels, hat hair and Gunrunning](https://docs.gta.clothing/basics/essential-knowledge/build-options.md#pack-replacements-advanced), [Your own hairs under masks and hoods outside FiveM](https://docs.gta.clothing/basics/essential-knowledge/cutting-hairs.md), [Models with same-named embedded textures](https://docs.gta.clothing/basics/good-to-know/embedded-textures-editor.md), [An Ultimate license locked to another PC](https://docs.gta.clothing/getting-started/license-activation.md#move-your-license-to-another-pc), [Add texture in Item Details](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#main-workspace-area), [Auto-hidden 3D Preview stays shut](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#workspace-layout), [XML import of DDS files with a shorter mip chain](https://docs.gta.clothing/basics/useful-to-know/import-and-export-formats.md#adding-clothing-files-and-folders), [License stays locked to the same PC](https://docs.gta.clothing/getting-started/license-activation.md#why-is-my-license-locked-to-one-pc).
* **Breaking**: [Files open in this version or a newer one](https://docs.gta.clothing/basics/useful-to-know/durty-cloth-projects.md#project-format), [What free projects and each license include](https://docs.gta.clothing/getting-started/license-activation.md#free-advanced-and-ultimate).

{% hint style="warning" %}
Experimental builds get features before they have been through a full release. A project or item package saved by an Experimental build may not open in an older or Release build, so keep a backup before you try one.
{% endhint %}

## Durty Cloth Tool v3.2.0 (20.08.25)

## ✨Update highlights

This update contains many quality‑of‑life improvements and bug fixes. Let’s focus on the highlights:

### 🎨 Material Editor

Edit shaders and material parameters directly on your drawable and save changes instantly.

{% hint style="info" %}
See [Material Editor](https://docs.gta.clothing/basics/good-to-know/material-editor.md) documentation.
{% endhint %}

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2FeiqwRlSQ6NaH03Qy6Ypd%2FDCTv3.2MaterialEditor.gif?alt=media&amp;token=79092b88-72c1-4427-8cb3-40d1176b1058" alt=""><figcaption><p>Durty Cloth Tool Material Editor Demo</p></figcaption></figure>

### 🧵 Embedded Textures Editor

Inspect, export, rename, replace or delete embedded textures. Auto‑fix shader params when names/usages change.

{% hint style="info" %}
See [Embedded Textures Editor](https://docs.gta.clothing/basics/good-to-know/embedded-textures-editor.md) documentation.
{% endhint %}

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2F89DjOVV6n4wuuq2P6yfW%2FDCTv3.2-EmbeddedTexturesEditor.gif?alt=media&amp;token=c3b789a3-0e2a-4f56-83f6-49f9d41d2548" alt=""><figcaption><p>Durty Cloth Tool Embedded Textures Editor Demo</p></figcaption></figure>

### 🖼️ Live Texture Editing / Previewing

Select a target slot (Diffuse, Specular, Normal) and a watch folder. Drop an updated DDS into that folder to instantly see the change in the 3D Preview.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2FQB4gMKkVfqLeYU4BL53n%2FLiveTexturesEditing.gif?alt=media&amp;token=28f06163-7cef-42ea-b675-4912d82e58a5" alt=""><figcaption><p>Durty Cloth Tool Live Texture Editing / Previewing Demo</p></figcaption></figure>

### 🧪 Optimizer improvements and options

Quickly identify unoptimized textures with a new preview, plus apply new auto‑fixes:

* Fix unused embedded textures
* Fix wrongly named embedded textures
* Fix invalid diffuse sampler

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2FVxelPJPHcH3Dwp5Hf71h%2Foptimizer-window.png?alt=media&amp;token=4cb3928a-c99e-41be-aebd-46d6f22fb9a7" alt="" width="375"><figcaption><p>Durty Cloth Tool Texture Optimization Improvements</p></figcaption></figure>

### ⚡ Quality of Life improvements

Streamlined workflows and fewer interruptions across the board:

* Option to disable the "Total props per gender limit" dialog (recent FiveM fixes)
* Option to directly disable "Reached max drawables for type" in the project when it occurs
* Improved Unsaved Changes handling via Project Auto Saves to preserve discarded edits and reduce prompts
* Clearer handling and logging when skipping drawables
* More consistent logs with improved levels across the app
* Builders & compatibility: Menyoo PedDecalOverlays.xml, official support for `mp2024_02` and `mp2025_01`
* Tattoos QoL: `UseTintColor` flag, negative scale/UV support, and size guidance with warnings/errors

## v3.2 Full Changelog

```markdown
Added
- Add drawable Material Editor to view and edit shader/material parameters; save directly to the drawable
- Add drawable Embedded Textures Editor to manage embedded textures and auto-fix related shader params; save directly to the drawable
- Add unoptimized texture preview to Texture Optimization Dialog
- Add new auto-fixes in Optimization Dialog for embedded textures: fix unused embedded textures, fix wrongly named embedded textures, fix invalid diffuse sampler
- Add Live Texture Editing/Previewing to instantly see cloth updates in the 3D Preview (Diffuse, Specular, Normal)
- Add 3D preview support to show hair alternation previews (no hair / hair alternation models)
- Add config builder for Menyoo PedDecalOverlays.xml
- Add option to disable "Total props per gender limit" dialog (fixed in recent FiveM versions)
- Add option to directly disable "Reached max drawables for type" in project when it occurs
- Add official support for mp2024_02 and mp2025_01 game updates
- Add support for tattoos "UseTintColor" flag (configurable on tattoos)
- Add support for tattoos with negative scale and UV position
- Add tattoo size recommendations with warnings and errors when exceeding game limitations
- Add project behaviour setting to use texture name as unique name hash in Shop Meta dump
- Add support for Replace Collection feature to also replace base game (non-DLC) collection
- Add IsDummyPlaceholder value to clothes_dump.json when selected on build

Fixed
- Fix not working "Replace DLC Cloth Collection" option for RageMP/Singleplayer
- Fix server target game build setting by moving it to Project Settings instead of Build Settings
- Fix when "Add menu" moves to second line and hovering any option closes the menu
- Fix some DDS texture conversion issues
- Fix missing error when XML conversion on export fails
- Fix missing path errors in various situations
- Fix RcoreTattoo config builder output
- Fix files changed dialog sometimes triggering for non-shared DCT projects
- Fix potential error on tattoo creation from web
- Fix possible issue on file content checksum generation
- Fix various unhandled errors/exceptions that could lead to app crashes

Improved
- Improve Unsaved Changes discarding with Project Auto Saves to preserve discarded changes and avoid repeated prompts
- Improve handling and logging when skipping drawables
- Improve logging and log levels across the app
- Improve overall quality with many minor bug fixes and QoL tweaks
```

#### v3.2.0.1

```markdown
- App doesn't start as Administrator per default anymore in order to improve Drag & Drop Support
- Fix issue with wrongly generated Decoration Shop File
- Enhance props drawable type rendering in 3D Preview
- Various fixes to unhandled crashes
- Tons of improvements to handle common failed file & directory operations
```

#### v3.2.0.2

```markdown
- Various minor fixes and improvements
```

#### v3.2.0.3

```markdown
- More minor fixes and improvements
```

#### v3.2.0.4 + v.3.2.0.5

```markdown
- Improved UI/UX for first time project creation
- Fixed "InvalidCast" issue
- Fixed "Collection modified" issue
- Fixed Project Settings 'Description' Input content was not correctly aligned
- Improved tons of situations with file/directory handling to properly handle weirdest User Errors
- Many more minor fixes and improvements
```

## Durty Cloth Tool v3.1.0 (18.11.24)

## ✨Update highlights

This update focuses on many quality-of-life improvements, empowering teams to collaborate on Durty Cloth Projects effortlessly and introducing powerful features for addon tattoo creation, making it accessible to everyone. Here's what's new:

### 🖊️ 3D Tattoo Editor Support

With Pleb Masters: Forge 3D Tattoo Editor integration, creating addon tattoos has never been easier! Position, scale, and rotate tattoos in 3D and import them directly into DCT for a streamlined workflow. ✨**Try it out and use for free now** @ <https://forge.plebmasters.de/tattoo3d/\\>
\&#xNAN;*See our documentation for a how to get started:* [First Addon Tattoo](https://docs.gta.clothing/tattoos-makeup-and-overlays/first-addon-tattoo.md)

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-62022eba48f88b17403fa0fd0faa8640be67fe32%2FDCTv3.1-3DTattooEditor.png?alt=media" alt=""><figcaption><p>Pleb Masters: Forge 3D Tattoo Editor Example Image</p></figcaption></figure>

### 🕺 Custom Animations in 3D Preview

Load and preview custom animation files (.ycd) in the 3D Previewer. Simply drop animations into the designated folder or load them via the file selector in our 3D preview and use them instantly. (Docs @ [3D Previewing Clothes](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#custom-animations))

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-eaa3b7d1129979cc9f20caf2de6c03627fd4981e%2FDCTv3.1-CustomAnimations.png?alt=media" alt=""><figcaption><p>3D Preview load and use Custom Animations</p></figcaption></figure>

### 🛠️ Sharing and Collaboration on Projects

New Sharing and Collaboration settings allow teams to seamlessly work together on cloth projects using version control systems like Git. Share your projects easily with relative paths and independent build output folders for each team member. *See our documentation to get started:* [Working Together](https://docs.gta.clothing/share-and-sync/working-together.md)

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2F5r0S47I7V23mKHMD6j5W%2Fimage.png?alt=media&amp;token=90e8a79a-1ccf-4a8a-8f2b-0153ef18d775" alt=""><figcaption><p>New Project Sharing Project Settings</p></figcaption></figure>

### 📂 File Format Linking

DCT now supports file associations for .dctproj, .dctpackage, and .dctexport formats. Open files directly from your file explorer for added convenience.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-05ef860ba5fe9758e888e7cfddd0cd7d5644f98d%2FDCTv3.1-FileAssociations.png?alt=media" alt=""><figcaption><p>New File association DCT App Settings</p></figcaption></figure>

### 🛍️ Shop Meta File Generation

Easily generate shop meta files for your clothing, fine-tuning metadata like target shops and restriction tags directly within DCT. (Docs @ [Shop Meta File](https://docs.gta.clothing/game-mechanics/shop-meta-file.md))

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-3f685297ef9ca30c8c5d5ae22d397efc6f69392a%2FDCTv3.1-ShopMetaDetails.png?alt=media" alt=""><figcaption><p>New Shop Meta Details Tab</p></figcaption></figure>

### 🤖 Smart Behaviour Project Settings

New settings make managing dummy placeholders easier than ever, ensuring drawable ID consistency while preventing ID shifts. (Docs @ [App & Project Settings](https://docs.gta.clothing/basics/good-to-know/app-and-project-settings.md#project-settings))

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-757a2df75e411b4cc4789a6686d82885c98dc563%2FDCTv3.1-BehaviourSettings.png?alt=media" alt=""><figcaption><p>New Project Behaviour Settings</p></figcaption></figure>

### 🔍 Enhanced Integrated Search

Experience fuzzy matching, token matching, and result scoring for more precise search results. Effortlessly combine parameters like position and type for targeted searches. (Docs @ [Integrated Search](https://docs.gta.clothing/basics/good-to-know/integrated-search.md))

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-abb739bf7cd20295d01c135445d7888b54f40c7b%2FDCTv3.1-IntegratedSearch.png?alt=media" alt=""><figcaption><p>Improved Integrated Search</p></figcaption></figure>

### 🏷️ Creator Info

Add metadata like creator name, website, and support details for each item. Export this information in the .dctpackage format to credit authors or provide troubleshooting info. (Docs @ [Creator Info](https://docs.gta.clothing/basics/useful-to-know/creator-info.md))

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-c1867a55e3651378d159c298ccd960d5abce0905%2FDCTv3.1-CreatorInfo.png?alt=media" alt=""><figcaption><p>New Creator Info Tab</p></figcaption></figure>

### ⚡ Minor QoL Improvements

* Added mesh physics support in the 3D Preview.
* New analyze and remove duplicates project action.
* Option to auto-skip adding duplicates during app sessions.
* Added author and version metadata to project settings and output files.
* New texture preview size adjustment option.
* Context menu option to clone clothes for other genders.
* Added gender change support for clothes and tattoos.
* Improved Logs Window with search and text copy options.

This update ensures an even smoother cloth & tattoo modding experience and paves the way for efficient collaboration. Ready to take your projects to the next level? 🚀

## v3.1 Full Changelog

```markdown
Added
- Add support to load and preview clothes using custom anims in 3D preview
- Add support for version control (Git) hosted/shared cloth projects (See new Project Sharing Settings)
- Add DCT Launcher with support to open DCT file formats from file explorer directly
- Add support for Pleb Masters: Forge 3D Tattoo Editor to easily position and add tattoos
- Add proper generation of cloth shop meta file with configurable options to define RestrictionTags + Target Shop, per cloth
- Add new behaviour project setting: Replace dummys with real cloth on adding automatically
- Add new behaviour project setting: Instead of removing items ask to replace with dummy
- Add "Replace with Dummy" context menu options for cloth drawables + textures
- Add support to replace dummy cloth textures with real ones via context menu
- Add context menu option to create cloth clone to other gender
- Add gender change option for clothes + tattoos
- Add Search/Filtering to Logs Window + Option to select and copy text
- Add app option to change Texture Preview Popup Size
- Add displaying of size of files that will be cleaned when optimizing cloth project data folder
- Add option to auto skip adding duplicates for app session in duplicate confirmation dialog
- Add Project Author & Version to project settings, saved into cloth build output meta files
- Add DCT Version mentioning in the cloth build output meta files
- Add Creator Info fields that can be defined per Item and locked on export
- Add support for 3D previewing mesh physic based clothes
- Add project action to analyze for duplicates in project and easily remove them
- Add new validation check for total props game limit
- Add new documentation links and update some related links

Fixed
- Fix transparent texture images wrongly previewed (as black instead)
- Fix drag and drop textures reordering
- Fix possible crash when selecting appearance item thru error list
- Fix for 'Invalid Slice Pitch' error when exporting or optimizing textures (experimental)

Improved
- Improve project cache validation to fix some project loading issues 
- Improve search to allow for searching by various other cloth / data parameters like game name, file name, ids, position etc.
- Improve Auto Data resolving for more cases
- Improve confirmation dialogs opening behaviour
- Improve various UI dialogs to better support all themes + better overview
- Improve Rename Texture Hotkey (Changed to F2) for consistency 
```

#### v3.1.0.1

```markdown
- Fixed 3D previewer crash on startup
- Fixed possible crash on project loading
- Improved DCT Launcher Pipes Listener Handling, previously causing some issues
- Properly handle some "File in use by another process" cases
```

#### v3.1.0.2

```markdown
- Added new Dynamic Config Builders for rcore-tattoos and illenium-appearance
- Added support to paste UV Pos/Scale/Rot from Pleb Masters 3D Tattoo Editor via right click context menu on tattoos
- Improved Project Build output folder pre-checks to handle more cases
- Improved setup process of URL Protocol Handler & File Association (Formats) Setup
- Improved user settings upgrading process to handle more edge cases
- Improved overall error logging (More detailed logs in all sorts of corners)
- Fixed Singleplayer dlc.rpf Output not properly loading
- Fixed various 3D Preview Crash Issues
- Fixed using ' in some project meta fields could cause FiveM parsing errors
- Fixed some edge cases of failed project saving actions
- Fixed some possible crash issues when opening file dialog in some edge cases
```

## Durty Cloth Tool v3.0.0 (27.08.24)

### ✨Update highlights

This is the biggest feature update ever released. Featuring a completely remade user interface, more responsive than ever, introducing different looking themes and color options. Additionally performance across the entire application has been improved. Enjoy the best performance and more insights than ever before without compromise. This will definitely boost your daily clothes modding work! :)

### 🎨Themes and improved User Interface

Choose from a variety of new themes, including various dark themed color variants, your eyes can finally relax at night 🥳\
See this article for an overview of all themes: [Themes](https://docs.gta.clothing/basics/useful-to-know/themes.md)

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v300/durty-cloth-tool-themes.gif" alt=""><figcaption><p>New Themes available in DCT v3</p></figcaption></figure>

### 🆕Error List Window

Very customizable and exportable overview of issues, tips and information on your Cloth Resource.

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v300/durty-cloth-tool-error-list.gif" alt=""><figcaption><p>New Error List Overview available in DCT v3</p></figcaption></figure>

### 🆕Project Settings Window

Configure everything to your desire for your cloth project, **including customizing every validation with its related error level, thresholds and more to your liking.** Additionally there is also an entire new Options window that allows to adjust different DCT preferences.

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v300/durty-cloth-tool-project-settings.gif" alt=""><figcaption><p>Fully Customizable Project Settings</p></figcaption></figure>

### 🗃️Project .dctexport Format & Items .dctpackage

Easily export and **share single cloth items with configurations** or **entire cloth projects in one single file** for most easy transfer

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v300/durty-cloth-tool-exportandimport.gif" alt=""><figcaption><p>New Export and Import Formats</p></figcaption></figure>

### 👀New first person features, alternation models & behaviour flags support

Easily **configure first person mask model** or **tinted glass effects**. Additionally DCT comes with **full alternation models support** where needed to allow for an even better clothing and first person experience.

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v300/durty-cloth-tool-first-person2.gif" alt=""><figcaption><p>Prop Masks and Screen Effects demo</p></figcaption></figure>

#### Prop Mask Example

See this article for an overview of all supported prop masks: [Prop Mask Models](https://docs.gta.clothing/game-mechanics/prop-mask-models.md)

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v300/durty-cloth-tool-propmask.png" alt=""><figcaption><p>GTA V Prop Mask</p></figcaption></figure>

#### First Person Options

New first person options, configurable timecycle modifier including intensity and prop mask models.

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v300/durty-cloth-tool-first-person-options.png" alt=""><figcaption><p>New First Person Options</p></figcaption></figure>

### 🆕3D preview base components, animation quick select & auto rotate

Adjust any of the base components to be able to verify fitting of your cloth.

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v300/durty-cloth-tool-previewer.gif" alt=""><figcaption><p>Adjust 3D preview base components, auto rotate and Animation Quick Select</p></figcaption></figure>

Easily quickly test with various animation whether a clothing you have added is correctly rigged.

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v300/durty-cloth-tool-anim-quick-select.gif" alt=""><figcaption><p>Demo on quickly testing Clothes with Animations</p></figcaption></figure>

### v3 Full Changelog

```markdown
- Revamped entire App design to increase responsivenes and fix various useability issues
- Reworked project format and introduced project cache to speed up project loading
- Tons of performance improvements for project loading, clothes adding and project building
- Added "dark mode" with various different themes (try them out, they are nice) and theme color variations, selectable via Options window
- Added new "Options" window that allows for managing all user app related settings
- Redone Project Settings window that allows for managing all sorts of project related settings
- Added possibility to disable and adjust all existing validation rules
- Added new "Error List" Window (View > Error List) with various export possibilities to have an easy overview of all information in your cloth project
- Added new import/export formats for entire cloth projects, for convenient sharing of a DCT project
- Added new DCT Package export format for convenient sharing of cloth project items with their entire configuration, models and textures saved into one file
- Tons of quality of life improvements like a recently opened projects history, possibility to preview cloth texture image, enabling cloth texture thumbnails and all sorts of new configuration possibilities
- Added new first person options that allows for configuring tinted screen effects or mask model
- Added hair alternation models support to allow for addon hairs to properly work with hoodie hair, cut hair and remove hair options
- Added possibility to set any behaviour flag available (Like armoured, lightly armoured etc)
- Added animation "quick select" menu for easier cloth testing
- Added description field to project settings (for project notes or information etc)
- Added option to not automatically select newly added cloth / items in the drawables list
- Added XML drag and drop import for drawables and textures + Fixed textures drag and drop in general
- Added alternation model export options such as XML
- Added buttons to preview cloth model alternation models in 3d preview
- Added 3D previewer option to auto rotate around ped
- Added 3D previewer changeable base components for base hand, teef, accss, task & jbib
```

#### v3.0.0.1

```markdown
- Fixed special case crash when adding clothes
```

#### v3.0.0.2

```markdown
- Added option to prefer use of Windows File Dialogs instead of the new themed file dialogs (Accessable thru Options Window)
- Improved saving of window position
- Improved remembering of last accessed folders
- Fixed updating behaviour flags removing flag set on previous item
- Fixed focus lost on 3D previewer when double clicking on appearance item list entry
- Fixed auto backup crash when clothproject folder didnt exist
- Fixed auto selection of newly added clothes (now just selects added ones)
- Fix alternate variations generation
```

#### v3.0.0.3

```markdown
- Added option to automatically update selected drawable texture based on selection when 3D previewer open
- Added support for multiple addon clothes keeping their related cut hair / high heel configuration in 3D previewer
- Fixed more alternate variations generation related issues (submitted GTA limit issue to FiveM/alt:V)
- Fixed anim playback speed resetting on cloth change
- Fixed maximizing / minimizing issues with the window on different screens
- Fixed rare case issue when opening right click context menu
```

#### v3.0.0.4

```markdown
- Fixed rare case app crash related to wildly doing things
```

#### v3.0.0.5

```markdown
- Improved project data optimizing action (Cleaning up faster now and is more responsive)
- Fixed some multi selection commands not working any more (Mass Delete for example)
- Fixed 3D preview causing crash when opened via button click
- Fixed crash when trying to import DCT package to not created/new project
- Fixed some rare case random project crashes
```

#### v3.0.0.6

```markdown
- Fixed rare case project load crash where corrupted auto backup was the reason
- Fixed some possible drag and drop related crash issues
```

#### v3.0.0.7

```markdown
- Added CTRL + F hotkey to focus search input
- Added option to disable any extra ped alternate variations related features, which can be used in case of "ERR_MEM_MULTIALLOC_FREE" crashes
- Improved cloth texture previews to load much faster and also react much faster on hovering img placeholder
- Improved auto updater handling to gracefully end any confirmation dialogs in future updates
- Fixed rare case crash issue with build output pointing to drive letter that doesnt exist anymore
- Fixed potential project loading issue with some invalid project states
```

#### v3.0.0.8

```markdown
- Added experimental option to "Fix 'invalid fixup' bugged cloth drawables", access it via Right Click context menu
- Added Project Error List button next to project settings
- Added possibility to find drawables by game name / output file name
- Added drawable name and texture names entered in DCT as values to the cloth info dump
- Added button to clear Recent Projects History in Options window
- Improved "Disable Extra Alternation Features" build option to also not automatically create _1 alternation model
- Improved tooltip showing duration at various places
- Improved cloth texture export in single texture case
- Fixed Project Name and DLC Name setting input not working on some themes
- Fixed possible issue with animating cloth props not working
- Fixed possible issue with invalid project folder causing app crash
- Fixed various 3D previewer cases that could cause it to crash
- Fixed rare case crash issue with windows themed multi file dialogs
- Fixed rare case issue with unhandled corrupted texture (YTD) file
- Splash Screen is animated now 😏
```

## Durty Cloth Tool v2.5.3 (20.03.24)

### ✨Update highlights

This is a minor feature update, including some 3D preview features, many fixes and improvements. This will help you with your daily clothes modding work! :)

### Show Floor & 3D preview high heel heights

Add a floor to your 3D preview and see whether your high heel will glitch thru it or not. Change custom high heel heights with ease to its proper value, making sure it doesn't glitch in game.

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v253/durty-cloth-tool-high-heel-preview.gif" alt=""><figcaption><p>Demo showing new High Heel 3D Preview with floor</p></figcaption></figure>

### 3D preview cutting hairs below head props

Adjust with ease custom cut values and see which value exactly is needed to not have hairs glitch thru your hats anymore. Everything is instantly visible in the 3D preview.

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v253/durty-cloth-tool-hair-scale-bone-preview.gif" alt=""><figcaption><p>Demo showing new Hair Cutting in 3D Preview</p></figcaption></figure>

### Control Animation Playback Speed

See your cloth in motion and slow down the playback to instantly see whether its properly rigged and working.

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v253/durty-cloth-tool-animation-playback.gif" alt=""><figcaption><p>Demo showing Animation Playback Speed Control</p></figcaption></figure>

### Change base components/clothes

Easily adjust torso, head, legs and more in 3D preview to see which other cloth components are needed to work with your addon cloth!

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v253/durty-cloth-tool-change-base-components-preview.gif" alt=""><figcaption><p>Demo showing changing of 3D Preview base Components</p></figcaption></figure>

### Preview multiple addon clothes at the same time

Preview your addon cloth additions together in the 3D preview to see whether clothes are matching or fitting 🔥

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v253/durty-cloth-tool-preview-multiple-clothes2.gif" alt=""><figcaption><p>Demo showing 3D Previewing multiple Addon Clothes</p></figcaption></figure>

### v2.5.3 Full Changelog

```markdown
- Added option to "Show floor" with correct high heel height rendered, adding possibility to fine tune heel height live with 3D preview
- Added correct rendering of hair scale bone modifications (Cut Hair/Remove Hair options on phead props for example), adjust live in 3D preview when changed (Custom Cut Hair value for example)
- Added possibility to control animation playback speed, allowing to better test clothes in motion
- Added options to change the ped base components used in the 3D preview, for example to adjust head, legs etc. Also allows for 3D previewing multiple custom clothes at the same time.
- Added and improved some warnings/information 
- Added proper prop rendering on ped (Props will not just render without the ped anymore)
- Lots of fixes related to 3D preview, failing in some cases with modded GTA V installations
- Many other fixes to errors that could appear in some scenarios
```

## Durty Cloth Tool v2.5.2 (24.01.24)

This is a minor "Quality of Life" update, including tons of fixes, improvements and smaller changes that will help you with your daily clothes modding work! :)

### New icons & "support" for escrow / locked files

Lightbulb now indicates information for potential improvements to clothes and you are now able to add escrow locked files to your project and build it. Keep in mind this doesn't mean we fully support escrow locked clothes, in general this still requires additional manual work to make them properly load (You need to put the package license some how properly for it to load)

<figure><img src="https://i.imgur.com/IVbHNKu.png" alt=""><figcaption><p>New Icons and Escrow Locked File indicator</p></figcaption></figure>

### Official support for latest gamebuilds

You can now select mp2023\_01 and mp2023\_02 gamebuilds on project build for improved warnings and information. Keep in mind that you could previously already build projects for these newer gamebuilds but with less accurate errors & warnings.

<figure><img src="https://i.imgur.com/vKjbf9Y.png" alt=""><figcaption><p>Target Game Build Selection with new Game Build option</p></figcaption></figure>

### New warnings & information

Introducing some new information to increase awareness for bad clothes, including:

* new warning for Raced skin type clothes that have bigger than 512x512 textures (not needed / unsupported by game)
* new warning for unoptimized / bad sims port textures (unoptimized / huge)
* new warning for embedded textures containing illegal characters in name (causing them to not work properly)

<figure><img src="https://i.imgur.com/mvcUJF0.png" alt=""><figcaption><p>New Warnings &#x26; Informations added</p></figcaption></figure>

### v2.5.2 Full Changelog

```markdown
- Added options / "support" for mp2023_01 & mp2023_02 gamebuild selection in build options
- Added some new discovered audio presets
- Added "support" for escrow / locked YDD files, you can add them now to your project and build them but it still needs escrow license file placement manually + doesnt work with adding escrow protected files from different packages as this would require multiple escrow licenses, which we dont know yet how it should work (Feel free to reach out to us if you know more)
- Added support for optimizing a previously unknown TextureFormat, which lead to many YTD/Embedded YDD textures failing to optimize
- Added some fallbacks and checks for blocked license files, causing them to not being read properly
- Added new warning for Raced skin type clothes that have bigger than 512x512 textures (not needed / unsupported by game)
- Added new warning for unoptimized / bad sims port textures (unoptimized / huge)
- Added new warning for embedded textures containing illegal characters in name (causing them to not work properly)
- Added information when previewing clothes that miss diffuse texture, stating that 3D preview doesnt represent ingame look in this case
- Added option to disable missing diffuse texture warning in 3D preview (Menut > Options dropdown)
- Added clothproject data folder relocation dialog on project load when all files failed to find (Should help in cases where clothproject folder got moved around)
- Improved information icon to lightbulb instead of question mark + introduced lock icon for either corrupt or locked files
- Improved 3D preview initial loading time
- Improved general memory usage of Durty Cloth Tool (It should consume less now)
- Improved duplicate content check to consider type & gender information
- Fixed 3D preview crashing in same cases with badly made drawables
- Fixed placeholder dummy textures not causing proper shifting texture variation id. You can now add dummy textures before a real texture variation and it will cause the real one to be shifted to variation id 2 for example
- Fixed some mods installers (FiveMods etc) & graphic mods (Network Redux) causing 3D preview to not load / eat up all your RAM and CPU
- Fixed adding files with capslocked file extensions like .YDD .YTD etc.
- Fixed setting possibly invalid tattoo file names, leading to application crash on build
- Fixed Enable Animation / Only Selected Cloth checkboxes sometimes in invalid state when switching between props & clothes in 3D preview
- Fixed output directory write permission check, sometimes not properly detecting read permissions on selected output folder
- Fixed adding Read Only files to project not being possible
- Fixed issue caused by some recent windows updates that lead to HWID sometimes changing
- Disabled sub folders option for alt:V as its unsupported right now
- Updated some discord / support links
```

## Durty Cloth Tool v2.5.1 (16.03.23)

This is a minor "Quality of Life" update, including tons of smaller changes that will help you with your daily clothes modding work! :)

### New hat options

There are new options now to define hats as motorcycle helmets, bullet proof helmets or airplane hats. These will change some of the behaviours of the hat; for example the player not taking any headshot damage or the helmet not being dropped off when riding a motorcycle

<figure><img src="https://i.imgur.com/AYCqysf.png" alt=""><figcaption><p>New Hat Options</p></figcaption></figure>

### Rename textures

You are able to rename cloth drawable textures now using the right click mouse context menu. This will help organizing your cloth projects even more.

<figure><img src="https://i.imgur.com/yiv8u20.png" alt=""><figcaption><p>Rename Cloth Texture dialog</p></figcaption></figure>

### Bulk exporting textures + exporting embedded textures directly

There are various bulk exporting options available now. It has been never easier to quickly export embedded textures to PNG or DDS, additionally all other exporting options support bulk (mass) export options now by selecting multiple items.

<figure><img src="https://i.imgur.com/pfSpIE0.png" alt=""><figcaption><p>New Bulk exporting options</p></figcaption></figure>

### v2.5.1 Full Changelog

```markdown
- Added motorcycle helmet, bullet proof helmet & airplane options for hat props
- Added new warning for when no diffuse sampler info found (breaks lightning)
- Added new warning when there is no embedded and external samplers at all (Bad clothing)
- Added new warning for unused embedded textures in cloth model (Useless, takes up space)
- Added new warning when embedded textures are not named correctly for skin toned drawables (Breaks clothing)
- Added new (build time) warning for drawables that have invalid shader names defined (Breaks clothing)
- Allow for custom high heel height down to 0.1
- Added warning for SP & RageMP resources when DLC Name / collection name is invalid
- Added option to add from one or multiple files without targetting gender specifically, automatically tries to resolve the gender of selected drawable files
- Added possibility for bulk optimizing textures of same drawable (Select all textures, right click -> optimize)
- Added new context option to export drawable with textures
- Added bulk export support for all selected drawables or selected textures
- Added new options to export all embedded textures as PNG or DDS
- Added new context option for textures to rename textures to your liking (Helps organizing)
- Added warning when trying to add facial overlay, stating its WIP / not working
- Added progress indicator for texture optimizations + making it not freeze the application
- Added showing skintone setting for drawables that are already added as raced (So they can be changed if they got added as raced drawable)
- Added option to resort project item positions (for the autistic people, find it in Project Window Options > Resort item positions) 
- Bigger refactoring of everything that is context menu related, will now only enable options to you that are also useable
- Pressing ENTER while editing any textbox input will now automatically save and update edited item
- Fixed possible rare case DDS optimizing error
- Fixed "divide by zero" exception for projects with only 1 item, causing them to not load again
- Fixed replacing of dummy drawables & textures
- Fixed wrong message when failed to optimize embedded texture / drawable
- Fixed possible crash for certain context menu options on dummy placeholders
- Fixed default generated file name for drawable & textures export options
- Fixed controller input being able to move preview even without focus
- Fixed EndOfFile issue for exported DDS files sometimes, making them unusable
- Fixed facial overlay position not increasing when adding new ones
- Fixed corrupt textures when drag & dropping PNG or other image formats onto textures section
- Removed initial Position being postfixed for the default cloth names, was confusing in addition to Position
- Raised precision for custom high heel height and hair cut value to .2
```

## Durty Cloth Tool v2.5.0 (07.02.23)

### :bookmark\_tabs: Important Project Migration Note

This update changes the way your cloth project is saved and referenced cloth models and textures are managed internally. Due to this change, on first time loading a older project, it will be automatically migrated to the new project format without any needed input from you. As this could take some while, you will be prompted with a dialog to confirm this.

In this process all your previously added, 'linked', clothes will be copied to a by Cloth Tool managed "data" folder.\
\
\&#xNAN;***Read more "technical information" about the changed project new projects formats in the end of this post.***

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v25/durty-cloth-tool-project-migration.gif" alt=""><figcaption><p>Showcasing new Projects handling</p></figcaption></figure>

### ✨Update highlights

This is **the biggest cloth tool update** so far, almost one year of work, lots of research and testing went into this. Thanks to every suggestion on this GitHub or my Discord and special thanks to the @Clothes-Experts that decided on helping testing and improving this version.

Lets dive into some of the highlighted features and additions of this new version.

### :mag: 3D Previewer

Introducing the 3D Preview Feature. This exciting new feature allows you to **easily visualize and analyze your cloth models and textures** in a whole new dimension. With the Cloth 3D Preview Feature, you can:

* **Preview model and texture combinations with ease**, using the context menu options, the preview button or by simply double clicking any item.
* Get a full **preview of your ped models and see cloth models in motion**, allowing you to test whether clothes are correctly rigged.
* **Apply animations** to your ped models and see the clothes in motion for an even more comprehensive analysis.
* Benefit from **different render modes** that help you identify any cloth model issues.
* Take advantage of the **wireframe option to see the model structure**, and the ped skeleton option to see the ped bones.
* **Switch between different levels of detail (LOD)** to preview the models in a range of resolutions.
* **Explore the Models & Texture data** tabs for a more in-depth analysis of your cloth models.

This feature is an essential tool for anyone looking to bring their models and textures to life and is sure to take your 3D modeling to the next level.

#### Example of male clothes, changing light direction, switching thru different Level of Details & animating ped

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v25/3d-preview-male-example.gif" alt=""><figcaption></figcaption></figure>

#### Example of female clothes, animating, showing grid, wireframe & only selected cloth

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v25/3d-preview-female-example.gif" alt=""><figcaption></figcaption></figure>

#### Example of different rendermodes allowing deeper texturing insights

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v25/3d-preview-rendermode.gif" alt=""><figcaption></figcaption></figure>

### 💇Tops with working duffel Bags, Hoodie hairs & Masks that cut or remove hairs

This update introduces various new options to **make use of even more GTA V cloth related game mechanics**. Find out more about all new clothing options below.

#### Cut hairs for hoodie clothes (tops & undershirts)

Configure whether your **hoodie top / undershirt should cut hairs** to make hoodies not glitch.

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v25/showcase-hoodie-hairs-option.png" alt=""><figcaption></figcaption></figure>

#### Remove hat in vehicle

Set **hats to automatically be removed when the player enters a vehicle** and reapplied when he leaves it again. Making it not glitch thru the vehicle roof.

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v25/showcase-removehatvehicle-option.png" alt=""><figcaption></figcaption></figure>

#### Without 'Remove hat in vehicle' option, hat will possibly glitch thru roofs

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v25/durty-cloth-tool-removehatinvehicle_flag_off.gif" alt=""><figcaption></figcaption></figure>

#### 'Remove hat in vehicle' option enabled, hat will be unequipped in vehicle

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v25/durty-cloth-tool-removehatinvehicle_flag_on.gif" alt=""><figcaption></figcaption></figure>

#### Cut or remove hairs for masks (berds)

Configure **masks (berds) to automatically cut or remove hairs completely** whenever needed to perfectly fit your masks without glitching hairs.

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v25/showcase-mask-hair-options.png" alt=""><figcaption></figcaption></figure>

#### Fixed addon tops (jbib) vanilla game duffel bags invisible

Previously all vanilla game duffel bags would not work (be invisible) with all your addon tops (jbibs), this is now **automatically fixed** and will work after regenerating your cloth pack with this new update.

#### Previously 'unfixed' addon top with duffel bag combined

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v25/durty-cloth-tool-addonjbib_duffelbag_notfixed.gif" alt=""><figcaption></figcaption></figure>

#### Now 'fixed' addon top with duffel bag combined

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v25/durty-cloth-tool-addonjbib_duffelbag_fixed.gif" alt=""><figcaption></figcaption></figure>

### :exclamation: Tons of automatic error analyzing

Introducing a new and improved error handling system, you can now **easily identify and fix issues that could potentially break your clothes**, before you build.

With this new feature, you'll be able to:

* **Quickly categorize issues** as Errors, Warnings, or Informations.
* **Identify and fix Errors that could break your clothes**, ensuring that your projects are always in tip-top shape.
* Take advantage of **various Warnings, ranging from missing LOD levels**, invalid model files, missing embedded textures, and more, to improve the quality of your cloth models and textures.
* Receive **Informational hints that provide valuable insights** into your cloth projects.

Elevate your cloth projects and stay ahead of the game with our new error handling system.

#### Example of some information, warnings & errors

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v25/durty-cloth-tool-errors-warnings-infos.gif" alt=""><figcaption></figcaption></figure>

### :zap: Easy optimizing of cloth textures and embedded model textures

Say goodbye to manual texture optimization and hello to effortless efficiency with this update. The Texture Optimization Feature is here to **revolutionize the way you optimize your textures and models** with ease.

With a range of easily optimizations and edits to apply, including:

* **Automatic optimization of the compression format** for your textures, ensuring the best quality with the smallest file size, or choose your own compression format to be applied.
* **Automatic generation of the suggested amount of mipmap levels** for your texture, providing the perfect balance between quality and performance.
* Seamless adjustments to your textures with the **automatic adjustment to the next power of two** width and height.
* **Easy downscaling of your textures** to your preferred size, ensuring that your models look great at any resolution.
* Effortless compatibility with **embedded model textures and cloth texture variations**, without the need for any other tools or manual editing.

With the Texture Optimization Feature, you can streamline your workflow and focus on creating the best GTA V cloth pack possible.

#### Example of easily optimizing compression format, mipmaps, power of two & more

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v25/durty-cloth-tool-texture-optimizing.gif" alt=""><figcaption></figcaption></figure>

### :point\_right: Drag & Drop

Making it **easier than ever to import files**. With this new feature, you can:

* **Effortlessly import files by simply dragging and dropping** them into the tool, whether they're from Windows File Explorer, OpenIV, or CodeWalker.
* Save time and streamline your workflow by **eliminating the need to manually export & import files** one-by-one.
* Enjoy a **more user-friendly and intuitive experience adding files** from GTA V file explorers

#### Example of dragging and dropping files from OpenIV and CodeWalker

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v25/durty-cloth-tool-dragndrop.gif" alt=""><figcaption></figcaption></figure>

### :open\_file\_folder: Various new import & export formats

We're excited to announce a suite of **new import and export file formats that make it easier than ever** to work with clothes.

With this new update, you can:

* Enjoy faster workflows (especially when using Blender) with the **addition of CodeWalker XML import and export support** for cloth drawables and textures.
* Have more flexibility when editing your cloth textures with **new DDS and PNG export options**.
* **Quickly add cloth textures straight from a image**, from a variety of image formats including PNG, JPG, TGA, and BMP, which will automatically be converted to YTD.

#### Example of exporting to & importing from different new file formats: CodeWalker XML, PNG, DDS

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v25/durty-cloth-tool-new-file-formats.gif" alt=""><figcaption></figcaption></figure>

### :floppy\_disk: New projects format & file/data handling

All **files related to a cloth project will be saved & managed in one single folder**, that could easily be shared & does prevent accidentally building files to some unwanted location, deleting hundreds of files in advance (People selected Desktop as output and files got deleted there..).

* Durty Cloth Tool will manage all files added to your project on its own, which **takes you the hassle to manage all imported files on your own** and removes cases where you accidentally deleted a file used in any of your cloth projects, breaking it completely.
* Files that are added to the project will now be imported to a "data" subfolder of your output folder defined in the build settings

### :wrench: Dynamic config builders

The Dynamic Config Builder options are here to **provide you all the configuration files** you need to work with framework plugins like xnTattoos, qb-tattooshop, ESX-TattooShop, or any other similar config files.

With this powerful new feature, you can:

* **Easily provide example configuration entries** for various framework plugin configurations, making the setup process a breeze.
* **Access clothes and tattoos info dumps** filled with valuable information for your developers, such as scripting IDs, types, and names.

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v25/showcase-dynamic-config-builders.png" alt=""><figcaption></figcaption></figure>

#### Example of generating different config files and viewing them in Visual Studio Code

<figure><img src="https://assets.plebmasters.de/durtyclothtool/images/v25/durty-cloth-tool-dynamic-config-builders.gif" alt=""><figcaption></figcaption></figure>

### :bulb: Technical explaination for new project data keeping

In previous versions, as soon as you add any drawable or texture file, a reference to this file has been saved. This reference is the full file path leading to the file you have selected. Basically it is not adding the drawable, its just *linking* to it. This behaviour is not common for applications that look like managing files, like Durty Cloth Tool does.

**This can and does cause issues like**

* moving the whole clothes project file is nearly to impossible if not properly managed on your own
* you will have to take care of managing files properly, because if not done properly you could end up deleting files from your disk that are used in any cloth project
* new people can run into issues like; downloading clothes from the internet, then selecting the drawable file in the downloads folder. When file gets overwritten or deleted in the future, it will just break cloth projects

**It does bring some pros tho**

* "Experienced" users that are aware of the possible issues can manage clothes for multiple cloth projects that share the same cloth files (If this is a use case?)
* Possible duplicate of same cloth files on the disk can be prevented (saves some disk space)

The **change introduced with this version** is that adding a drawable or texture file, will basically import (copy) the file into a by the cloth tool managed "data" folder. This will make managing clothes files a no-brainer as people will not have to pay any attention to that anymore. The cloth tool will manage all files in a folder and delete them there if they are unused, while making sure to not delete it instantly (so you could still delete clothes from your project for testing, exit the tool and load the project again and they would be there again.).

People could still setup & manage "raw/source" folders if wanted to keep the original files somewhere, to add from that. Imported / managed files by Durty Cloth Tool will receive cryptic hash names like `936DA01F-9ABD-4D9D-80C7-02AF85C822A8.ydd` as it is not meant to manually delete, edit or replace files in the data folder.

### v2.5 Full Changelog

```markdown
# Added 3D Previewer
  - Easily 3D preview model & texture combinations using the context menu options, the preview button or double clicking any item
  - Full ped preview & cloth model only preview
  - Apply animations to the ped and see clothes in motion to test whether clothes are correctly rigged
  - Different render modes that help analyzing cloth model issues
  - Wireframe option to see model structure
  - Ped skeleton option to see ped bones 
  - Level of Detail switch to preview different level of detail (LOD) models of your cloth model
  - Models & Texture data tabs to get more deep insights
 
# Added new projects format & file handling
  - Durty Cloth Tool will manage all files added to your project on its own, which takes you the hassle to manage all imported files on your own and removes cases where you accidentally deleted a file used in any of your cloth projects, breaking it completely.
  - Files that are added to the project will now be imported to a "data" subfolder of your output folder defined in the build settings
  - Manually editing any files in this directory is not recommended, please use either "Remove" or "Replace" context menu options to edit any files
  - When first time loading old / previous cloth project, they will automatically be migrated to the new project type
 
# Added tons of error analyzing and features to warn about possible cloth issues
  - Durty Cloth Tool now treats issues in the category of errors, warnings and informations. Errors will possibly break / make your clothes not work and therefore need to be fixed before build, where as warnings are just personal recommendations to improve any cloth model or texture and informations are just small informational hints.
  - There are different kinds of warnings now ranging from missing LOD levels, possibly invalid model files, missing embedded textures or textures that are not pow2, too big or have no mip map levels and tons more

# Added easy optimizing of cloth textures and embedded model textures
  - Automatically optimize compression format to the best choice for the given texture, or select your own compression format to be applied
  - Automatically generate the suggested amount of mipmap levels for your texture
  - Automatically adjust textures to the next power of two width & height
  - Easily downscale textures to the preferred size
  - Works for embedded model textures & cloth texture variations, magically without the need to edit anything in any other tool

- Added dynamic config builders, easily provide example configuration entries for xnTattoos, qb-tattooshop, ESX-TattooShop or any other similar config files. Also provides clothes & tattoos info dumps that contain all scripting ids & information needed for your developers to work with the new clothes
- Added options to create complete GTA DLC replace resource, by allowing to assign different male & female cloth collection names or select from a list of GTA 5 dlcs to automatically set the names
- Added drag & drop support from windows file explorer, OpenIV or CodeWalker, just drag your files into the tool and it will automatically import them
- Added facial overlays support (beards, makeup, aging, body hair, eyebrows etc), easily add any facial overlay texture and let the Durty Cloth Tool to the rest (very experimental, known to not work as addons... need more investigation)
- Added warning before trying to exit application when project is not saved, also adds more information to the app title bar
- Added multi selection support to remove project items or textures
- Added absolute & relative drawable id generation in the tool, the tool will now automatically calculate the target absolute drawable id (This only works when the cloth pack will be the first or only cloth pack to be loaded)
- Added context menu for project items & textures, with options to quickly Remove, Replace, Export, Copy Names or 3D preview
- Added option to customize high heel height, alternatively to the default high heel height value
- Added option to set custom cut value for hairs, alternatively to the default cut value
- Added support for RageMp as official target resource type 
- Added BERD drawable type option to "Remove hat in vehicle", will automatically remove the hat while in vehicle and put on when exiting vehicle
- Added DEL hotkey for quickly deleting selected items / textures (Confirmation dialog will still open)
- Added options for masks to cut hairs or remove hairs completely when worn
- Added option for "Hoodie hairs" on tops (jbibs) and undershirts (accs)
- Added support for all basegame duffel bags to properly work with addon tops (jbibs), they should not be invisible weared in combination with addon jbibs now
- Added CodeWalker XML import & export support for cloth drawables + cloth textures, enabling faster workflows when working with Blender
- Added DDS & PNG export options for cloth textures for more easier editing of your clothes
- Added support for adding cloth textures from png, jpg, tga & bmp images directly (They get auto converted to YTD)
- Added various new file formats for importing cloth textures from, like png, jpg, tga & bmp
- Improved logging overall, previous session logs are now saved, all logs in general provide more information 
- Improved mass adding from folders (previously taking ages & freezing application), Performance increases, can understand and import much more file naming schemas, will not only search top directory
- Improved various messages & dialogs like item duplicate & license error dialogs. Buttons should be better understandable now
- Improved alt:V resources configs, from old .cfg file schema, to new .toml file schema
- Fixed SP cloth packs not working
- Fixed possible crash cause when using decorations (tattoos) meta
```

## Durty Cloth Tool v2.3.0 (05.02.22)

### Important License Note

**As this update changes the way licenses are generated and processed, you might have to update your HWID with the new one from the tool and update it on the website + download a new license**

*Visit the* [*Pleb Masters: Forge licenses*](https://forge.plebmasters.de/account?tab=licenses) *page to update your HWID and redownload your license* *Find a detailed article on how to download and use your license* [*on patreon*](https://www.patreon.com/posts/how-to-receive-59448712)

### ✨Update highlights

This update contains a lot of fixes that improve the overall experience with the tool and should resolve many of the reported issues I received. Besides many small additions, this update also contains some big new additions that I will highlight below.

### Crash fixes, fixes and more fixes

Thanks to all reports the past weeks, many of the issues that people experienced got fixed with this update. Including many things that possibly caused game crashes. Please keep in mind I am not able to fix the crashes and issues caused by loading too many *.YMT files in the latest game DLC / update. This limit has to be increased either bei R* Games themselves on the next updates or by the multiplayer platform of your choice.

Anyway I have added an option that disables the generation of extra .YMTs that are needed to make high heels, cutting hairs and other stuff possible. Using this can help you shrink down the amount of .YMT files generated, but will make the listed features not work anymore.\
\
\&#xNAN;*See this wiki article for more information regarding the game YMT files limit:* [Game Limits and Crashes](https://docs.gta.clothing/game-mechanics/game-limits-and-crashes.md)

<figure><img src="https://i.imgur.com/ldSzKFf.png" alt=""><figcaption></figcaption></figure>

### Addon Tattoos

This update introduces the first version of being able to easily manage your addon tattoos with the tool. By pressing Add in the tool, you will receive a list of options which now include "Add tattoo". Tattoos can be created from whatever image file you prefer; \*.png, \*.jpg, \*.dds, \*.tga, \*.bmp or even .ytd files from already existing tattoos. The tool will automatically optimize your tattoo images for the game and create all needed files that are needed. In the game the item Name will represent the tattoo hash / name and the collection name is represented by the name you have gave the collection in the build window.

<figure><img src="https://i.imgur.com/4PfCC1x.png" alt=""><figcaption><p>In Game Demo of a Addon Tattoo</p></figcaption></figure>

<figure><img src="https://i.imgur.com/0Qj1gdV.png" alt=""><figcaption><p>Showcasing new Addon Tattoo Option in DCT</p></figcaption></figure>

### Item warnings

From now on you will see possible warnings for your cloth items in form of an exclamation mark directly in front of the related item. This helps finding cause of issues ahead of time faster and more reliable.

### Build progress bar & cancel builds

To improve the cloth building experience I have added a build progress indicator, which will give you detailed information about the current state of build and the possibility to cancel the build at any time. Additionally the application remains responsive at any time.

### Cloth physics & Audio presets

You can now add related \*.YLD files for your clothes, which basically describe physics movement for your clothes. Additionally I have added the possibility to the define an audio preset for your clothes. You will be able to select from all the currently existing audio presets for your drawable type of choice. This will for example change the sound of your shoes when you are walking to proper high heel sounds and similar.

### v2.3 Full Changelog

```markdown
- Fixed issues with *.ymt files compression (That could lead to game crashes in some cases)
- Fixed issues with format of creaturemetadata.ymt file (That could lead to game crashes in some cases)
- Fixed drawable options window buttons sometimes not visible
- Fixed an edge case with dummy drawables that could cause clothes projects to not work anymore
- Fixed collection name could be uppercase (should always be lowercase)
- Fixed mass adding cloth models could fail when theres a variant of some model
- Fixed possible crash when output directory is still in use on cleanup
- Fixed last interacted folder sometimes not properly resolved and used on folder / file select dialogs
- Fixed license HWID related issues
- Added more license related logging on app startup
- Added support for mass adding gender specific clothes from multiple folders
- Added "Has skin tone data" flag support for body / UPPR drawables
- Added "Cut hairs" flag support for  comp MASK
- Added warning when drawables don't have any textures
- Added wiki links for YMT Limit help & New file naming help
- Added descriptions for all cloth drawable types
- Added initial support for tattoos (decorations)
- Added support for numbers in the collection name
- Added resource build progress bar
- Added support for cancelling a running build
- Added option to automatically copy cloth drawable files to sub folders (Named after drawable type)
- Added item warnings system that will indicate with a exclamation mark in the UI in front of items whether there is some potential issue
- Added support for enabling comp drawable cloth physics by selecting a *.yld file
- Added support for comp drawables audio presets that can change shoe walking sounds for example
- Added option to disable creation of extra .ymt files (With warning that it will disable high heels/ cut hairs flag support)
- Reworked resource building to run asynchronously and non UI-thread blocking
- Improved license info window to show license id and more details
- Improved several license related information
- Improved build finished information popup
- Improved build failed handling to properly cleanup resources
```

#### v2.3.1

<pre><code><strong>- Fixed position data not correctly being loaded from previous save files => overwriting all positions to 0 
</strong>-> Make sure to load a copy of your old save file if you have already overwritten it with the new version

- Fixed newly added tattoos having UvPos &#x26; Scale set to null, resulting in a build time exception 
-> Make sure to always set Uv Pos &#x26; Scale + rotation for all your tattoos
</code></pre>

## Durty Cloth Tool v2.1.0 (28.09.21)

#### Hey there, its been some time since the last release of the cloth tool.

This is the first release of the **next generation premium tool "Durty Cloth Tool"**, which is the best available tool to easily create & manage your GTA 5 addon cloth packs (for singleplayer, FiveM & alt:V) without any knowledge in GTA 5 modding needed. It has been rewritten completely from scratch with minimal design changes and a lot of new features.

**As this required a lot of time, this tool is limited in the free version** of it.\
Please **consider supporting me on Patreon to get access to a unlimited license**: <https://www.patreon.com/plebmasters>\
Also visit our new website for this tool: <https://gta.clothing>

### v2.1 Full Changelog

```markdown
- Completely rewritten core of tool (Improved performance and fixed many bugs)
- Completely rewritten UI (Fixed a lot of small issues & UI is completely responsive now)
- Added proper support for creating high heels
- Added proper support for hats that cut hairs
- Added proper support for hats that remove hairs completely
- Fixed various issues that caused some cloth textures to bug or not be visible
- Fixed singleplayer addon rpf generation
- Fixed "Unk Flags" options for drawables
- Fixed auto resolving file names for a lot of cases (Mostly related to EUP and other "replace clothes")
- Improved auto detection of textures for added cloth drawables in many cases
- Added options popup whenever options for an added cloth drawable could not be resolved (You can decide its type etc manually or skip items)
- Added support for adding "dummy / placeholder" drawables & textures that can be used to reserve ids (For future GTA 5 updates or own cloth ### updates)
- Added button to easily add female & male clothes from a input folder (For example EUP as source), automatically detects gender & other data of replace cloth drawables for example
- Added button to easily mass add female or male cloth drawables from target folders
- Added option to automatically skip already added cloth drawables (Detected by same file path)
- Added various pre-build checks to make sure your cloth build works 100%, if not it will give you proper warnings and how to fix it
- Added a seperately openable logs window (Click on log text), shows all logs
- Added a lot more logging in general so generation & actions can be better understand
- Added support for changing various drawable options after adding it (Comp/Prop & Drawable Type (lowr, accs, jbib etc.))
- Added support for easily reordering cloth drawables (To change generated drawable id (game id) of output)
- Added support for easily reordering drawable textures (To change generated variation id (ingame) of output)
- Added grid splitter between drawables list & edit drawables section, lets user customize the size of regions on its own
- Introduced new file format that should be smaller (You can select old save files and it will update the format) & Actually saves everything related to your project (Collection & build data too)
- Added application settings to save various app related things like: Last opened project, Auto cleanup output folder etc.
```

## Durty Cloth Tool v1.4.0 (21.04.21)

### v1.4 Full Changelog

```markdown
- Possible fix for Addon masks (Thanks to @Nicoo34)
- Some minor cleanup
- Experimental texId related changes
```

This version contains some experimental changes related to the texId, please create a Issue if you experience any weird behaviours.

#### v1.4.1

{% code overflow="wrap" %}

```markdown
- Minor fix for previous version in some case causing black textures?

This version contains some experimental changes related to the texId, please create a Issue if you experience any weird behaviours.
```

{% endcode %}

## Durty Cloth Tool v1.3.0 (16.04.21)

### v1.3 Full Changelog

```markdown
- Possible fix for Addon pants & shoes (Thanks to @MateqB)
```

## Durty Cloth Tool v1.2.0 (07.02.21)

### v1.2 Full Changelog

```markdown
- Various fixes and improvements
```

## Durty Cloth Tool v1.1.0 (23.01.21)

### v1.1 Full Changelog

```markdown
- Improved some texts and add error dialog for exception during resource building
- Fixed some naming consistency
- Fixed after removing item, details still shown
- Fixed crash with only prop project
- Added better error / info messages
```

## Durty Cloth Tool v1.0.0 (07.12.20)

### v1 Full Changelog

```markdown
- Various fixes
- A lot of refactoring
```

Expect things to be broken
