> 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/basics/essential-knowledge/user-interface.md). # User Interface Learn about our User Interface ## Introduction **Durty Cloth Tool** provides a clean and straightforward interface designed to streamline the process of managing and creating GTA 5 addon clothing packs. Below is a breakdown of the various elements within the user interface to help you get started.

Durty Cloth Tool UI Overview

{% hint style="info" %} Durty Cloth Tool opens on **Home**, which brings together new, open, recent, import and built resource starting points, and can inspect a clothing file without creating a project at all. See [Home & Quick Look](/basics/useful-to-know/home-and-quick-look.md). {% endhint %} ## Workspace layout The Appearance Items list, the 3D Preview, the Error List and the Project Logs form a dockable workspace. Each can be docked, floated, auto-hidden, hidden and reopened from the **View** menu. Your layout is saved per user with a recovery backup, and **View > Reset Workspace Layout** restores the defaults. Those defaults adapt to your screen, so the workspace stays usable on a laptop as well as on a large display. ## Top Navigation Bar

Durty Cloth Tool Top Navigation Bar

The top navigation bar contains several important tools for managing projects and configuring settings. Here's an overview of each element: * **Project**: This menu provides options for creating a new project, saving, opening existing projects, and exporting them. The status of the project, such as "saved," is also displayed in the window title. See [Durty Cloth Projects](/basics/useful-to-know/durty-cloth-projects.md) for Cloth Project related details. * **Options**: Access global settings for the tool. This includes preferences for the working environment, such as the 3D previewer and more.\ See [App & Project Settings](/basics/good-to-know/app-and-project-settings.md) for App Options and Project Settings related details. * **View**: This grants quick access to open different views such as the Logs or Error List window for example. See their individual documentations for more details. * **Help**: Find useful links and information such as the Website, Documentation, What's New, Check for Updates and **Account & License**. * **Version and updates**: The subtle version indicator shows the installed DCT version and the state of the configured Release or Experimental update channel. An indicator beside **What's New** appears when relevant release notes have not been read yet. * **Right Side Status**: Shows your Forge display name and avatar when you are signed in, even without an active license. Active licenses receive a shield indicator, while Ultimate receives a crown and sparkle treatment. Clicking the status opens **Account & License**. ## Main Workspace Area

Durty Cloth Tool Main Workspace Area

The workspace area is divided into multiple sections: ### Left Section - **Appearance Items List** This is where the cloth drawables (clothing models), tattoos and more are managed. You can search, add, and remove these items from the project here. Durty Cloth Tool remembers the expanded groups, active item and texture, and selected details tab locally for each project. Reopening a project returns you to the same working context without storing that personal state in the project file. The list can be filtered by gender, item kind, drawable type, skin type, findings, file state and your own colour coded tags, and sorted without changing the project order. See [Drawable Filters & Tags](/basics/good-to-know/drawable-filters-and-tags.md). * :mag: **Search bar**: The search bar allows users to quickly filter items by entering search terms.\ See [Integrated Search](/basics/good-to-know/integrated-search.md) for more details. * :card\_box: **Import Package**: Import existing packages containing multiple drawables, streamlining the workflow.\ See [Import & Export Formats](/basics/useful-to-know/import-and-export-formats.md) for more details. * **Add options**: * :transgender\_symbol: **Add**: Add a new item automatically or for both gender. * :man: **Add Male**: Add male-specific cloth drawables or tattoos. * :woman: **Add Female**: Add female-specific cloth drawables or tattoos. *See below for details on the different add options.* * 🗑️ **Remove**: Delete selected appearance item(s) from the project. Press **F2** to rename the current item with its existing name selected. When multiple drawables or multiple texture variations are selected, DCT opens a sequential rename workflow and shows each current item in the 3D preview while you work through the selection. #### Available Add Options * **Add from DCT package:** If available this is always the best option to add anything, as it will contain all information of one or multiple items, including textures and additional naming information. * **Add from file(s):** This will open a file picker dialog that allows for selecting one or multiple files to add them to the current cloth project. * **Add from folder(s):** This will open a folder picker dialog that allows for selecting one or multiple folders that will be recursively searched for any files that can be added. * **Add tattoo:** This will add any texture / image file as a tattoo to the project for either a specific gender or both genders.\ See [Addon Tattoos](/basics/good-to-know/addon-tattoos.md) for more details. * **Add reservation dummy:** This will allow for adding a dummy / placeholder clothing drawable for a specific gender.\ **See** [Placeholders/Dummy Ids](/basics/good-to-know/placeholders-dummy-ids.md) for more details. {% hint style="warning" %} Add from files/folders option in the ":transgender\_symbol: **Add**" dropdown will only work when the given file names contain gender information (like the multiplayer ped name). {% endhint %} {% hint style="info" %} **Like the default windows file and folder picker more?** You can switch to the legacy windows file explorer using a option in the App Options window. {% endhint %} ### Right Section - Item **Details** This is where detailed information about the selected item appears. Once a drawable or tattoo is selected from the list, its attributes and properties can be modified in this panel. {% hint style="info" %} As the options here differ depending on what kind of item is selected and what type of drawable it is, please refer to individual features documentation on the left side. {% endhint %} ### Reordering drawables and textures via Drag and Drop It is possible to conveniently reorder Cloth Texture Variations using drag and drop. In order to do so grab the texture you want to reposition in the same Cloth Drawable and reposition it. Drawables can be dragged too. Both lists show an **insertion line** at the edge of the row under the pointer, on the side the drop will use, so you can see exactly where the item will land. The line disappears as soon as the pointer leaves a valid target. * **Multiple drawables** can be dragged at once. The project order within the same gender and clothing type is preserved. * **Multiple texture variations** can be reordered together. * **Auto-order selection** in the context menu turns a selection into a contiguous block of positions.

Reordering Cloth Texture Variations via Drag and Drop in Durty Cloth Tool

{% hint style="info" %} Reordering is refused while a project is still being prepared after opening, and DCT says so. Selection and 3D Preview keep working during that stage. {% endhint %} ## Context Menu Options

Showcase of the various Context Menu Options available in DCT

Durty Cloth Tool provides a wide range of **Context Menu Options** to streamline workflow and provide quick access to essential actions. These options are available by right-clicking on **appearance items** in the left panel or **cloth texture variations** in the texture list. Below is a breakdown of the available actions: ### **Context Menu Options for Appearance Items** | **Action** | **Description** | **Shortcut** | | ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | | **Remove** | Deletes the selected appearance item without removing the actual `.ydd` file on disk. | `Del` | | **Replace** | Replaces the source file with a new updated file, useful for updating models with fixed versions. | `Ctrl+H` | | **Replace with Dummy** | Replaces the appearance item with a dummy file to prevent drawable ID shifts. | `Ctrl+J` | | **Create Copy for Other Gender** | Duplicates the selected clothing and its textures for the opposite gender. | - | | **Show in Windows Explorer** | Opens the file's location in Windows Explorer. | `Ctrl+E` | | **Export as DCT Package** | Exports the appearance item as a Durty Cloth Tool-compatible package. | - | | **Export** | Creates a copy of the source file and exports it to a desired location. | - | | **Export with Textures** | Exports the source file along with all its textures. | - | | **Export XML** | Exports the appearance item in XML format, compatible with tools like CodeWalker. | - | | **Export Textures as DDS** | Exports all embedded textures in DDS format. | - | | **Export Textures as PNG** | Exports all embedded textures in PNG format. | - | | [Material Editor](/basics/good-to-know/material-editor.md) | Opens the Material Editor for the selected drawable to view and edit shader and parameters. | `Ctrl+M` | | [Embedded Textures Editor](/basics/good-to-know/embedded-textures-editor.md) | Opens the editor to view/replace/rename/delete embedded textures and auto-fix shader params. | - | | **Copy Name** | Copies the displayed name of the appearance item. | `Ctrl+Shift+C` | | **Copy Game Name** | Copies the appearance item name in the format used by the game. | `Ctrl+Alt+C` | | **Copy File Path** | Copies the file path of the selected appearance item. | `Ctrl+Shift+P` | | **Optimize Embedded Textures** | Opens options to optimize textures embedded in the model automatically. | `Ctrl+O` | | **Fix Invalid Fixup File** | Attempts to fix invalid fixup issues on optimized models (experimental feature). | - | | **Optimize model (polygons, LODs)** | Opens the [Model Optimizer](/basics/essential-knowledge/model-optimizer.md) for the selected drawable. | `Ctrl+Shift+M` | | **Optimize UV mapping** | Crops wasted UV space and remaps the mesh UVs. See [Texture Optimizer](/basics/essential-knowledge/texture-optimizer.md). | - | | **Generate normal & specular maps** | Derives the missing maps from the diffuse. See [Normal & Specular Maps](/basics/good-to-know/normal-and-specular-maps.md). | - | | **Generate thumbnails** | Writes thumbnail files for the selected items. See [Thumbnails & Visual Exports](/basics/good-to-know/thumbnails-and-exports.md). | - | | **Bulk edit metadata** | Edits shop, price, tags, creator and behaviour across many items. See [Bulk Metadata Editing](/basics/good-to-know/bulk-metadata-editing.md). | `Ctrl+B` | | **Auto-order selection** | Turns the selected drawables into a contiguous block of positions. | - | | **Show drawable findings** | Opens the Error List filtered to this item. | - | | **View history...** | Opens [Project History](/basics/useful-to-know/project-history.md) for this item. | - | | **Remove all tags** | Clears every tag from the selected items. | - | | **Export variations as GLB** | Exports the drawable variations as GLB models. | - | | **Rename** | Renames the item with its existing name selected. | `F2` | | **3D Preview Selected Cloth** | Opens the 3D Previewer for the selected drawable and its first available texture. | `Enter` | | **3D preview selected clothes together** | Puts a multi-selection on the ped at once, one drawable per component slot. | `Shift+Enter` | | **Add to 3D preview** | Adds the selection to the outfit already on the ped. | `Ctrl+Enter` | ### **Context Menu Options for Cloth Texture Variations** | **Action** | **Description** | **Shortcut** | | ----------------------------- | ---------------------------------------------------------------------------- | ------------ | | **Remove** | Deletes the selected texture variation without removing the `.ytd` file. | `Del` | | **Rename** | Opens a dialog to rename the selected texture for better organization. | `F2` | | **Replace** | Replaces the selected texture file with an updated version. | `Ctrl+H` | | **Replace with Dummy** | Replaces the texture variation with a dummy file to avoid texture ID shifts. | `Ctrl+J` | | **Show in Windows Explorer** | Opens the location of the texture file in Windows Explorer. | `Ctrl+E` | | **Export** | Creates a copy of the texture file and exports it to a desired location. | - | | **Export XML** | Exports the texture in XML format, compatible with CodeWalker. | - | | **Export DDS** | Exports all texture images in DDS format. | - | | **Export PNG** | Exports all texture images in PNG format. | - | | **Copy Letter** | Copies the prefix of the selected texture. | - | | **Copy Game Name** | Copies the texture name in the format expected by the game. | - | | **Copy File Path** | Copies the file path of the selected texture. | - | | **Optimize Texture** | Opens options to automatically optimize the selected texture. | `Ctrl+O` | | **3D Preview Selected Cloth** | Opens the 3D Previewer for the selected drawable and its associated texture. | `Enter` | These context menu options are tailored to enhance usability, allowing quick and efficient management of appearance items and textures directly within the tool. ## Footer Section

Durty Cloth Tool Footer Section

The footer provides additional actions and status information for managing your cloth project: ### Action Buttons * **Error List**: This button opens the error window, giving an overview of any issues, errors and tips generated for your current Cloth Project.\ See [Cloth Analysis Report](/basics/essential-knowledge/cloth-analysis-report.md) for details. * **Settings**: Opens the settings for the currently loaded Cloth Project.\ See [App & Project Settings](/basics/good-to-know/app-and-project-settings.md) for more details. * **Build Project**: This button is crucial when you're ready to export your project. It compiles all the items, checks for issues, and packages them for use in your preferred target GTA 5 multiplayer or Singleplayer.\ See [Build Options](/basics/essential-knowledge/build-options.md) for more details. ### Status Bar At the very bottom of the tool, there is a status bar that will always display the most recent log entry. Clicking on it will open the logs window with all logs for the currently loaded Cloth Project. See [Logs](/basics/useful-to-know/logs.md) for more details. ## Key Best Practices for Using the UI 1. **Utilize Search Filters**: When working with large projects, use the search bar in the Appearance Items List to quickly find and locate specific clothing items. 2. **Regularly Save Projects**: Always save your project frequently using the **Project** menu to avoid data loss. 3. **Check the Error List**: Before exporting your project, always review the **Error List** for any potential issues that could prevent successful exports. 4. **Explore the Settings**: Customize the tool to suit your workflow by exploring the **App & Project Settings** menu. *** This documentation provides a high-level overview of the user interface. For in-depth guidance on specific workflows, refer to individual documentation pages on the Basics section.