User Interface
Learn about our User Interface
Last updated
Was this helpful?
Learn about our User Interface
Last updated
Was this helpful?
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.
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 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 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, How to Register the License or general License Info.
Right Side Status: Indicates DCT Version and whether it recognized a license. Clicking on it will also open the License Info.
The workspace area is divided into multiple sections:
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.
Add options:
See below for details on the different add options.
🗑️ Remove: Delete selected appearance item(s) from the project.
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 for more details.
Add reservation dummy: This will allow for adding a dummy / placeholder clothing drawable for a specific gender. See Placeholders/Dummy Ids for more details.
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.
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.
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.
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.
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:
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.
-
Copy Name
Copies the displayed name of the appearance item.
-
Copy Game Name
Copies the appearance item's name in the format used by the game.
-
Copy File Path
Copies the file path of the selected appearance item.
-
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).
-
3D Preview Selected Cloth
Opens the 3D Previewer for the selected drawable and its first available texture.
Enter
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.
The footer provides additional actions and status information for managing your cloth project:
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 for details.
Settings: Opens the settings for the currently loaded Cloth Project. See App & Project Settings 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 for more details.
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 for more details.
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.
Regularly Save Projects: Always save your project frequently using the Project menu to avoid data loss.
Check the Error List: Before exporting your project, always review the Error List for any potential issues that could prevent successful exports.
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.
Search bar: The search bar allows users to quickly filter items by entering search terms. See Integrated Search for more details.
Import Package: Import existing packages containing multiple drawables, streamlining the workflow. See Import & Export Formats for more details.
Add: Add a new item automatically or for both gender.
Add Male: Add male-specific cloth drawables or tattoos.
Add Female: Add female-specific cloth drawables or tattoos.
Add from files/folders option in the " Add" dropdown will only work when the given file names contain gender information (like the multiplayer ped name).