> 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/live-preview-on-the-ped.md).

# Live Preview on the Ped

Link a document to a cloth and see your texture on the ped in Durty Cloth Tool's 3D Preview while you paint

## Introduction

The live preview shows your work on the cloth in Durty Cloth Tool's [3D Preview](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md) while you paint. Your document replaces one map of the cloth on the ped, the **Diffuse (colour)**, **Normal** or **Specular** map, and the ped updates a moment after each change. Nothing in your project changes until you save, see [Save to Cloth and History](https://docs.gta.clothing/plugins/creator-link/save-to-cloth.md).

**Applies to:** [Photoshop](https://docs.gta.clothing/plugins/creator-link/photoshop.md), [Photopea](https://docs.gta.clothing/plugins/creator-link/photopea.md), [GIMP](https://docs.gta.clothing/plugins/creator-link/gimp.md) and [Krita](https://docs.gta.clothing/plugins/creator-link/krita.md) work exactly as described here. [Blender](https://docs.gta.clothing/plugins/creator-link/blender.md) uses the same ideas with its own Title Case labels and adds models, see [Live Preview and Models](https://docs.gta.clothing/plugins/creator-link/blender/live-preview-and-models.md). [Substance 3D Painter](https://docs.gta.clothing/plugins/creator-link/substance.md) sends all maps of a texture set when you send them, see [Send Maps to the Ped](https://docs.gta.clothing/plugins/creator-link/substance/send-maps.md). The [Marvelous Designer](https://docs.gta.clothing/plugins/creator-link/marvelous.md) plugin works on clothing models and has no live preview.

{% hint style="info" %}
The live preview is part of **Durty Cloth Tool Ultimate**. Without it, the plugin says **Live preview is part of Durty Cloth Tool Ultimate.** with **See plans**.
{% endhint %}

## Before you start

* The plugin is signed in and connected, see [Sign In and Connect](https://docs.gta.clothing/plugins/creator-link/sign-in-and-connect.md).
* Durty Cloth Tool has a project open and a GTA V installation set up.
* The cloth is on the ped in the 3D Preview. You can start without it, but the plugin says **Put this cloth on the ped in Durty Cloth Tool to see it.** until you put it on.

## The linked cloth

**Linked cloth** at the top of the plugin shows what you work on:

* Durty Cloth Tool's picture of the cloth, its name and its variation, for example **Variation B**;
* one line with its type, gender, collection and number, for example **jbib · Female · mp\_f\_freemode\_01\_police · #13**;
* the open **Project**;
* the **Map**: **Diffuse (colour)** (**Diffuse** in Photoshop and Photopea), **Normal** or **Specular**. A map the cloth does not have is disabled, for example **This cloth has no normal map.**;
* how the document is linked: **Follows your selection in Durty Cloth Tool** or **Linked to this document**, with **Unlink**.

Until you select a cloth, the card says **Select a cloth in Durty Cloth Tool to work on it here.**, and without a project **Open a project in Durty Cloth Tool.**

In Photoshop, Photopea, GIMP and Krita the card can also show a **tattoo design** or a **facial overlay**: the last tattoo or overlay you put on the ped in Durty Cloth Tool, unless you selected a cloth after it. Its line starts with **Tattoo design** or **Facial overlay**, and only the colour map is offered. It has no model, so the UV tools and the 3D view of the item are not available for it. **Save to cloth** writes the picture back into the item; **Save as new variation** is not available. See [Edit in Connected App](https://docs.gta.clothing/plugins/creator-link/edit-in-connected-app.md#tattoo-designs-and-overlays).

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-838919232f4c549e6f7ee3cac0b6d0e964287e90%2Fkrita-docker-live.png?alt=media" alt="The Krita docker during a live preview: the linked cloth with its picture, the map choice, Live on the ped, Unsaved in project, and Save to cloth."><figcaption><p>A live preview in Krita. GIMP shows the same card and region; Photoshop and Photopea add Pause and their own tools, and Substance 3D Painter shows its maps to send.</p></figcaption></figure>

## Start a live preview

1. In Durty Cloth Tool, select the cloth and the texture variation you want to work on, and put it on the ped in the 3D Preview. Or start from Durty Cloth Tool with [Edit in Connected App](https://docs.gta.clothing/plugins/creator-link/edit-in-connected-app.md), which does steps 1 to 3 for you.
2. In the plugin, check the **Linked cloth** and choose the **Map** your document paints.
3. Select **Start live preview** and paint. The plugin shows **Live on the ped** and when the ped last updated, and the header says **Live**.
4. When you are happy, choose **Save to cloth**, **Save as new variation** or **Discard changes**, see [Save to Cloth and History](https://docs.gta.clothing/plugins/creator-link/save-to-cloth.md).

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-5891216681b94a001cabf7271d02e798a85eacb3%2Fcreator-link-poster.webp?alt=media" alt="Paint orange stripes on a black hoodie in Krita, watch them appear on the ped while you paint and turn the ped to check them, then keep them with Save to cloth."><figcaption><p>Paint orange stripes on a black hoodie in Krita, watch them appear on the ped while you paint and turn the ped to check them, then keep them with Save to cloth.</p></figcaption></figure>

{% embed url="<https://gta.clothing/assets/media/v4/creator-link-mobile.mp4?v=21383c789e95>" %}
Paint orange stripes on a black hoodie in Krita, watch them appear on the ped while you paint and turn the ped to check them, then keep them with Save to cloth.
{% endembed %}

**Stop live preview** ends the live preview without saving and the cloth shows its saved texture again. Your changes stay in your document, so you can start again and save them. Photoshop, Photopea and Blender also offer **Pause**, which stops sending for a moment; **Resume** sends everything you changed meanwhile.

While the live preview runs, the plugin marks your texture **Unsaved in project** until you save. Its state line tells you what happens:

| State                                                                                                       | Meaning                                                                               |
| ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| **Live on the ped**                                                                                         | Your document shows on the cloth.                                                     |
| **Put this cloth on the ped in Durty Cloth Tool to see it.**                                                | The cloth is not worn in the 3D Preview. Put it on.                                   |
| **The 3D preview is paused in Durty Cloth Tool.** (Photoshop and Photopea: **Paused in Durty Cloth Tool.**) | Durty Cloth Tool's 3D Preview is paused. Your changes show when it runs again.        |
| **Durty Cloth Tool closed. Your document is safe. Reconnecting…**                                           | The connection ended. The plugin connects again by itself when Durty Cloth Tool runs. |

## What each plugin sends

| Plugin               | What shows on the ped                                                                                        | Largest texture                                         |
| -------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------- |
| Photoshop            | The document as you see it, with all visible layers. The UV guide layer is left out.                         | Above 4096 pixels on a side, a scaled copy is previewed |
| Photopea             | The document as you see it, with all visible layers. The UV guide layer is left out.                         | Above 4096 pixels on a side, a scaled copy is previewed |
| GIMP                 | The layer that is selected when you start, at that layer's size. Its mask, opacity and mode are not applied. | 4096 by 4096 pixels                                     |
| Krita                | The whole visible image, with all visible layers merged.                                                     | 4096 by 4096 pixels                                     |
| Substance 3D Painter | The diffuse, normal and specular maps of the selected texture set, each time they are sent.                  | 4096 by 4096 pixels                                     |
| Blender              | The image you pick, after each paint stroke.                                                                 | 4096 by 4096 pixels                                     |

For normal and specular maps, the exact values matter. Each plugin's page says how to keep them exact in that editor, for example 8-bit sRGB documents in Krita and **Non-Color** images in Blender.

## Linked documents

Until a document is linked, the plugin **Follows your selection in Durty Cloth Tool**. The first live preview links the document to that cloth and map. Most editors store the link inside the saved document, so when you open it again later it links itself and its live preview goes to the same cloth, whatever is selected in Durty Cloth Tool. **Unlink** makes the document forget its cloth, and the next live preview follows your selection again.

| Plugin               | Where the link is kept                                         |
| -------------------- | -------------------------------------------------------------- |
| Photoshop            | In the PSD document                                            |
| Photopea             | Only while the document is open                                |
| GIMP                 | In the image, when you save it as `.xcf`                       |
| Krita                | In the document, when you save it as `.kra`                    |
| Substance 3D Painter | In the Painter project (linking marks the project as modified) |
| Blender              | In the image and the model, saved with the `.blend` file       |

Which cloth the card shows for a linked document differs:

* **GIMP, Krita and Substance 3D Painter** show the cloth the active document (or texture set) is linked to, also when another cloth is selected in Durty Cloth Tool.
* **Photoshop and Photopea** show the cloth selected in Durty Cloth Tool. When the active document belongs to another cloth, the card says **This document is linked to another cloth.**

### Open other maps of the cloth

In Photoshop, Photopea, GIMP and Krita, the **Map** choice of a linked document is a map picker (Blender has **Open a Map in Blender** for this): choosing another map opens that map of the same cloth from your project as a new document, already linked, and starts its live preview. While it opens, the plugin says so, for example **Opening the map from Durty Cloth Tool...**.

For a document of your own that is not linked yet, the map you choose is the one **Start live preview** links it to. Photoshop and Photopea also offer **Open ... as a new document** under the picker, which opens the cloth's own map instead.

The plugin opens the other maps of the cloth selected in Durty Cloth Tool, the cloth of a running live preview, or a cloth Durty Cloth Tool sent with **Edit in connected app**; for any other cloth it says **Select this cloth in Durty Cloth Tool to open its other maps.**

{% hint style="info" %}
Opening maps from your project is part of Durty Cloth Tool Ultimate.
{% endhint %}

### Switching documents

GIMP and Krita follow the image you work on (in GIMP, the image chosen in the plugin's window). A linked image shows its own cloth and offers **Start live preview**. A running live preview pauses while you work on another image, and the ped shows the saved texture meanwhile; it continues with its **Unsaved in project** marker when you switch back.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-8e1a4830ea7cd5c1c85ec18e0aee978cd21b9ff9%2Fkrita-docker-switched.png?alt=media" alt="The Krita docker saying that the live preview of jacket.kra is paused while you work on another document."><figcaption><p>Another linked document is active in Krita, so the first one's live preview waits.</p></figcaption></figure>

## What a plugin cannot edit

* Placeholders (dummy items), locked items, escrow-protected items and items that only exist for GTA V Enhanced. See [Placeholders/Dummy Ids](https://docs.gta.clothing/basics/good-to-know/placeholders-dummy-ids.md) and [Work with Asset Escrow Clothing](https://docs.gta.clothing/how-to-guides/use-asset-escrow-clothing.md).
* A map that another app is already editing. Each map of a cloth has one editor at a time.
* A cloth map that is open in [Live texture editing](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#live-texture-editing-preview) in the 3D Preview or in [Texture Studio](https://docs.gta.clothing/basics/good-to-know/texture-studio.md) at the same time. Finish or discard the other edit first.

{% hint style="info" %}
The 3D Preview shows a limited number of live previews at once. When Durty Cloth Tool says there are too many, stop one you no longer need. If the 3D Preview runs out of graphics memory for a live texture, it shows the saved texture instead: close other live textures or use a smaller document, then start the live preview again.
{% endhint %}

## When a live preview ends by itself

* You disconnect the app, sign Durty Cloth Tool out or switch account: the live previews of that app end and the cloth shows its saved texture again.
* Another project opens in Durty Cloth Tool, or the cloth is removed.
* Your license changes: the live previews that the new license no longer covers end.

## Troubleshooting

* **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 editing this map.**: stop the live preview in the other app, stop **Live texture editing** in the 3D Preview, or close the cloth in Texture Studio.
* **Too many live previews are open. Stop one first.**: stop a live preview you no longer need.
* **Durty Cloth Tool cannot edit this cloth** (or **this item**): the cloth is a placeholder, locked, protected or only for GTA V Enhanced.
* **The cloth or map this document belongs to is no longer in the project.**: unlink the document, select the cloth you want and start again.
* **Live preview is part of Durty Cloth Tool Ultimate.**: check in **Account & License** (or press **Ctrl+K** and paste `>Account & License`) that your Ultimate license is active on this computer.

See [Troubleshooting](https://docs.gta.clothing/plugins/creator-link/troubleshooting.md) for connection and sign-in messages.
