> 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/plugins/creator-link/blender/live-preview-and-models.md).

# Live Preview and Models

Paint a cloth's textures and edit its model in Blender while the ped in Durty Cloth Tool updates, then save into your project

## Introduction

With Blender connected to Durty Cloth Tool, the cloth you work on in Blender shows on the ped in the [3D Preview](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md) while you work:

* **Live Preview**: paint an image in Blender and it replaces the cloth's diffuse, normal or specular map on the ped after each paint stroke.
* **Push Model**: your Sollumz Drawable Dictionary replaces the cloth's model on the ped. With **Push Automatically**, on by default for a model opened from Durty Cloth Tool, it is sent again a moment after you stop editing, and **Update from Blender** in Durty Cloth Tool's 3D Preview fetches it on request.
* **Edit in connected app**: start from Durty Cloth Tool, and the cloth's model opens in Blender already linked to that cloth.

Nothing in your project changes until you choose **Save to Cloth**, **Save as New Variation** or **Save Model to Cloth**. Each save keeps a restore point in the cloth's [History](https://docs.gta.clothing/basics/useful-to-know/project-history.md).

The linked cloth, the live preview, saving and texture checks work as in every Creator Link plugin, see [Live Preview on the Ped](https://docs.gta.clothing/plugins/creator-link/live-preview-on-the-ped.md), [Save to Cloth and History](https://docs.gta.clothing/plugins/creator-link/save-to-cloth.md) and [Texture Checks](https://docs.gta.clothing/plugins/creator-link/texture-checks.md). This page describes the Blender panels and what only Blender does: painting images in Blender and pushing models.

### When to use it

* You want to repaint, retouch or recolour a cloth that is already in your project and judge the result on the ped, not on a flat texture.
* You want to reshape a model in Blender (fix clipping, change a collar, adjust the length) and see it on the animated ped after every change.
* You paint across seams in 3D and want the normal or specular map checked on the real cloth.

### When something else fits better

* For a logo, a name tape or a patch on an existing texture, [Texture Studio](https://docs.gta.clothing/basics/good-to-know/texture-studio.md) works without leaving Durty Cloth Tool.
* To edit a texture in any image editor without a plugin, use [Live texture editing](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#live-texture-editing-preview) in the 3D Preview.
* For a brand new cloth that is not in your project yet, use [Garment Fitting](https://docs.gta.clothing/plugins/creator-link/blender/garment-fitting.md) and [Add to a Durty Cloth Tool Project](https://docs.gta.clothing/plugins/creator-link/blender/add-to-a-project.md) instead. **Add as New Cloth** under **Link to DCT** takes you there for a model you made in Blender.

## Before you start

* Blender is connected and signed in, see [Blender](https://docs.gta.clothing/plugins/creator-link/blender.md#connect-for-the-first-time), and **Work On** at the top of the **DCT** tab is **Linked Cloth** (the default). Without a connection, the tab shows one line and **Connect** instead of the panels below.
* Durty Cloth Tool has a project open and a GTA V installation set up, because the preview appears in its 3D Preview.
* Live Preview, Push Model, saving, **Texture Checks**, the cloth's picture and opening its maps are part of **Durty Cloth Tool Ultimate**. Without it the panels say so in place, for example **Live preview is included in Durty Cloth Tool Ultimate.**
* Opening and pushing models needs [Sollumz](https://docs.sollumz.org) 2.8.0 or later. Textures work without it.

## Linked Cloth

The **Linked Cloth** panel shows what you work on:

* **Project:** the project open in Durty Cloth Tool.
* The cloth: Durty Cloth Tool's picture of it, its name, its variation (**Variation A**) and a line with its type, gender, collection and number, for example **jbib · Female · mp\_f\_freemode\_01 · #3**.
* **Follows your selection in Durty Cloth Tool** while the image you paint is not linked to a cloth yet, or **Linked to the image below** with an **Unlink** button once it is.
* **Open a Map in Blender** with a button for the cloth's **Diffuse**, **Normal** and **Specular** map. A map the cloth does not have is greyed out.

Until you select a cloth in Durty Cloth Tool, the panel says **Select a cloth in Durty Cloth Tool to work on it here.**

## Paint a texture live

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-6c98d45fcec6b44afba178817ba1e4109c1b92e6%2Fblender-live-preview.png?alt=media" alt="Blender&#x27;s DCT tab during a live preview of the hoodie Male 16 top: the linked cloth, Live on the ped, Pause and Send Now, the texture checks with no problems found, Save to Cloth, and the Model panel with Push Model and Push Automatically."><figcaption><p>A live preview: the ped updates after each paint stroke, and the texture checks show before you save.</p></figcaption></figure>

1. In Durty Cloth Tool, select the cloth and texture variation and put it on the ped. The **Linked Cloth** panel shows them.
2. In **Live Preview**, pick the **Image** (the eyedropper, **Use Painted Image**, picks the image you are painting on) and the **Map** it replaces: **Diffuse (Colour)**, **Normal** or **Specular**.
3. Select **Start Live Preview**. A progress bar shows while a large image is read for the first time.
4. Paint. The add-on reads the image when a paint stroke ends, so painting stays smooth, and the ped updates a moment later. For changes made without painting, such as baking or reloading, select **Send Now**.
5. Select **Save to Cloth**, **Save as New Variation** (Diffuse (Colour) only) or **Discard Changes**. **Stop Live Preview** ends the preview without saving; your changes stay in the Blender image, so you can start again and save them.

**Pause** stops sending changes for a moment, and **Resume** sends everything you changed meanwhile. While the preview runs, the state line says what is happening: **Live on the ped**, **Put this cloth on the ped in Durty Cloth Tool to see it.**, **The 3D preview is paused in Durty Cloth Tool.** or **Not saved in the project yet**.

{% hint style="info" %}
Only a diffuse map can become a new variation. Normal and specular maps belong to the model and are shared by every texture variation, so they can only be saved to the cloth.
{% endhint %}

### Start from the cloth's own texture

Under **Linked Cloth**, **Open a Map in Blender** opens that map from your project as an image named after the cloth, variation and map, for example `jbib_003_u A Normal`, links it to the cloth and starts its live preview. Normal and specular maps open as **Non-Color**. The image remembers its cloth and map, also in the saved .blend file, so its live preview always goes to that cloth, whatever is selected in Durty Cloth Tool; **Unlink** lets it follow your selection again.

### Colours and image rules

Colours arrive as they should when you:

* paint diffuse textures on **sRGB** images, the default for painting;
* set normal and specular maps to **Non-Color**. The panel warns when an image's colour space would change its values;
* paint on 8-bit images for exact colours. Everything arrives as 8 bits per channel.

{% hint style="info" %}
Images can be up to 4096 by 4096 pixels, in grey, RGB or RGBA. UDIM (tiled) images cannot be used, and only image files and generated images can be sent.
{% endhint %}

### Texture Checks

While the live preview runs, **Texture Checks** lists what Durty Cloth Tool found in your image, as an **Error**, **Warning** or **Note**, before you save. The **?** button next to a finding says how to fix it, and **Check Again** asks Durty Cloth Tool to check the image again. Fix errors before saving; warnings and notes are advice.

Every finding and its fix is listed in [Texture Checks](https://docs.gta.clothing/plugins/creator-link/texture-checks.md#findings-and-fixes), for example a size that is not a power of two, or a cloth whose alpha picks palette colours.

## Push a model

1. In Blender, select your Sollumz **Drawable Dictionary**, or any object inside it.
2. If the **Model** panel says **Link this model to a cloth in Durty Cloth Tool first: Link to DCT.**, the model is not linked to a cloth yet, and **Push Model** and **Push Automatically** are greyed out. Choose **Link to DCT**, then:

   * **Link to the Cloth Selected in DCT** links it to the cloth and variation selected in Durty Cloth Tool and pushes it there. Select the cloth in Durty Cloth Tool first.
   * **Add as New Cloth** opens the model in Garment Fitting, where [Add to a Durty Cloth Tool Project](https://docs.gta.clothing/plugins/creator-link/blender/add-to-a-project.md) adds it to your project as a new cloth and links it.

   The link is saved with the .blend file. A model opened from Durty Cloth Tool is linked already.
3. In the **Model** panel, select **Push Model**. The add-on exports the model with Sollumz together with its textures and shows it on the ped in Durty Cloth Tool. Your Sollumz export settings are used as you set them, except for a model opened from Durty Cloth Tool or added to your project from Blender: it is always sent the way Durty Cloth Tool stores that cloth.
4. Select **Save Model to Cloth** to save it in your project (Durty Cloth Tool keeps the previous model in the cloth's History), or **Discard** to drop it from the preview.

The panel says **Showing on the ped in Durty Cloth Tool. Save or discard it there or here.** while the pushed model is on the ped, and how many findings Durty Cloth Tool reported for it. **Save Model to Cloth** waits until Durty Cloth Tool shows your newest push, so it does not save an older version by mistake.

### Push Automatically

**Push Automatically** sends the model again once it has stayed unchanged for a moment (**Automatic Push Delay** under **Settings > Models**, 1.5 seconds by default). It is on when Durty Cloth Tool opened the model, or after **Link to the Cloth Selected in DCT**; if you turn it off in a scene, the add-on keeps it off there. Changes you make while a push is on its way are sent together in one push right after it. The **Model** panel shows **Updating Durty Cloth Tool…**, **Changes waiting** or **Up to date**. Textures are sent again only when they changed, so edits of the shape show quickly.

It waits while you are in Edit Mode or another mode, and while a tool such as a transform is running; the panel says what it waits for. When Sollumz reports warnings, automatic pushing pauses until you push by hand; Sollumz's Info log has the details. When a push takes longer than 10 seconds, automatic pushing pauses too and the panel says **Push manually, this model takes N s.**; a quicker push by hand turns it back on.

{% hint style="warning" %}
Durty Cloth Tool takes drawable dictionaries. If your Drawable is not in one, parent it to one with Sollumz's **Create Drawable Dictionary**. Texture and model file names may only use letters, digits, `_`, `-` and `.`, and every texture needs its own name. A model can carry at most 255 textures and 64 MiB. GLB models are not pushed; add them in Durty Cloth Tool with **Add from file(s)** instead, see [3D model import](https://docs.gta.clothing/basics/useful-to-know/import-and-export-formats.md#id-3d-model-import-experimental).
{% endhint %}

### Update from Blender

While a model pushed from Blender shows on the ped, Durty Cloth Tool's 3D Preview offers **Update from Blender** beside **Stop** on that model under **Live texture editing**, and in the command palette (**Ctrl+K**, then `>Update from Blender`). It asks Blender to push the model again now, with every change made since the last push, also when **Push Automatically** is off. When a push is already on its way, the update follows right after it. You can give it a shortcut in Durty Cloth Tool's keyboard shortcuts.

## Edit a model from Durty Cloth Tool

In Durty Cloth Tool, right-click a cloth or texture variation and choose **Edit and organize > Edit in connected app > Blender** (or press **Ctrl+K** and paste `>Blender`). Durty Cloth Tool puts the cloth on the ped, starts Blender if it is not running, and sends the model with its texture once the add-on is connected. The add-on connects by itself when Blender starts while **Connect Automatically** is on. See [Edit in Connected App](https://docs.gta.clothing/plugins/creator-link/edit-in-connected-app.md).

The add-on switches **Work On** to **Linked Cloth**, imports the model with Sollumz, using your Sollumz import settings, selects the new Drawable Dictionary, links it to its cloth and turns on **Push Automatically**, so every change you make shows on the ped. A cloth that follows the body opens on the ped's skeleton, so it keeps its bone weights and you can pose it. The **Model** panel shows **Linked to** and the model with the cloth's name, and offers **Unlink**. A model linked this way always goes to its cloth, whatever is selected in Durty Cloth Tool, also after you save and reopen the .blend file. Save it with **Save Model to Cloth** as usual.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-69e856d1abc0ee02ff4aeb1f41b4f357f0003ffe%2Fblender-opened-from-dct.png?alt=media" alt="Blender&#x27;s DCT tab after Durty Cloth Tool sent the hoodie Male 16 top: the image linked to its diffuse map, and the model opened from Durty Cloth Tool, linked to the cloth, showing on the ped and Up to date with Push Automatically on."><figcaption><p>A map and a model opened from Durty Cloth Tool, each linked to its cloth.</p></figcaption></figure>

{% hint style="info" %}
A copy made with **Duplicate** carries the link too. The **Model** panel then says that both are linked to the same cloth; unlink the one that should not be, because each cloth takes one model.
{% endhint %}

Without Sollumz, or with a Sollumz that is too old, Durty Cloth Tool says that something Blender's plugin needs is missing, and the **Model** panel says what to install. When Sollumz reports errors while importing, the model is not linked; its Info log has the details.

## What you cannot edit from Blender

* Placeholders (dummy items), locked items, escrow-protected items and items that only exist for GTA V Enhanced. The add-on says **Durty Cloth Tool cannot edit this item (dummy, locked or protected).**
* A map or model that another app is already working on. Stop the other edit first.
* A cloth map that is open in **Live texture editing** in the 3D Preview or in Texture Studio at the same time.

See [Live Preview on the Ped](https://docs.gta.clothing/plugins/creator-link/live-preview-on-the-ped.md#what-a-plugin-cannot-edit) for the rules every plugin shares.

## Troubleshooting

* **Start Live Preview is greyed out**: the line below it says why, for example **Choose an image first.**
* **Put this cloth on the ped in Durty Cloth Tool to see it.**: put the cloth on the ped in the 3D Preview.
* **Another app is already working on this texture or model.**: stop the live preview in the other app, or end **Live texture editing** or Texture Studio for that cloth.
* **Too many live previews are open. Stop one first.** or **Durty Cloth Tool's live preview memory is full.**: stop a live preview you no longer need.
* **The image size changed. Start the live preview again.**: start it again after resizing.
* **Push Model is greyed out or refused**: install and enable Sollumz, select a Drawable Dictionary or an object inside one, and link it with **Link to DCT** if the panel asks for it. Hover the button to see why.
* **Link to the Cloth Selected in DCT is greyed out**: select a cloth and a variation in Durty Cloth Tool first.
* **Push manually, this model takes N s.**: the model is too heavy for automatic pushes; push it with **Push Model**, or **Update from Blender** in Durty Cloth Tool, when you want to see it.
* **Blender no longer holds this model. Push it again from Blender.** (in Durty Cloth Tool's status bar): the model was discarded or Blender disconnected; push it again from Blender.
* **Save Model to Cloth is greyed out**: a push is on its way. Saving becomes available once Durty Cloth Tool shows it.
* **Sollumz reported warnings**: check Sollumz's Info log, fix the model, then push again.
* **Durty Cloth Tool could not use this model**: check the model in Sollumz and push again.
* **Durty Cloth Tool says Blender is busy** when you send a model: a live preview is running or saving, or a model is being pushed. Stop it, then choose **Edit in connected app** again.
* **A model opened from Durty Cloth Tool is not linked**: Sollumz reported errors while importing it. Check Sollumz's Info log.
* **This is included in Durty Cloth Tool Ultimate.**: check in **Account & License** in Durty Cloth Tool (or press **Ctrl+K** and paste `>Account & License`) that your Ultimate license is active on this computer.
