> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rageon.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Clothing variants

> Create a new coloring of a freemode clothing piece by copying an existing one and painting over it.

A **Variant** adds a new texture to a clothing piece, so the piece gets one more coloring in game. You start from a copy of an existing coloring and paint layers over it.

## Create a variant

**1. Pick the piece**

In **New edit**, select **Variant** and search the clothing catalog, for example `jbib_000`. Pieces the project already uses are on top under **In this project**.

**2. Choose the coloring to copy**

The right column lists the piece's existing colorings as tiles, named by the game id. The header reads **New variant · …** with the new id, and tells you to choose the texture to copy. Click one.

**New variant resolution** defaults to the base size. When they fit within 2048 on the longest side, it also offers sizes at 2× and 4× the base. The choice appears only when a larger size is available.

![New edit on Variant with a clothing piece selected and its colorings listed](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/textures/texturing-variant-pick.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=a6c59557323f5f45cf6564fc8adbc202)

A clothing piece, its existing colorings, and the resolution choice.

**3. Click Continue**

The edit opens with the copied pixels already in place. Paint layers over them ([Layers and tools](/projects/texturing/layers-and-tools.md)).

![Editor with the new clothing coloring on the stage and the piece in the 3D preview](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/textures/texturing-variant-stage.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=40f1aaebf42ccb245c30888d08a8fd45)

The new coloring open on the stage with the piece in 3D.

## Use it in game

On export, the project gets a new `.ytd` and a replacement `.ymt` that registers the coloring after the existing ones. In game, equip it by its drawable and texture number.

> [!WARNING]
>
> The exported `.ymt` replaces the game's metadata for that ped folder. Another resource replacing the same `.ymt` can override it; keep the changes in one resource.

> [!NOTE]
>
> If the piece appears without a texture in game, check whether the server's license key grants the `subdir_file_mapping` policy. The server needs it to load these clothing texture paths.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.