> 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/save-to-cloth.md).

# Save to Cloth and History

Save a texture from your editor into the cloth with a History restore point, add it as a new texture variation, or discard it

## Introduction

A live preview only changes what the ped shows. When you like the result, the plugin writes it into your Durty Cloth Tool project, with a way back: every **Save to cloth** keeps the previous texture as a restore point in the cloth's [History](https://docs.gta.clothing/basics/useful-to-know/project-history.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) as described here. [Substance 3D Painter](https://docs.gta.clothing/plugins/creator-link/substance.md) saves every map it shows at once and names the variation button **Save diffuse as new variation**. [Blender](https://docs.gta.clothing/plugins/creator-link/blender.md) uses Title Case labels (**Save to Cloth**, **Save as New Variation**, **Discard Changes**) and also saves models with **Save Model to Cloth**, see [Live Preview and Models](https://docs.gta.clothing/plugins/creator-link/blender/live-preview-and-models.md). The [Marvelous Designer](https://docs.gta.clothing/plugins/creator-link/marvelous.md) plugin has no **Save to cloth**: it adds and updates whole clothing, see [Add to a Durty Cloth Tool Project](https://docs.gta.clothing/plugins/creator-link/marvelous/add-to-a-project.md).

{% hint style="info" %}
Saving is part of **Durty Cloth Tool Ultimate**. See [Creator Link Plugins](https://docs.gta.clothing/plugins/creator-link.md#plans-and-limits).
{% endhint %}

## Choose how to save

While a live preview runs, the plugin offers three choices:

| Choice                    | What changes in your project                                                  | How to undo it                                                      |
| ------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| **Save to cloth**         | Replaces this map of the cloth with your texture.                             | In the cloth's **History**: **Restore version before this change**. |
| **Save as new variation** | Adds your texture to the cloth as a new texture variation. Diffuse maps only. | Remove the new variation in Durty Cloth Tool.                       |
| **Discard changes**       | Nothing. The cloth shows its saved texture again.                             | Nothing to undo.                                                    |

Under the buttons the plugin reminds you: **Saving writes this map into your project. You can undo it in the cloth's History in Durty Cloth Tool.**

{% 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 %}

## Save to cloth

1. Check the **Texture checks** first, if your plugin shows them, see [Texture Checks](https://docs.gta.clothing/plugins/creator-link/texture-checks.md). In Photoshop and Photopea, an error turns **Save to cloth** into a plain button and shows **Texture checks found a problem. Look at it before you save.** with **Show checks**.
2. Select **Save to cloth**. The plugin shows **Saving...** and then a notice that names the cloth, for example **Saved to jbib\_013 B. You can undo it in History.**
3. The **Unsaved in project** marker disappears, and the live preview keeps running, so you can keep painting and save again.

{% hint style="info" %}
Wait until **Saving...** finishes before retrying. Large textures can take longer. Saves from the same cloth keep its edited maps together in one History restore point. Saving again without new edits does not add another change.
{% endhint %}

Saving follows Durty Cloth Tool's texture rules: Durty Cloth Tool turns your document into a game texture, at your document's size (a document larger than 4096 pixels on a side is saved from its scaled copy). The texture checks tell you when a size is a problem. A save also works while the cloth is not on the ped.

The History entry names the app the texture came from, so you can tell plugin saves apart from other changes. To go back, select the cloth in Durty Cloth Tool, open its **History** tab, find the entry and choose its **Restore version before this change**. See [Project History](https://docs.gta.clothing/basics/useful-to-know/project-history.md).

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-ea10182dafee367c6aa08f4e7bddc465a6f3020a%2Fhistory-after-krita-save.png?alt=media" alt="The History tab of a hoodie in Durty Cloth Tool for Texture variation b. The entry Live edited Diffuse texture says Edited in Krita and is marked Can be restored with Restore version before this change, and the 3D Preview shows the painted stripes on the ped."><figcaption><p>The History tab after Save to cloth from Krita: the entry names Krita, and Restore version before this change brings back the earlier texture.</p></figcaption></figure>

## Save as new variation

**Save as new variation** adds your diffuse texture to the cloth as a new texture variation, and the existing ones stay unchanged. Use it to make a new colour of a cloth. Durty Cloth Tool adds it the same way as when you add a variation in the app: when the cloth has no free variation left, it adds it to a copy of the cloth instead.

A new variation has no History entry of its own. To undo it, remove the variation in Durty Cloth Tool.

After the save, GIMP, Krita and Substance 3D Painter continue the live preview on the new variation. Photoshop and Photopea keep the document on the variation you started from, so a later **Save to cloth** writes into that variation.

To make several colours at once in Photoshop or Photopea, see [Layer Comps as Variations](https://docs.gta.clothing/plugins/creator-link/layer-comps.md).

## Discard changes

**Discard changes** drops what the live preview shows. The cloth shows its saved texture again, and the plugin says so, for example **Changes discarded. The cloth shows its saved map again.** Your document in the editor keeps your paint, so you can start the live preview again later.

## When a save does not go through

* **Durty Cloth Tool could not save the map. Your document is unchanged; try again.**: try again. Your document and your project are unchanged.
* **Durty Cloth Tool has newer pixels than the plugin sent. Try again.** (or **Newer pixels were still on their way. Save again.**): your last strokes were still on their way. Save again.
* **Saving to the cloth is part of Durty Cloth Tool Ultimate.** (Blender: **Saving to the cloth is included in 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.
* **... was not allowed to work on ... Select ... in Durty Cloth Tool so the connected app can read and save it.** in Durty Cloth Tool's status bar: select that cloth in Durty Cloth Tool, then save again.

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