> 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/first-addon-tattoo.md).

# First Addon Tattoo

Learn how to create your first addon tattoo resource with ease

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2FB3ueP5Od3ZJzMGsVNzLu%2F3d_tattoo_editor.gif?alt=media&amp;token=d0d8fdbd-e810-499e-9245-b7f43eecf647" alt=""><figcaption><p>Pleb Masters: Forge 3D Tattoo Editor demo with Export to Durty Cloth Tool</p></figcaption></figure>

## Introduction

This guide will walk you through creating your first addon tattoo resource using **Durty Cloth Tool**. Before starting, ensure you have **Durty Cloth Tool** installed and a **Cloth Project** created. If you need help with these steps, refer to the following documentation:

* [Installing Durty Cloth Tool](https://docs.gta.clothing/getting-started/quickstart.md)
* [Creating a Cloth Project](https://docs.gta.clothing/pages/PQJs9nEngsCyThn8BTjf#id-1.-creating-your-first-cloth-project)

{% hint style="info" %}
Additionally, you’ll need a square-format image for your tattoo. Square images are required as this is the format the game uses for tattoos.
{% endhint %}

## Step 1: Open the 3D Tattoo Editor

{% hint style="success" %}
**Prefer to stay in Durty Cloth Tool?** Choose **Add > Tattoo > Place a new tattoo in 3D...** below the item list (or the male or female entry next to it, or press **Ctrl+K** and paste `>Place a new tattoo`) and pick your image. Durty Cloth Tool adds the tattoo and opens its 3D placement on the ped right away, so you can skip the website steps; [Check and place the tattoo in 3D](#check-and-place-the-tattoo-in-3d) explains the placement controls. This needs a GTA V installation.
{% endhint %}

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2FKuJ0H2Z9qwiigzdinUqB%2Fimage.png?alt=media&amp;token=9528cc9b-9810-41d9-8ab8-675535bc7b49" alt=""><figcaption><p>Pleb Masters: Forge 3D Tattoo Editor</p></figcaption></figure>

To position your tattoo correctly on the player model, we’ll use the **3D Tattoo Editor** provided by Pleb Masters: Forge. You can access the editor at:

[**Pleb Masters: Forge 3D Tattoo Editor**](https://forge.plebmasters.de/tattoo3d/)

This tool lets you:

* Position the tattoo on the desired area of the player model.
* Scale the tattoo.
* Rotate the tattoo to fit correctly on the body.

{% hint style="info" %}
In order to use the Pleb Masters: Forge 3D Tattoo Editor it is required to be logged in. If you haven't got a Pleb Masters account yet, easily create one using Discord by logging in to the website in the upper right corner.
{% endhint %}

## Step 2: Upload Your Tattoo Image

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2FXkuw5VdNa8lNBR4rwcmV%2Fimage.png?alt=media&amp;token=4b240436-b768-4566-bd60-bff4ec302258" alt=""><figcaption><p>Example 3D Tattoo Editor Configuration</p></figcaption></figure>

1. In the **3D Tattoo Editor**, click the **Upload Tattoo Image** button.
2. Select your tattoo image file (ensure it is in square format).
3. Use the following settings to define the tattoo's placement:
   * **Gender**: Select Male or Female.
   * **Zone**: Choose the body zone where the tattoo will appear (e.g., Torso, Arm).
   * **UV Position (X/Y)**: Adjust the sliders to position the tattoo on the body.
   * **Scale**: Modify the tattoo’s size proportionally using the **Scale** slider. Lock or unlock the aspect ratio as needed.
   * **Rotation**: Use the rotation slider to align the tattoo properly.

{% hint style="info" %}
**Recommended Tattoo Size is 512x512**. Durty Cloth Tool warns when a tattoo exceeds 1024x1024, but you should still test the result and performance in-game.
{% endhint %}

## Step 3: Create the Tattoo in Durty Cloth Tool

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2FuIIdklV1iALLfp8jjf5a%2Fimage.png?alt=media&amp;token=11f9b0f9-44ce-4f06-aa12-8f5ededba1b9" alt=""><figcaption><p>Easily Create Tattoo in Durty Cloth Tool</p></figcaption></figure>

{% hint style="warning" %}
As previously mentioned, this requires to have a updated Version of Durty Cloth Tool installed, see [Quickstart](https://docs.gta.clothing/getting-started/quickstart.md) and [/pages/PQJs9nEngsCyThn8BTjf#id-1.-creating-your-first-cloth-project](https://docs.gta.clothing/pages/PQJs9nEngsCyThn8BTjf#id-1.-creating-your-first-cloth-project "mention") for information how to prepare a Cloth Project in before.
{% endhint %}

Once satisfied with the positioning, scaling, and rotation:

1. **Option 1: Use "Create Tattoo in Durty Cloth Tool" Button**
   * Press the **Create Tattoo in Durty Cloth Tool** button.
   * This will directly add the tattoo to your currently loaded project in **Durty Cloth Tool**.
   * If prompted, confirm running the link with the **Durty Cloth Tool Launcher** to proceed.
2. **Option 2: Copy Raw Values**
   * Alternatively, press the **Copy** button to manually copy the UV Position, Scale, and Rotation values.
   * You can then input these values manually within Durty Cloth Tool or use them to manually create tattoo related meta files.

{% hint style="danger" %}
In case the 'Create Tattoo in Durty Cloth Tool' Button doesn't create the tattoo in your Durty Cloth Tool instance, make sure you have a current version installed and **try closing any currently running Durty Cloth Tool instances**.

As a last resort, you can add the tattoo manually in your Durty Cloth Project and apply the copied raw values using the right click context menu and selecting '**Edit and organize > Paste UV pos/scale data**' (or press **Ctrl+K** and paste `>Paste UV`).
{% endhint %}

## Step 4: Adjust Tattoo Settings in Durty Cloth Tool

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2FoPovXP5ymBwIetpqXJSc%2Fimage.png?alt=media&amp;token=a2ebcf26-1fb5-4782-aea2-db47cdbccaba" alt=""><figcaption><p>Example of the tattoo added in a Durty Cloth Project</p></figcaption></figure>

Once the tattoo is added to your project in **Durty Cloth Tool**, you can fine-tune additional settings:

* **Gender**: Set the tattoo to be available for both genders if desired.
* **Additional Options**: Modify any other available settings for the tattoo (e.g., DLC name, zone restrictions).

Each image in the tattoo list is a **design**, and the tattoos below it place that image on the body. One design can be placed several times, while the image is only included once in your resource.

1. Select the design to see its image and its tattoos.
2. To place it again for another gender or body part, choose **Add tattoo**. To give a male tattoo its female twin, select it and choose **Copy for other gender**.
3. Select a tattoo, then switch between **Placement**, **Shop** and **Advanced** next to its name:
   * **Placement**: the body part, position, size and rotation.
   * **Shop**: the label, price, shop region, camera side and content lock.
   * **Advanced**: the rarely changed faction, clothing and award.

<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" %}
Every tattoo keeps its own name, body part, placement and shop settings. The fields suggest the values the game itself uses, with a short explanation under each field.
{% endhint %}

{% hint style="info" %}
You can also drop images or texture dictionaries onto the item list, or pick them with **Add from file(s)** and **Add from folder(s)**. A file named like one of the game's tattoo textures or facial overlays replaces it; any other image becomes a new design. **Add from built resource** reads existing tattoo and hair overlay resources, including their placements and shop settings.
{% endhint %}

### Check and place the tattoo in 3D

1. Double-click the tattoo to see it on the freemode ped of its gender in the **3D Preview**. Your project clothes that would cover it come off unless you keep worn clothes in the **Outfit** tab of the preview tools.
2. To change the placement right inside Durty Cloth Tool, choose **Edit in 3D** under the placement values.
3. Drag the tattoo on the body, or onto another body part; it keeps following the pointer when the pointer leaves the body. Turn it with the orange knob below it and scale it with the corner and edge handles. Hold Ctrl or Alt on a corner to change the proportions, and Shift to snap. The UV position, scale, rotation and body part update while you drag.
4. Choose **Done** or press **Esc** when the tattoo sits where you want it.

<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>

{% hint style="info" %}
**Show zone grid** draws the body part's grid, and **Stay on this body part** keeps the tattoo from moving onto another one. A tattoo on the head hides the hair so you can see and place it; turn on **Show hair** to see it with the hair. Makeup, facial and body overlays can be previewed the same way.
{% endhint %}

{% hint style="warning" %}
The 3D Preview needs a GTA V installation. Always check the final placement in game, as a tattoo script shows it.
{% endhint %}

Tattoos and overlays also get thumbnails that show them on their body part. See [Tattoos & Overlays](https://docs.gta.clothing/tattoos-makeup-and-overlays/addon-tattoos.md) for thumbnails, keyboard nudges, replacing game tattoos and facial overlays, and the limits the Error List checks.

## Step 5: Build the Project

Finally, build your project to generate the addon tattoo resource. Refer to the [Build Options Documentation](https://docs.gta.clothing/basics/essential-knowledge/build-options.md) for detailed information on the various available building options.

## Step 6: Configure your tattoo script

In order to load and test your new addon tattoos in game, an tattoo script is required. There is plenty available for the various platforms existing if you haven't got one yet.

Due to the nature of how addon tattoos work, these scripts usually require additional configurations to be done in order to preview your tattoo in game. Please see our [Dynamic Config Builders](https://docs.gta.clothing/basics/useful-to-know/dynamic-config-builders.md) article for more information regarding configuration files DCT can automatically generate for you.

{% hint style="info" %}
In most cases we recommend getting in contact with your tattoo script creator to get support on configuring your new addon tattoos.\
\
Ticking the "**Tattoos info dump**" configuration **option in the Build Window** will also make sure you have a file that contains all information required for most tattoo script configuration files.
{% endhint %}

## Step 7: Profit

You just created your first GTA 5 addon tattoo resource wohoo!

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2FCiT99uCLhVb2aQ384IWC%2Fpost-malone-yay-me.gif?alt=media&amp;token=32ee36a3-ae32-43e2-b538-f314bd4c031c" alt=""><figcaption></figcaption></figure>

## Additional Notes

* **Free Version Support**: Durty Cloth Tool allows up to 10 tattoos per gender to be added completely free of charge. For larger projects, consider subscribing to one of the available licensing tiers.
* **Convenience**: Using the **Create Tattoo in Durty Cloth Tool** button is the fastest and easiest method to add tattoos to your project.

## Summary

You’ve successfully created and added your first addon tattoo using **Durty Cloth Tool** and the **3D Tattoo Editor**. With these tools, you can now expand your tattoo collection and customize them to fit your needs perfectly.

Lets continue by adding clothes to your newly created Durty Cloth Project! Click on one of the cards below to continue. See you there 🚀

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Adding your first addon clothes</strong></td><td>See how to easily create addon cloth resources 🚀🚀</td><td><a href="https://docs.gta.clothing/getting-started/first-cloth-resource.md">First Cloth Resource</a></td></tr><tr><td><strong>Dig into DCT Essential Knowledge</strong></td><td>Learn how to benefit from our powerful features 👕</td><td><a href="https://docs.gta.clothing/basics/essential-knowledge.md">Essential Knowledge</a></td></tr><tr><td><strong>Dive deeper</strong></td><td>Discover GTA V clothing game mechanics</td><td><a href="https://docs.gta.clothing/game-mechanics/drawable-types-and-textures.md">Drawable Types &amp; Textures</a></td></tr></tbody></table>
