> 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/tattoos-makeup-and-overlays/addon-tattoos.md).

# Tattoos & Overlays

Create tattoo designs, place them in 3D and replace game tattoos and facial overlays

Durty Cloth Tool builds addon tattoos, badges and hair overlays for the MP Freemode characters. It can also replace the game's own tattoo textures and facial overlays, such as makeup, beards and eyebrows.

This page explains how tattoos are organized in a project, how to place and preview them on the ped, and what to check before you build.

{% hint style="info" %}
New to tattoos? Follow [First Addon Tattoo](https://docs.gta.clothing/tattoos-makeup-and-overlays/first-addon-tattoo.md) for a step-by-step walkthrough first.
{% endhint %}

## Designs and tattoos

The tattoo list shows **designs**. A design is one image, and the **tattoos** inside it place that image on the body. You can place one design several times, for example on both arms, or once for male and once for female characters. Your resource includes the image only once, however often you place it.

1. Select a design in the list. Its details show the image, the **Design name**, the **Kind** and the tattoos that place it.
2. Choose **Add tattoo**, then **For male**, **For female** or **For both genders**, to place the design once more.
3. Select a tattoo and choose **Copy for other gender** to give it a twin for the other gender. Male and female bodies differ in size, so adjust the copy afterwards.
4. Use **Move tattoo up** and **Move tattoo down** to change the order. The order sets each tattoo's number in the built collection, which the details show.

The **Kind** sorts the list into **Tattoo designs**, **Badges** and **Hair overlays**, and sets what a new tattoo of the design starts with.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-417e782330964a06b17ac89055a0c029f0a5a536%2Ftattoo-design-placement.png?alt=media" alt="A selected tattoo design with its image, Design name, Kind, the tattoo list with one tattoo for both genders and the Placement section of the selected tattoo, next to the 3D Preview showing the tattoo on the left leg."><figcaption><p>A tattoo design with its tattoo list and the Placement section, shown on the ped.</p></figcaption></figure>

{% hint style="info" %}
A design without tattoos is left out of the build, and the Error List points it out. Tattoos from older projects and packages become designs automatically when you open them.
{% endhint %}

{% hint style="info" %}
A tattoo made as a decal cloth from a copy of the body usually lies on the skin, so the skin hides it in patches in the 3D preview and most likely in game. Making it as a tattoo design instead avoids the problem. If you keep the decal cloth, the Error List reports it as **Decal lying on the skin** and offers **Lift off the skin**; see [Clothing compatibility findings](https://docs.gta.clothing/basics/essential-knowledge/cloth-analysis-report.md#clothing-compatibility-findings).
{% endhint %}

## Placement, Shop and Advanced

Select a tattoo in the design's list, then switch between **Placement**, **Shop** and **Advanced** next to its name. The switch keeps your choice when you pick another tattoo. Every field has a short explanation under it, and several fields suggest the values the game itself uses.

| Section       | What you set there                                                                                                                                                                                                             |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Placement** | The name hash, gender, type and body part, the UV position, scale and rotation, and **Edit in 3D**. Head tattoos also offer **Uses tint colour**, which paints the tattoo in the ped's hair colour like the game's hair fades. |
| **Shop**      | The **Label**, **Price**, **Shop region**, **Shop camera side** and **Content lock** of the tattoo's entry in the game's tattoo shop.                                                                                          |
| **Advanced**  | **Faction**, **Clothing**, **Award** and **Award level**. Keep the defaults for your own tattoos.                                                                                                                              |

Fields a tattoo does not use stay hidden. For example, **Clothing** only appears for badges, and **Uses tint colour** only for head tattoos.

* **Name hash** is the name scripts use to apply the tattoo. For a tattoo of one gender, `_M` or `_F` is added.
* **Label** is the shop text. The game's shop keeps only the first 15 characters.
* **Shop region** decides which owned tattoos the game's tattoo shop takes off when this one is applied. New tattoos get a region that fits their body part.
* **Content lock** hides the tattoo in the game's own tattoo shop until an installed update unlocks it. Leave it empty to always show the tattoo. Server shops follow their own scripts.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-c2eaee0fb2cf2d243dab09dc186f2b8d6399f4e3%2Ftattoo-design-shop.png?alt=media" alt="The same design with the Shop section of the selected tattoo, showing Label, Price, Shop region, Shop camera side and Content lock with their explanations."><figcaption><p>The Shop section: what the game's tattoo shop and its scripts read.</p></figcaption></figure>

{% hint style="warning" %}
Every tattoo needs its own name. When a tattoo is named like one of the game's tattoos, scripts may find the game's tattoo instead of yours, so the Error List asks you to rename it.
{% endhint %}

## Place a tattoo in 3D

Double-click a tattoo or overlay, or choose **Show in 3D preview** in a tattoo's details, to see it on the freemode ped of its gender. The camera turns toward it. Project clothes that would cover it come off unless you keep worn clothes in the **Outfit** tab. The Outfit tab also lists the tattoos and overlays on the ped under **Tattoos and overlays**, where you can take them off again.

To change the placement on the body:

1. Choose **Edit in 3D** under the placement values, or **Edit placement in 3D** in the tattoo's context menu (or press **Ctrl+K** and paste `>Edit placement`). The animation pauses so the ped stands still.
2. Drag the tattoo to move it. You can drag it onto another body part too. When the pointer leaves the body, the tattoo keeps following it around the body instead of stopping; once off the body, it picks up again only on its own body part, so it does not jump. The card in the corner of the preview says what the editor does and lists its controls with your shortcuts.
3. Drag the orange knob below the tattoo to turn it, any of the four corner handles to scale it evenly and an edge handle to stretch it. Hold **Ctrl** or **Alt** while dragging a corner to change the width and height separately. Hold **Shift** to snap. On a small or distant tattoo the handles keep their distance, so each one can still be grabbed.
4. Watch the UV position, scale, rotation and body part update in the details while you drag.
5. Choose **Done** or press **Esc** to finish. **Reset** puts the tattoo back where it was when you started.

To add a new tattoo and place it straight away, choose **Add > Tattoo > Place a new tattoo in 3D...** below the item list (or press **Ctrl+K** and paste `>Place a new tattoo`), or **Place a new male tattoo in 3D...** or **Place a new female tattoo in 3D...** for one gender. Pick the picture, and **Edit in 3D** opens on the new tattoo. Without a GTA V installation the tattoo is only added.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-220b53aac34a3296f550ab9a9ae0e1c1182a93c5%2Ftattoo-edit-in-3d.png?alt=media" alt="Edit in 3D on a leg tattoo: the tattoo on the ped with its move handle, the orange turn knob and the corner and edge handles."><figcaption><p>Edit in 3D: drag the tattoo, turn it with the orange knob and scale it with its handles.</p></figcaption></figure>

* **Show zone grid** draws the grid of the body part, so you can read the position and size in its own coordinates.
* **Stay on this body part** keeps the tattoo on its current body part while you drag. Past the edge of the body part, the tattoo keeps following the pointer on it.
* A tattoo on the head hides the hair, so hair fades and scalp or face tattoos can be seen and placed. Turn on **Show hair** to see them with the hair.

You can also nudge the tattoo with the keyboard while placing it. These are the default keys; change them in **Options > Keybindings** (or press **Ctrl+K** and paste `@Change a shortcut`).

| Keys        | Action                                                      |
| ----------- | ----------------------------------------------------------- |
| Arrow keys  | Move the tattoo a small step. Hold Shift for a larger step. |
| `[` and `]` | Turn the tattoo by one degree. Hold Shift for 15 degrees.   |
| `+` and `-` | Scale the tattoo by 2 percent. Hold Shift for 10 percent.   |

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-baa2ea768268f0b2a0317b5a319b93bf472c976f%2F3d-tattoo-placement-poster.webp?alt=media" alt="Edit in 3D on a chest tattoo: drag it into place, make it larger with a corner handle, then check it from the side."><figcaption><p>Edit in 3D on a chest tattoo: drag it into place, make it larger with a corner handle, then check it from the side.</p></figcaption></figure>

{% embed url="<https://gta.clothing/assets/media/v4/3d-tattoo-placement-mobile.mp4?v=f8a0cad4d89d>" %}
Edit in 3D on a chest tattoo: drag it into place, make it larger with a corner handle, then check it from the side.
{% endembed %}

{% hint style="info" %}
The 3D preview needs a GTA V installation. Tattoos and overlays are shown on the freemode body only; custom ped projects show the item's own image and a notice instead. Check the final placement in game.
{% endhint %}

## Edit the picture

To change a design's or overlay's picture, right-click it and choose **Edit and organize > Open in Texture Studio** to add layers that stay editable, or **Edit and organize > Edit picture in image editor** to use your own image editor (or press **Ctrl+K** and paste `>Open in Texture Studio` or `>Edit picture`). While it is worn, the row under **Tattoos and overlays** in the 3D Preview's **Outfit** tab offers **Texture Studio**, **Image editor** and **Connected app**, and the ped shows every change. Editing a design changes every tattoo that uses it. See [Texture Studio](https://docs.gta.clothing/basics/good-to-know/texture-studio.md#tattoo-designs-and-overlays) and [Edit a tattoo or overlay picture](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#edit-a-tattoo-or-overlay-picture).

## Tattoo thumbnails

Tattoos, badges, hair fades and facial overlays get thumbnails that show them on their body part of the stock freemode body. You see them in a design's tattoo list, in the overlay list and in other lists that show thumbnails. A design's own row keeps showing the design image. Hover over an image to see it larger.

Thumbnails update shortly after you change a placement or an image. Whole project runs of the Thumbnail Generator include tattoos and overlays as well; see [Thumbnails & Visual Exports](https://docs.gta.clothing/basics/good-to-know/thumbnails-and-exports.md).

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-40459380191bff8bb9e7ad8d72ff1467d15ae761%2Ftattoo-thumbnails-hover.png?alt=media" alt="The details of the tattoo design mp_luxe_tat_008 with three tattoos in its list: a male and a female Torso tattoo, each with a thumbnail of the design on the chest, and a selected male tattoo whose thumbnail is shown larger on hover, with the design on the arm."><figcaption><p>Body-part thumbnails in a design's tattoo list. Hovering over a thumbnail shows it larger, here the arm tattoo.</p></figcaption></figure>

{% hint style="info" %}
Body-part thumbnails need a GTA V installation. Without one, and in custom ped projects, the lists show the item's own image.
{% endhint %}

## Add and import tattoos

* **Drop** images or texture dictionaries onto the item list, or pick them with **Add from file(s)** and **Add from folder(s)**. Each image becomes a new design, unless it is named like one of the game's tattoo textures or facial overlays: then it replaces that texture. See [Replace game tattoos](#replace-game-tattoos) below.
* **Add from built resource** reads existing tattoo and hair overlay resources, including their placements and shop settings, and lets you review them before anything is added.

{% hint style="warning" %}
A rebuilt resource names its tattoo collection after your project. If your scripts or shop configuration use the original collection name, update them after building.
{% endhint %}

## Replace game tattoos

A design can replace one of the game's tattoo textures instead of adding a new tattoo. Add an image or texture dictionary named exactly like the game texture. The design's details then name the texture it replaces and list the game's tattoos that draw it. You can preview those tattoos. To change their placement:

1. Make sure your GTA V installation is set up, so the existing placements can be loaded.
2. Choose **Make editable** in the design details. DCT keeps the image and copies the existing placements into a custom design with a separate texture name. It no longer replaces the game tattoo.
3. Select a tattoo and choose **Edit in 3D**.

Renaming the design alone does not remove the replacement link.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-6f54b91784ff4d91fc3ae360983a968c0c02c53e%2Faddon-tattoos-poster.webp?alt=media" alt="Show a replaced game tattoo on the ped, choose Make editable, add a tattoo for male, move it to the Left Arm, then hover over the body-part thumbnails to see them larger."><figcaption><p>Show a replaced game tattoo on the ped, choose Make editable, add a tattoo for male, move it to the Left Arm, then hover over the body-part thumbnails to see them larger.</p></figcaption></figure>

{% embed url="<https://gta.clothing/assets/media/v4/addon-tattoos-mobile.mp4?v=a8702b06a0e2>" %}
Show a replaced game tattoo on the ped, choose Make editable, add a tattoo for male, move it to the Left Arm, then hover over the body-part thumbnails to see them larger.
{% endembed %}

Replacements are built for every target. The Error List warns when a name matches no game tattoo, and reminds you that replacements on Singleplayer and RageMP builds are not verified, so test them in game.

## Facial overlays

Facial overlays cover makeup, lipstick, blusher, eyebrows, facial hair, blemishes, freckles and similar face and body details. Add them with **Add > Add facial overlay** (or press **Ctrl+K** and paste `>Add facial overlay`); you can add several overlay files at once. Facial overlays apply to both genders. Hair fades are not facial overlays but tattoo designs of the kind **Hair overlay**.

* **Replace a game overlay**: enter the game overlay's name, such as `mp_fm_faov_blusher_005`, under **Replaces game overlay** in the overlay's details, or add a file named like it. Replacements are built for every target. On Singleplayer and RageMP builds they are not yet confirmed in game, so test them there.
* **Add a new overlay**: leave **Replaces game overlay** empty. New facial overlays are built for FiveM only. Other targets leave them out.

{% hint style="warning" %}
New facial overlays load only on FiveM server builds that include facial overlay data file support, which official FiveM builds do not include yet. The Error List tells you which case applies to each overlay; replace a game overlay when your server does not support new ones.
{% endhint %}

Double-click an overlay to see it on the ped: face overlays are drawn on the head, chest hair and body blemishes on the upper body. For the details and the steps, see:

* [Facial Overlays & Makeup](https://docs.gta.clothing/tattoos-makeup-and-overlays/facial-overlays-and-makeup.md): overlay types, colours, targets and limits
* [Replace Game Makeup, Beards and Facial Overlays](https://docs.gta.clothing/tattoos-makeup-and-overlays/replace-game-facial-overlays.md)
* [Add New Makeup and Facial Overlays (FiveM)](https://docs.gta.clothing/tattoos-makeup-and-overlays/add-new-makeup-and-facial-overlays.md)
* [Create Hair Fades and Hairline Overlays](https://docs.gta.clothing/tattoos-makeup-and-overlays/create-hair-fades-and-hairline-overlays.md)

## Optimize tattoo textures

The [Texture Optimizer](https://docs.gta.clothing/basics/essential-knowledge/texture-optimizer.md) covers tattoo designs and facial overlays together with your clothing textures. Right-click a design or overlay and choose **Optimize texture...** (or press **Ctrl+K** and paste `>Optimize texture...`), or run the Texture Optimizer for the whole project. It can compress images, add mipmaps and reduce oversized textures.

{% hint style="info" %}
A design stored as a picture is built as an uncompressed texture, and the Error List points this out. After optimizing, the picture is stored as a texture dictionary. Optimizing a selection needs an active license, and whole project runs need Ultimate, the same as for clothing textures.
{% endhint %}

## Findings and game limits

With a license, Durty Cloth Tool sets no fixed tattoo count; the Error List names the game's own limits, for example:

* a shop **Label** longer than 15 characters, which the game's shop cuts off;
* a tattoo name used twice in the project, which stops the build;
* a **Shop region** that belongs to another body part than the tattoo;
* a tattoo with a size of zero, which draws nothing;
* a fully transparent image, or a fully opaque image whose background may show as a rectangle;
* images larger than the recommended 512 x 512, or larger than 1024 pixels on a side;
* a design whose image is mostly empty canvas around the art (at least three quarters by default; change the share under **Project Settings > Warnings and Validations**).

For the last one, choose **Fix** in the Error List: **Trim transparent borders** crops the image to the art and moves and scales every tattoo that uses the design, so each stays exactly where it was on the body. Image and tattoos change together, and one undo or the restore point in **Backups & History** puts both back. Replacements of the game's tattoo textures are not checked, because the game's own tattoos rely on their layout.

Tattoos also share the game's texture and streaming capacity with your clothing. See [Game Limits and Crashes](https://docs.gta.clothing/game-mechanics/game-limits-and-crashes.md#tattoo-related-game-limits).

## Licenses and requirements

{% hint style="info" %}
Without an active license, a project can hold up to **10 tattoos per gender** and **3 facial overlays**. See [License Activation](https://docs.gta.clothing/getting-started/license-activation.md).
{% endhint %}

* The 3D preview, **Edit in 3D** and body-part thumbnails need a GTA V installation. Everything else on this page works without the game.
* Tattoos and overlays are placed on the MP Freemode characters.
* To load and test tattoos in game, you need a tattoo script. See [Dynamic Config Builders](https://docs.gta.clothing/basics/useful-to-know/dynamic-config-builders.md) for the configuration files DCT can generate.

## See also

* [First Addon Tattoo](https://docs.gta.clothing/tattoos-makeup-and-overlays/first-addon-tattoo.md)
* [3D Previewing Clothes](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md)
* [Build Options](https://docs.gta.clothing/basics/essential-knowledge/build-options.md)
