👚
Durty Cloth Tool - Documentation
WebsitePricingDiscordDownload Latest
  • Welcome
  • Changelogs
  • Getting Started
    • Quickstart
    • License Activation
    • First Cloth Resource
    • Testing Addon Clothes
    • First Addon Tattoo
    • Working Together
    • Frequently Asked Questions
  • Basics
    • Essential Knowledge
      • User Interface
      • Build Options
      • 3D Previewing Clothes
      • Items Position Number
      • Cloth Analysis Report
      • Optimizing Clothes
      • Cutting Hairs
      • High Heels
      • Audio Presets
    • Good to know
      • App & Project Settings
      • First Person & Tint Effects
      • Integrated Search
      • Auto Cloth Data Resolving
      • Placeholders/Dummy Ids
      • Addon Tattoos
    • Useful to know
      • Shortcuts
      • Import & Export Formats
      • Creator Info
      • Dynamic Config Builders
      • Durty Cloth Projects
      • Logs
      • Themes
  • Game Mechanics
    • Game Limits and Crashes
    • Prop Mask Models
    • Mesh Physics (YLD)
    • Model Alternations
    • Drawable Types & Textures
    • Files Naming
    • Behaviour Flags
    • Shop Meta File
Powered by GitBook
On this page
  • Introduction
  • Top Navigation Bar
  • Main Workspace Area
  • Left Section - Appearance Items List
  • Right Section - Item Details
  • Reorder Cloth Drawable Textures via Drag and Drop
  • Context Menu Options
  • Context Menu Options for Appearance Items
  • Context Menu Options for Cloth Texture Variations
  • Footer Section
  • Action Buttons
  • Status Bar
  • Key Best Practices for Using the UI

Was this helpful?

  1. Basics
  2. Essential Knowledge

User Interface

Learn about our User Interface

PreviousEssential KnowledgeNextBuild Options

Last updated 5 months ago

Was this helpful?

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.

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

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.

  • Add options:

    See below for details on the different add options.

  • 🗑️ Remove: Delete selected appearance item(s) from the project.

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

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.

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.

Reorder Cloth Drawable 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.

Context Menu Options

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.

-

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

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

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

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

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

🔍
🗃️
⚧
👨
👩
⚧
Durty Cloth Tool UI Overview
Durty Cloth Tool Top Navigation Bar
Durty Cloth Tool Main Workspace Area
Reordering Cloth Texture Variations via Drag and Drop in Durty Cloth Tool
Showcase of the various Context Menu Options available in DCT
Durty Cloth Tool Footer Section