> 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/good-to-know/app-and-project-settings.md). # App & Project Settings Learn about our App & Project Settings ## Introduction The Durty Cloth Tool provides two distinct sets of settings to fine-tune both the application's behavior and project-specific configurations. These are divided into **App Settings** and **Project Settings**.

Durty Cloth Tool App Options & Project Settings

## **App Settings** App settings are user-specific preferences that influence the overall operation of the Durty Cloth Tool. These settings persist across sessions and apply to all projects that you work on. It can be opened by clicking the top navigation "⚙️ Options" menu item.

Durty Cloth Tool App Options Window

Below are the sections available in the App Settings window: {% tabs %} {% tab title="General Settings " %} **App** * **Reopen last opened project automatically on startup**\ If enabled, the last saved project will be automatically opened when the tool starts. * **Reset saved window settings**\ This button resets the window size, grid splitter positions, and other saved UI configurations. * **Clear 'Recent Projects' history**\ Clears the list of recently opened projects from the tool. You can also remove one entry directly from the Home window or **Project > Recent Projects**. This only removes the shortcut from DCT and never deletes the project or its files. Opening the project again restores it to the list. **File Association and Link Status** This option displays the current status of the app's linkage to any DCT-related file formats such as `.dctproj`, `.dctpackage`, and `.dctexport`.\ It allows users to conveniently open DCT files or perform related actions directly from the file system without navigating the tool. * **Enable File Associations and Links Checkbox**: Toggles the linking feature on or off. * **Status Display**: Indicates whether the associations are functional, need fixing (e.g., after moving the DCT installation), or are disabled. **Prefer Windows File Dialogs**\ \ By enabling this, the tool will use the default Windows file dialog instead of the themed dialogs, which may help avoid issues with visual styles, especially at night. **GTA V Installation**\ \ You must specify your GTA V installation path here. The tool requires this path for running the 3D previewer. * Option to reselect or change the installation folder is provided if needed. **Language** Durty Cloth Tool is available in nine languages: **English**, **German**, **French**, **Russian**, **Spanish**, **Brazilian Portuguese**, **Simplified Chinese**, **Hindi** and **Arabic**. On first start DCT follows your Windows language if it is one of those, and English otherwise. After that your choice here is remembered. Windows, dialogs, messages, findings, the logs shown inside the app, the settings search, the preview controls and the launcher prompts all follow it. {% hint style="info" %} Saved support logs, crash reports, file names and generated game resources deliberately stay **English**, so diagnostics and build output are consistent no matter which language you use. {% endhint %} **Theming** * **Theme & Color Variation**\ Allows users to choose the theme for the UI (e.g., "Office") and select a color variation such as "Dark" or "Light" to customize the appearance. {% endtab %} {% tab title="Items Settings" %} **General** * **Don't automatically select newly added clothes/items**\ Prevents the tool from auto-selecting items that have just been added to the list. * **Automatically update 3D previewed cloth/texture**\ Automatically refreshes the 3D previewer whenever a new cloth or texture is selected. * **Fill unused item positions**\ When adding new items, this option tries to fill any gaps or unused positions, keeping the drawable order cleaner. * **Resort item positions**\ Reorganizes the items list based on specific criteria. **3D Previewer** * **Adaptive preview rendering**\ Enabled by default. Static scenes draw when something changes, while animation, cloth and camera movement keep rendering. Hidden previews always pause. Turning this option off keeps a visible preview rendering continuously. * **Disable missing diffuse texture information**\ This option disables warnings about missing diffuse textures in the 3D previewer. * **Show the Durty Cloth Tool watermark in the 3D preview**\ Controls the small translucent logo in the bottom-right corner of the viewport. Turning it off requires an **Ultimate** license; without one the checkbox is disabled and the watermark stays. Generated thumbnails are unaffected either way. **Cloth Textures:** * **Show Cloth Textures Preview Icon / Thumbnail in list**\ Enables or disables the generation of texture preview icons in the drawable list.\ Keep in mind that this may slow down performance. {% hint style="info" %} The thumbnail and hover preview settings for a project live in the **Project Settings**, and the options that write thumbnail **files** to a folder live in the Thumbnail Generator under **Project > Project Actions**. See [Thumbnails & Visual Exports](/basics/good-to-know/thumbnails-and-exports.md). {% endhint %} {% endtab %} {% tab title="Updates" %} Shows the channel you are running and the channel you have selected, along with compatibility information and the Experimental warning. The page leads with a **status card** telling you whether you are up to date, when the last successful check happened, and the one action your current state calls for. **Check for Updates** anywhere in the app opens this page and starts a check here. See [Updates & Channels](/basics/good-to-know/updates-and-channels.md) for the full picture. {% endtab %} {% tab title="Keybindings" %} Lists every menu and context menu action with a description, where it applies and its current shortcut. Change, clear or reset any of them, or reset them all. See [Shortcuts](/basics/useful-to-know/shortcuts.md). {% endtab %} {% endtabs %} ## **Project Settings** Project settings are saved with the currently loaded project and control specific rules, warnings, validations, and output configurations for the project. They can be either accessed via the View top navigation menu item or on the buttom the "⚙️ Settings" button.

Durty Cloth Tool Project Settings Window

{% tabs %} {% tab title="General" %} **Project** * **Name**\ The name of the project. This is used for both the project folder and internal project-related files. Keep it simple, avoiding special characters and uppercase letters. * **Author (optional)**\ An optional field for specifying the name of the project’s author. This will be included in the cloth build files if provided. * **Version (optional)**\ An optional field to specify the version of the project. If entered, this version will be included in the generated build files. * **Description (optional)**\ An optional field for notes or information about the project. * **DLC Name**\ The name used in-game for this project. As with the project name, keep it simple and without special characters. * **Output Folder**\ This is the parent folder for the project's `clothproject_` data folder. Save the project before changing it. DCT asks before moving existing data, checks the copy, and saves the new location before cleaning up the original. An occupied destination is left untouched. See [Project Folder Relocation](/basics/useful-to-know/durty-cloth-projects.md#project-folder-relocation). **Behavior** * **Automatically save one up-to-date project backup**\ If enabled, the tool will automatically save a backup of the current project every minute whenever unsaved changes are detected. These backups allow you to recover from crashes or unintended changes. If a backup with a newer timestamp than the last save exists, the tool will prompt whether to restore the backup. * **Automatically replace with dummies on remove**\ When enabled, removing items will replace them with dummy placeholders to maintain drawable ID order. Removing these placeholders will completely delete the items. * **Automatically replace dummies when adding clothes**\ If enabled, new items added to the project will replace any existing dummy placeholders, rather than being appended to the end of the list. * **Use texture name as unique name hash in Shop Meta dump**\ When enabled, the generated Shop Meta dump will derive the `uniqueNameHash` from the texture name, which can simplify downstream mapping in scripts or tooling. **Thumbnails in the lists:** * **Show thumbnails in the drawable and texture lists**\ Enables the cached thumbnails and hover previews for this project. New projects have this on. The cache is disposable and can be cleared and rebuilt at any time. * **Size in lists:**\ The thumbnail size in the lists, from 24 px to 64 px. * **Hover preview size:**\ The size of the larger preview shown on hover, from 64 px to 512 px. {% hint style="info" %} Writing thumbnail **files** to a folder is a separate feature, the Thumbnail Generator under **Project > Project Actions**. See [Thumbnails & Visual Exports](/basics/good-to-know/thumbnails-and-exports.md). {% endhint %} {% endtab %} {% tab title="Sharing and Collaboration" %} The **Sharing and Collaboration** tab contains settings that enable and facilitate sharing Durty Cloth Projects through version control systems like Git. These settings ensure project consistency across different systems and users while maintaining flexibility for individual build environments. **Settings Overview** * **Force relative file paths to allow for sharing this Project**\ Enables relative paths for the cloth project. This adjusts the cloth project output folder to be relative to the `.dctproj` file, ensuring compatibility when sharing the project. Additionally, it forces build output locations to be saved per user, avoiding conflicts when the project is used across different systems. * **Sharing is enabled (Status Indicators):**\ Displays the current status of the project’s setup for sharing. The following indicators confirm the readiness for sharing: * **Project File Created and Setup:** Indicates that the `.dctproj` file exists and is properly configured. * **Cloth Project Folder is relative to Project File:** Confirms that the project folder's path is relative, allowing it to be shared seamlessly. * **User Specific Build Output is active:** Ensures that each user has their own build output location, preventing overwrite issues during collaboration. * **Relative Output Folder**\ Displays the current relative output folder path for the project. * This folder is determined based on the location of the `.dctproj` file. * To share the project effectively, ensure the `.dctproj` file and the associated project folder remain in the same relative structure. These settings ensure that collaborative workflows with Durty Cloth Projects are smooth and compatible with tools like Git, making it easier for teams to work on projects together without path-related issues. {% hint style="info" %} See [Working Together](/getting-started/working-together.md) for a more hands on documentation on how to collaborate on a Durty Cloth Project with your team. {% endhint %} {% endtab %} {% tab title="Warnings and Validations" %} This section provides rules and settings to help ensure the integrity of the cloth project and the compatibility of resources with the game engine. **General Warnings** * **Disable 'Reached max drawables for type' warning**\ Disables DCT's warning at 128 drawables for one gender/type. It only hides the warning; larger resources may still be incompatible with the target platform. * **Disable 'Total props per gender limit reached' dialog**\ Suppresses DCT's legacy 255 total props-per-gender warning. Only disable it when your target platform supports more props; the setting itself does not raise the limit. See [Game Limits and Crashes](/game-mechanics/game-limits-and-crashes.md#id-255-global-prop-index-boundary). * **Disable automatic file check for existing duplicates**\ Stops the tool from checking for file duplicates during startup. * **Always import duplicates without any confirmation**\ When enabled, the tool will allow duplicate imports without prompting for confirmation. However, it will still print a log entry about the duplicates. **Texture Optimizer** * **Automatically select DirectX 11 compatible formats**\ Ensures that texture compression formats compatible with DirectX 11 are selected automatically. This is only recommended if all users playing on a server can be ensured to have DX11 or newer. **Validation Rules** * **Enable or Disable Validation Rules**\ Allows you to turn off specific validation rules that the tool uses to check your project for potential issues. * **Information Levels (Warning, Error, Message)**\ Each rule can be configured to trigger a different severity level, whether a Warning, Error, or just a Message. * **Configurable Thresholds**\ Some rules allow thresholds to be set, such as: * **Model File Size Exceeded** * **Excessive Texture Dimensions** * **Maximum Polygons for High, Medium, Low LODs** Clicking "Rerun all validations" will apply any adjusted settings immediately and recheck the project based on the active rules and thresholds. {% endtab %} {% endtabs %} ## Summary These settings provide you with extensive control over how the tool functions and how your projects are validated and built. The App Settings are user-specific, while the Project Settings apply to the currently loaded project and provide a structured way to maintain the quality and compatibility of your cloth projects.