Changelogs

Learn more about Current and Previous Releases of Durty Cloth Tool

General Information

🔽Find the latest Version of Durty Cloth Tool by clicking on "Download Latest" on the top right or the .

👚Check out Pleb Masters: Forge if you are interested in retrieving file paths for modding GTA V clothes:

🛟Join our discord for support:

📝Please consider supporting me on Patreon to get access to a full license + support for this tool:

✅Also visit our website for more information:

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/ See our documentation for a how to get started: First Addon Tattoo

🕺 Custom Animations in 3D Preview

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

📂 File Format Linking

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

🛍️ 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)

🤖 Smart Behaviour Project Settings

🔍 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)

🏷️ 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)

⚡ 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? 🚀

Full Changelog

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

- 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

- 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

🆕Error List Window

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

🆕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.

🗃️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

👀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.

Prop Mask Example

See this article for an overview of all supported prop masks: Prop Mask Models

First Person Options

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

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

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

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

Full Changelog

- 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

- Fixed special case crash when adding clothes

v3.0.0.2

- 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

- 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

- Fixed rare case app crash related to wildly doing things

v3.0.0.5

- 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

- 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

- 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

- 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.

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.

Control Animation Playback Speed

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

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!

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 🔥

Full Changelog

- 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)

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.

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)

Full Changelog

- 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

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.

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.

Full Changelog

- 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)

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. Read more "technical information" about the changed project new projects formats in the end of this post.

✨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.

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

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

Example of different rendermodes allowing deeper texturing insights

💇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.

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.

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

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

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.

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

Now 'fixed' addon top with duffel bag combined

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

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

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

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

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

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.

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

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.

Full Changelog

# 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

✨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. See this wiki article for more information regarding the game YMT files limit: Game Limits and Crashes

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.

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.

Full Changelog

- 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

- Fixed position data not correctly being loaded from previous save files => overwriting all positions to 0 
-> 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 & Scale set to null, resulting in a build time exception 
-> Make sure to always set Uv Pos & Scale + rotation for all your tattoos

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.

Full Changelog

- 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)

Full Changelog

- 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

- 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.

Durty Cloth Tool v1.3.0 (16.04.21)

Full Changelog

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

Durty Cloth Tool v1.2.0 (07.02.21)

Full Changelog

- Various fixes and improvements

Durty Cloth Tool v1.1.0 (23.01.21)

Full Changelog

- 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