> 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 by clicking on "Download Latest" on the top right or the [Official Website](https://gta.clothing).
👚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 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.2** is currently on the Experimental channel. The highlights and full changelog below cover the whole v4 line, with the per release breakdown at the end.
{% endhint %}
## ✨Update highlights
Durty Cloth Tool 4 is the largest release so far. It expands the visual workflow from project organization through export, adds safer self-updating Release and Experimental builds, and modernizes the whole application. Here are the parts worth knowing about:
### 🏠 Home, Quick Look and a much faster start
DCT now opens on **Home**, which combines new, open, recent, import and built-resource starting points with a drop target for clothing files. **Quick Look** shows model, LOD, texture and physics facts plus a standalone 3D garment **without creating a project or requiring GTA V data**, and continues into the on-ped preview or a temporary analysis workspace that becomes a normal project on first save. Press **Ctrl+Q** to reach it without unloading your project.
The old blocking setup wizard is gone: **Project > New** drops you straight into a workspace. Startup is faster, project opening shows real progress, and the startup screen reliably hands off to a usable window.
{% hint style="info" %}
See [Home & Quick Look](/basics/useful-to-know/home-and-quick-look.md) documentation.
{% endhint %}
### 🧍 A rebuilt 3D Preview
The preview is now part of a **dockable workspace** alongside the Appearance Items list, Error List and Project Logs, with layouts saved per user and a Reset Workspace Layout action.
Inside it: a new **Studio** lighting default that lights garments evenly, wearing **several clothes at once** from the new Outfit tab, **hair colour and palette tint** controls, **textured wireframe**, camera autofocus, skin-tone overlays, and dedicated material rendering for supported Legacy ped clothing instead of one opaque fallback.
{% hint style="info" %}
See [3D Previewing Clothes](/basics/essential-knowledge/3d-preview-clothes.md) documentation.
{% endhint %}
### 🪡 Cloth physics with wind
Every drawable with a linked YLD is now **simulated in the preview**. Pinned vertices follow the skin and the animation, free vertices hang and collide with the body, and an adjustable wind with strength, direction and gusts moves them. Items carrying a YLD get a **Cloth** badge, and the focused drawable lists findings such as missing pins, edges or capsules.
{% hint style="info" %}
See [Creating Cloth Physics (YLD)](/cloth-modding/cloth-physics-yld.md) documentation.
{% endhint %}
### 🎨 Live Texture Editing
Edit the focused garment in your own image editor and watch the 3D Preview refresh whenever you save. Work in PNG for automatic game-ready recompression or DDS for direct format and mip control, then use **Save to cloth** to create project history or **Discard** to restore the project version. Diffuse, normal and specular channels are offered when the focused item provides them, and unsaved editor writes stay protected even while a file is locked or incomplete.
{% hint style="info" %}
Open **Advanced > Live texture editing** in the 3D Preview, or use **Edit texture in image editor** from a texture variation. An active license is required, and one edit session can run at a time.
{% endhint %}
### 🔧 Model Optimizer
Reduce the polygons of clothing models and generate the LOD levels a drawable is missing, with a live before-and-after 3D preview for one item or a project-wide scan against your polygon budgets. UVs, materials, normals, skin weights, borders and seams are preserved. Exclusions stay with the project, and the previous run remains undoable when you reopen the optimizer.
{% hint style="info" %}
See [Model Optimizer](/basics/essential-knowledge/model-optimizer.md) documentation. Optimizing a model requires an Ultimate subscription.
{% endhint %}
### 🖼️ Texture Optimizer, UV cropping and map generation
The **Texture Optimizer** scans every texture variation and embedded texture in the project, shows a plan with thumbnails, and applies it in one verified run with a before-and-after report and an undo.
It can also **crop textures to the UV region the meshes actually use** and remap the mesh UVs, which fixes ports that waste a huge texture on a tiny used area. A new **Wasted UV space** finding points you at them, and the Error List now offers a **Fix** action on every finding a tool can act on.
Separately, DCT can **derive normal and specular maps** from a drawable diffuse texture and embed them into the model.
{% hint style="info" %}
See [Texture Optimizer](/basics/essential-knowledge/texture-optimizer.md) and [Normal & Specular Maps](/basics/good-to-know/normal-and-specular-maps.md) documentation. Optimizing a selection of textures needs any active license; whole project runs, UV optimization and map generation require Ultimate.
{% endhint %}
### 📦 A rebuilt Build Project, with splitting and per-pack replacement
Build Project now opens on a compact overview of target, collection mode, contents, destination and every resource that will be generated, and keeps building in the same window with staged progress, elapsed time and a remaining-time estimate.
**Automatic resource splitting** turns a project that outgrows one clothing resource into several coordinated resources, by collection limits or by deployable size, without spending another clothing collection on the size split. Large singleplayer packs spread over several archives instead of being refused.
**Per-pack replacement** lets each generated pack replace a known GTA DLC, base-game clothing, or a manually named collection, and FiveM planning reports generated, reused and net additional YMT slots.
{% hint style="info" %}
See [Build Options](/basics/essential-knowledge/build-options.md) documentation.
{% endhint %}
### 🎮 FiveM Enhanced (Gen9)
FiveM projects can now target **Enhanced** as well as **Legacy**. Enhanced automatically converts supported YDD and YTD output, including generated and split assets, to the Gen9 format, while metadata, YMT, YLD and the manifest keep their normal FiveM form. Existing projects stay on Legacy.
{% hint style="warning" %}
Enhanced output currently supports addon resources only, and stops before replacing the output when the project has an active replacement pack or managed Asset Escrow files. Test the complete result on the intended FiveM client and GTA title build.
{% endhint %}
### 🕰️ Project History and rollback
Important edits now leave **restore points**. File replacements, optimizer runs, dummy replacements, repairs and editor saves are recorded as grouped changes, and you can roll back the whole project, a single drawable, or a single texture variation. Each project keeps up to 100 lightweight restore points, separate from the automatic recovery backups.
{% hint style="info" %}
See [Project History](/basics/useful-to-know/project-history.md) documentation.
{% endhint %}
### 🔑 Sign in with Discord
Discord sign-in keeps your Forge subscription and device license ready inside DCT. The account chip and the redesigned **Account & License** window show subscription, renewal, tier, device lock and installed license status together, and an eligible license can be locked to this PC, renewed or upgraded without restarting. Valid downloaded licenses keep working offline, and manual license loading remains available.
{% hint style="info" %}
See [License Activation](/getting-started/license-activation.md) documentation.
{% endhint %}
### 🌍 Nine languages
DCT now follows your Windows language on first start and offers nine complete interface languages: **English, German, French, Russian, Spanish, Brazilian Portuguese, Simplified Chinese, Hindi and Arabic**. Windows, dialogs, messages, findings, logs, settings search, preview controls and launcher prompts all follow your choice. Saved support logs, crash reports, file names and generated game resources stay English on purpose.
### 🗂️ Organise the drawable list
Filter the list by gender, item kind, drawable type, skin type, findings, file state and your own **colour coded tags**, with per option counts, removable chips and named presets saved per project. Tags travel with packages and exports. Sorting changes only the displayed order, never drawable indexes.
{% hint style="info" %}
See [Drawable Filters & Tags](/basics/good-to-know/drawable-filters-and-tags.md) documentation.
{% endhint %}
### 📥 Import from a built resource
You no longer need the original project to work on a pack. DCT can read another **DCT project or export**, a **FiveM** resource, a legacy multiplayer resource, or a Singleplayer `dlc.rpf`, and **shows you exactly what it found before anything is added**.
Source ordering and supported item metadata are preserved, missing slots are represented with reservation dummies so IDs do not shift, split resources are handled together, and the names, settings and output paths of your open project are left alone.
{% hint style="info" %}
See [Import & Export Formats](/basics/useful-to-know/import-and-export-formats.md) documentation. Requires a valid license.
{% endhint %}
### 👯 Find duplicates
**Project Actions > Find duplicates** scans the whole project for drawables and texture variations with identical content and presents each group **with thumbnails and a 3D preview button**, so you can compare copies before anything is removed.
Choose which copy stays, keep intentional duplicates out of later scans, and optionally extend matching across genders or across drawables. Reservation dummies are never treated as duplicates, unique texture variations move to the copy you keep, and a drawable never loses its last variation.
{% hint style="info" %}
See [Cloth Analysis Report](/basics/essential-knowledge/cloth-analysis-report.md) documentation.
{% endhint %}
### 🏷️ Bulk metadata editing
Assign a **shop, price, restriction tags, creator info and behaviour options to many clothes at once**. Work on a selection, or narrow the whole project by gender, item kind or drawable type, then tick only the fields you want to write and review the affected and skipped counts before applying.
Existing per texture price overrides stay intact, and ordering fields are deliberately excluded so a bulk edit can never renumber or rename your items.
{% hint style="info" %}
See [Bulk Metadata Editing](/basics/good-to-know/bulk-metadata-editing.md) documentation. Requires an Ultimate subscription.
{% endhint %}
### 📸 Thumbnail Generator
Write thumbnails for the whole project into a folder of your choice and **keep that folder in sync** as your clothing changes. Pick the output folder, image format, background, camera, scope and naming template, then regenerate everything or sync only what changed.
The generator previews its plan first, shows cancellable progress with the remaining time, keeps the earlier file when a replacement fails, and **never removes a file it did not create**.
In-app list thumbnails and hover previews also got a faster, offline-capable renderer with clear queued, active and unavailable states.
{% hint style="info" %}
See [Thumbnails & Visual Exports](/basics/good-to-know/thumbnails-and-exports.md) documentation. Generated thumbnail files require Ultimate, while in-app previews stay free.
{% endhint %}
### ⌨️ Customizable keybindings
Every menu and context menu action can now be given a keyboard shortcut. Options has a **Keybindings** page listing every action with a description, where it applies and its current shortcut. DCT tells you which action already uses a key before you take it over, and menus show the shortcut actually in effect. **Build project** is on F5, **Options** on Ctrl+comma, and the 3D preview movement keys are finally editable.
{% hint style="info" %}
See [Shortcuts](/basics/useful-to-know/shortcuts.md) documentation.
{% endhint %}
### ⚡ Quality of Life improvements
* Cached list thumbnails and larger hover previews, generated offline and much faster
* **Shop prices, forced and variant items**, and a warning before a pack exceeds what the game shop list can hold
* Clothes with **embedded diffuse textures** work without an external texture file
* Auto-order, multi-item drag with an insertion line, and sequential bulk rename
* Per-project editor state, so reopening a project returns you where you were
* Error List and Project Logs with search, filters, exports and jump-to-item
* Signed Windows downloads naming the Schmid Software Solutions publisher
* Large projects stay responsive during saves, imports, loading, history and optimizer preparation
## v4 Full Changelog
```markdown
Breaking
- Projects saved by this version use format V8 and cannot be reopened by older Durty Cloth Tool builds. V5 through V7 upgrade automatically after a verified backup, older legacy formats stay readable, and new exports and item packages also require a build that understands the sealed format
- Projects opened without an active license are limited to 10 cloth drawables in total, alongside the existing limit of 5 per type and gender. A project made earlier that holds more no longer opens on the free tier until a license is active, and nothing in the project file is changed by the refusal
- Advanced tool options stay visible but read-only until the required license tier is active
Added
- Add Home with projectless Quick Look for clothing models, texture variations and cloth physics
- Add the Model Optimizer to reduce clothing model polygons and generate missing LOD levels, with a live 3D preview and a project-wide bulk mode
- Add the Texture Optimizer to scan every texture variation and embedded texture of the project, see what would change, and optimize them all in one run
- Add UV cropping and remapping to the Texture Optimizer, fixing ports that waste a huge texture on a tiny used area
- Add normal and specular map generation from a drawable diffuse texture
- Add automatic resource splitting of large builds into several coordinated resources by collection limits or deployable size
- Add multi-archive splitting for large singleplayer packs whose file names no longer fit one archive
- Add per-pack replacement of a known GTA DLC, base-game clothing, or a manually named collection
- Add the FiveM Enhanced build target with automatic Gen9 conversion of supported streamed assets
- Add a FiveM server resources folder assessment for combined clothing and streaming limit risks
- Add managed multi-resource Asset Escrow clothing for FiveM projects
- Add Project History with restore points and rollback of a project, drawable or texture variation
- Add Discord sign-in that keeps the Forge subscription and device license ready inside Durty Cloth Tool
- Add nine complete interface languages, following the Windows language on first start
- Add customizable keyboard shortcuts for every menu and context menu action
- Add drawable list filters, colour coded tags and sorting that never changes the project order
- Add Find duplicates with thumbnails and 3D preview review before removal
- Add reviewing and appending existing DCT projects, exports and built clothing resources
- Add bulk metadata editing for shop, price, restriction tags, creator info and behaviour options
- Add the Thumbnail Generator that writes project thumbnails into a folder and keeps it in sync
- Add cached thumbnails and larger hover previews for clothing and texture variations
- Add GLB model export of clothing variations individually, by drawable, or across the project
- Add still image rendering of clothing variations individually, by drawable, or across the project
- Add shop metadata prices plus forced and variant components or props per texture variation
- Add support for clothes whose diffuse textures are embedded in the drawable, without an external texture file
- Add YLD XML component mesh-physics attachment, conversion, packaging and building
- Add Release and Experimental update channels with in-app release notes and recovery
- Add the dockable workspace for the main window and live 3D Preview
- Add previewing several drawables on the ped at once, managed from the new Outfit tab
- Add YLD cloth physics simulation in the 3D Preview, with gravity, body collision and adjustable wind
- Add the Studio lighting preset as the new 3D Preview default
- Add custom ped support profiles with custom skeletons, body models and true base-slot unloading
- Add preview-only colour and material controls for the focused Legacy ped garment
- Add textured wireframe rendering of the selected clothing or prop
- Add clothing compatibility detection for invalid freemode rigs, unsupported high heels and hair materials without colour support
- Add removal of recent projects from Home and the Project menu
- Add the running version, channel, update state and unread release notes to the menu bar, and rotating tips during builds
- Add sorting the drawable list by the date an item was last changed
- Add ignored validation findings per item, texture variation or rule, saved with the project
- Add importing a Menyoo freemode character into the 3D Preview, including game clothes, props, head and face settings
- Add the Ped tab for changing game clothes and props directly in the 3D Preview
- Add generator and exact-build provenance to every GLB written by DCT
- Add saved hair colour and palette rows for item thumbnails
- Add closing a project and returning to Home without exiting DCT
- Add Live Texture Editing through an external image editor, with live preview refresh, explicit save or discard, PNG and DDS workflows, and unsaved-work protection
Fixed
- Fix builds emptying a non-empty output folder before the confirmation was shown, and wiping previous output when a build stopped on item errors
- Fix builds producing corrupt archives, invalid indexes, or manifests that reference missing files
- Fix project saves being cut short into an unreadable file, keep older auto-backups, and offer the newest backup when a project cannot be read
- Fix reselecting a shared project data folder moving or overwriting folders, and file dialogs opening invisibly behind the application
- Fix clothing with fully transparent textures never producing a thumbnail, which stalled preview generation
- Fix props in the 3D preview sitting away from their anchor, including while an animation plays
- Fix clothing packs spending shop metadata entries on items nothing can wear, and warn before a pack exceeds what the game can hold
- Fix Account & License not keeping the Forge profile current, and give the right recovery path when a license is missing, expired, unavailable or linked to another PC
- Fix Quick Look analysis projects failing to save, and errors reported when clicking quickly through Project History
- Fix hair alternates, tattoo gender hashes, decoration names and creature metadata drifting through builds
- Fix several edge cases in clothing imports, generated previews and project builds
- Fix valid licenses reloading the application state repeatedly during startup
- Fix licenses without an expiration date displaying incorrectly during startup
- Fix an intermittent launcher failure that left the launcher open after Durty Cloth Tool had started
- Fix installer Desktop and Start Menu shortcuts, and keep them opening the stable launcher after updates and channel changes
- Fix the What's New pane treating post-update release notes as read before the matching verified entry could be shown
- Fix protected builds failing to load update and What's New metadata, and failing signed update checks
- Fix settings upgrades running when the settings format had not actually changed
- Fix update status not surviving restarts
- Fix update and recovery prompts not distinguishing manifest-verified downloads from Windows publisher signing
- Fix reordering the drawable list crashing with an index error
- Fix texture resizing and mipmaps for supported ped normal and specular channels, with clearer unavailable map-generation actions
- Fix the 3D Preview quick animation control playing a different animation than the one selected
- Fix preview skin tone not staying on the selected tone across the complete outfit
- Fix account sign-in, refresh and activation staying busy indefinitely when a server stops sending its response
- Fix temporary Windows file locks during build cleanup and update checks
- Fix Reset simulation not recovering cloth physics after repeated instability pauses it
- Fix Remove Hairs and Custom Cut Hairs on head props omitting their required generated metadata
- Fix tattoo and facial-overlay builds continuing after a required texture cannot be prepared, and reserve room for those assets in large packs
- Fix moving or renaming a project and enabling shared paths so the original data remains until the new location is verified and saved
- Fix special characters and line breaks in project details and item names breaking generated resource metadata
Improved
- Improve Build Project so it is understandable at a glance and shows what the build is doing from setup through completion
- Improve the build destination and progress presentation, and move automatic project backups out of the editing path
- Improve the Build window so each option explains itself where you read it, with more predictable grouping
- Improve 3D preview responsiveness to selection, texture and base-component changes
- Improve Legacy ped clothing rendering with dedicated material paths instead of one opaque fallback
- Improve the 3D Preview's Animation tab with a verified quick select list, an easier custom animation workflow, and a clip dictionary that no longer freezes the app
- Improve the 3D Preview by explaining its less obvious controls in all nine languages and remembering which sections you left open, and remove the Capture section because the screenshot it produced was not correct
- Improve the 3D Preview with a centered hint while nothing is loaded and a small watermark in the corner
- Improve the 3D Preview with camera autofocus and skin-tone overlays
- Improve bulk texture and model optimizer plans so they scan faster, use the window space, and stay explorable before execution, and let a long Texture Optimizer scan be stopped from the window
- Improve large drawable list expanding, searching and scrolling
- Improve reordering and renaming clothing, with an insertion line showing where a dragged item will land and the active selection preserved
- Improve project reopening by remembering expanded groups, the active item and texture, and the selected details tab
- Improve large project imports, loading, history and optimizer preparation so the app stays responsive, with the loading stage counting the entries it works through
- Improve large project saves and build preparation with visible read-only progress
- Improve application startup speed, project opening progress, and the handoff from the startup screen
- Improve the Error List and Project Logs with search, multi-row copying, filters and flexible exports
- Improve Project Logs and the status bar to focus on outcomes rather than internal timing and lifecycle detail
- Improve texture discovery when importing models with unrecognised, bare, race-suffixed or genderless names
- Improve Check for Updates so it opens a rebuilt Updates page and runs the check where you can watch it
- Improve What's New readability and keep Experimental changes together by target release
- Improve Updates, Quick Look, garment previews and draft projects
- Improve the Ultimate guidance with an overview of the workflow and a direct path for existing subscribers to activate this PC
- Improve update checks and downloads with safe cancellation and clearer diagnostics
- Improve update delivery so installers, portable downloads and in-app updates come from one protected public update service
- Improve installed and portable builds by keeping settings, update state and licenses outside replaceable application files
- Improve protection against projects from a newer DCT format, which are now rejected before migration, autosave or rewriting
- Improve image creation and cached cloth previews by preparing a compatible browser component automatically
- Improve generated image exports with invisibly embedded creation markers
- Improve FiveM builds to account for patched clothing limits and GTA V builds 3717 and 3889
- Improve clarity by marking the alt:V and RageMP resource builders as deprecated
- Improve release automation so every official build is tested, license-checked and protected before download
- Improve unexpected-error reporting with an in-app reference instead of a GitHub submission flow
- Improve texture variation thumbnail generation by reusing the drawable mesh
- Improve Cloth Analysis with more reliable rigging advice, broader quality checks, per-item game-limit findings and direct repair actions
- Improve Find duplicates with a drawable-type filter and a clearer result surface
- Improve model reduction budgets and distribute reductions more evenly across separate garment parts
- Improve preview lighting, optimizer layouts and finding-driven repair setup, without changing saved optimizer rules when a repair is cancelled
- Improve preview tool behavior so interacting with the viewport does not close the tools when both can fit
- Improve UV optimization with separate-island packing and findings that clear when no worthwhile saving remains
- Improve large-project browsing with a flat appearance list, relevance search, cost sorting and item-scoped findings
- Improve Quick Look and Model Optimizer viewports with the 3D Preview camera controls
- Improve large-project imports, checks, thumbnails, scrolling and adaptive preview resource use
- Improve Quick Look, thumbnails and GLB exports with the 3D Preview's ped materials, tinting and fur rendering
- Improve Project History with affected-file details, model and texture changes, optimizer reasons and live-edit channels
Security
- Signature-check official update metadata before download, and hash-verify packages before apply or recovery
- Sign Durty Cloth Tool downloads with a verified Windows publisher, and let an installed build request Administrator permissions by itself
- Import project exports and item packages, and replace existing exports, without exposing files outside the selected destination
- Fail closed on unsafe filesystem links and aliases during build output cleanup and selected-item exports
- Keep detailed license diagnostics on this PC instead of attaching them to crash reports
- Apply free project item limits however items are added, and judge license expiry against the latest time Durty Cloth Tool has observed rather than the system clock
- Recover a license by itself after a hardware change, and cover one device at a time, so activating it elsewhere ends its use on the device it was previously installed on
- Retry exact retired-license cleanup after temporary file locks while preserving a replacement license
- Extend official release protection and package-integrity checks across every first-party executable component, including required native runtime dependencies
```
#### 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.2 (Experimental)
```markdown
Currently on the Experimental channel. Everything else listed above landed here.
- Home, projectless Quick Look and the faster startup handoff
- The dockable workspace, the rebuilt 3D Preview, Studio lighting, outfit preview, cloth physics with wind, hair colour controls and textured wireframe
- Live Texture Editing in your own image editor, with protected unsaved work and explicit save or discard
- Menyoo character import and direct game clothing, prop, head and face controls in the Ped tab
- The Model Optimizer, the Texture Optimizer, UV cropping and normal & specular map generation
- The rebuilt Build Project window, automatic resource splitting, per-pack replacement and the FiveM Enhanced target
- Project History and rollback, and the sealed V8 project format
- Discord sign-in with Account & License
- Nine interface languages
- Customizable keybindings, drawable list filters and tags, bulk metadata editing and the Thumbnail Generator
- Ignored findings, change-date sorting, Close project and richer Project History details
- The free tier limit of 10 drawables per project, and one device per license at a time
```
{% hint style="warning" %}
Experimental builds get features before they have been through a full release. Projects saved by an Experimental build use the V8 format and cannot be reopened by an older Release build. See [Updates & Channels](/basics/good-to-know/updates-and-channels.md).
{% 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](/basics/good-to-know/material-editor.md) documentation.
{% endhint %}
Durty Cloth Tool Material Editor Demo
### 🧵 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](/basics/good-to-know/embedded-textures-editor.md) documentation.
{% endhint %}
Durty Cloth Tool Embedded Textures Editor Demo
### 🖼️ 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.
Durty Cloth Tool Live Texture Editing / Previewing Demo
### 🧪 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
### ⚡ 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** @
\&#xNAN;*See our documentation for a how to get started:* [First Addon Tattoo](/getting-started/first-addon-tattoo.md)
Pleb Masters: Forge 3D Tattoo Editor Example Image
### 🕺 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](/basics/essential-knowledge/3d-preview-clothes.md#custom-animations))
3D Preview load and use Custom Animations
### 🛠️ 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](/getting-started/working-together.md)
New Project Sharing Project Settings
### 📂 File Format Linking
DCT now supports file associations for .dctproj, .dctpackage, and .dctexport formats. Open files directly from your file explorer for added convenience.
New File association DCT App Settings
### 🛍️ 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](/game-mechanics/shop-meta-file.md))
New Shop Meta Details Tab
### 🤖 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](/basics/good-to-know/app-and-project-settings.md#project-settings))
New Project Behaviour 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](/basics/good-to-know/integrated-search.md))
Improved 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](/basics/useful-to-know/creator-info.md))
New Creator Info Tab
### ⚡ 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](/basics/useful-to-know/themes.md)
New Themes available in DCT v3
### 🆕Error List Window
Very customizable and exportable overview of issues, tips and information on your Cloth Resource.
New Error List Overview available in DCT v3
### 🆕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.
Fully Customizable Project Settings
### 🗃️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 Export and Import Formats
### 👀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 Masks and Screen Effects demo
#### Prop Mask Example
See this article for an overview of all supported prop masks: [Prop Mask Models](/game-mechanics/prop-mask-models.md)
GTA V Prop Mask
#### First Person Options
New first person options, configurable timecycle modifier including intensity and prop mask models.
New First Person Options
### 🆕3D preview base components, animation quick select & auto rotate
Adjust any of the base components to be able to verify fitting of your cloth.
Adjust 3D preview base components, auto rotate and Animation Quick Select
Easily quickly test with various animation whether a clothing you have added is correctly rigged.
Demo on quickly testing Clothes with Animations
### 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.
Demo showing new High Heel 3D Preview with floor
### 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.
Demo showing new Hair Cutting in 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.
Demo showing Animation Playback Speed Control
### 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!
Demo showing changing of 3D Preview base Components
### 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 🔥
Demo showing 3D Previewing multiple Addon Clothes
### 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)
New Icons and Escrow Locked File indicator
### 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.
Target Game Build Selection with new Game Build option
### 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)
New Warnings & Informations added
### 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
New Hat Options
### 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.
Rename Cloth Texture dialog
### 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.
New Bulk exporting options
### 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.***
Showcasing new Projects handling
### ✨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
#### 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
### :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
### :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
### :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
### :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
### :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.
#### Example of generating different config files and viewing them in Visual Studio Code
### :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](/game-mechanics/game-limits-and-crashes.md)
### 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.
In Game Demo of a Addon Tattoo
Showcasing new Addon Tattoo Option in DCT
### 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
- 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.
**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**: \
Also visit our new website for this tool:
### 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
