> 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/cloth-modding/rigging-and-weight-painting.md).

# Rigging and Weight Painting

Make clothing follow the Freemode skeleton correctly

## Introduction

Rigging connects a clothing mesh to the ped skeleton. A component can have correctly named vertex groups and still deform badly if those groups contain missing or poor weights, so both the structure and the painted result matter.

The official [Sollumz Rigging documentation](https://docs.sollumz.org/documentation/drawables.ydr/rigging) explains the required Drawable hierarchy and Blender controls.

## Components and Props

Normal clothing components are usually **skinned**:

* The top-level Drawable Dictionary is an armature when the external skeleton is loaded.
* A child Drawable contains the Drawable Models and their visible LOD meshes.
* Vertex group names match bones in that armature exactly.
* An Armature modifier targets the imported Drawable Dictionary armature.
* Each vertex receives weights that describe how strongly nearby bones move it.

Some prop references link the whole model to a bone instead of using vertex skinning. When your reference uses that pattern, use Sollumz's **Add Bone Constraint** tool rather than creating a normal Blender constraint by hand. Do not assume every prop uses the same setup; follow a working prop from the same category and anchor.

{% hint style="info" %}
Skeleton weights and YLD simulation are separate systems. Complete the normal rig first, then follow [Creating Cloth Physics (YLD)](https://docs.gta.clothing/cloth-modding/cloth-physics-yld.md) only when part of a component needs simulated movement.
{% endhint %}

## Start from the Correct Skeleton

Import the YDD with the matching Freemode YFT beside it and set **Import External Skeleton** to **Auto**. If the mesh has groups such as `UNK.001` instead of names such as `SKEL_Pelvis`, re-import before doing any weight work. [Chapter 2](https://docs.gta.clothing/cloth-modding/complete-walktrough/chapter-2-into-blender.md) shows this check.

Do not rename bones to make a mesh easier to organize. The exported vertex groups must continue to match the skeleton.

For a new cloth made with the Blender add-on's Garment Fitting tools, **Use Durty Cloth Tool Skeleton** puts the cloth on the freemode skeleton from your own game files, ready to weight. See [Game Ready](https://docs.gta.clothing/plugins/creator-link/blender/game-ready.md#weight-the-cloth).

## Transfer Weights as a Starting Point

For a new component, choose a working reference that fits the same area of the body. A fitted jacket is a better source for another jacket than a loose bag or pair of shoes.

A practical first pass is:

1. Align the new mesh with the reference in the skeleton's rest pose.
2. Use Blender's weight-transfer tools to copy nearby bone weights from the reference.
3. Confirm the expected bone-named vertex groups were created on the target mesh.
4. Normalize the weights and inspect for unweighted or unexpectedly weighted vertices.
5. Correct problem areas manually in Weight Paint mode.

Weight transfer is only a starting point. It cannot understand cuffs, loose fabric, shoulder pads or a different silhouette. Blender's [Weight Paint documentation](https://docs.blender.org/manual/en/latest/sculpt_paint/weight_paint/index.html) covers the painting, normalization and cleanup tools in more depth.

### Let Durty Cloth Tool transfer the weights

**Rig to freemode body** (experimental; Ultimate) can help clothing that hangs rigidly or has an unusable rig. For a custom ped made from your own character, use [Rig to this ped's body](https://docs.gta.clothing/plugins/creator-link/blender/custom-ped.md#rig-clothes-to-your-peds-body) instead.

{% hint style="warning" %}
Rig to freemode body needs an **Ultimate** license and works while you are signed in and online. You do not need GTA V installed to run the repair; animated previews from your own game still need your game files. The tool is highly experimental and may not work on complex clothes.
{% endhint %}

1. Open it from a top, body, legs, shoes, undershirt, accessory, armour, bag or mask, or from the Fix action of a single-bone or invalid-rig finding.
2. DCT checks the selected clothing first and applies repairs that pass its checks right away. Unsupported models and clearly misplaced cloth are refused before marking.
3. When it needs your help, the **Cloth Rigging Tool** opens with that item selected and the 3D Preview ready. Marking the cloth areas and testing the repair there use the 3D Preview, which needs your GTA V installation; without it, the tool says so. Some loose cloth and small attachments can also produce a repair that needs your visual review.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-5a6ef6876a9f2249819cfdbc1ba85f0a15400fb4%2Frig-repairs-poster.webp?alt=media" alt="Mark a blouse&#x27;s sleeves and Torso in the Cloth Rigging Tool, fix knee-high heeled boots with Rig as high heel so they stand on their heels, then Make hair cuttable shrinks hair under a hat instead of letting it poke through."><figcaption><p>Mark a blouse's sleeves and Torso in the Cloth Rigging Tool, fix knee-high heeled boots with Rig as high heel so they stand on their heels, then Make hair cuttable shrinks hair under a hat instead of letting it poke through.</p></figcaption></figure>

{% embed url="<https://gta.clothing/assets/media/v4/rig-repairs-mobile.mp4?v=2d2549804e82>" %}
Mark a blouse's Left sleeve, Right sleeve and Torso in the Cloth Rigging Tool, fix the High heels without a heel rig finding of knee-high boots with Rig as high heel and see the boots stand on their heels, then use Make hair cuttable on a hair: the preview puts a cap on the ped, Reach is lowered and Apply rigs the hair so it shrinks under a hat.
{% endembed %}

#### Mark the body areas

1. Choose an area, then click it in Preview. Tops offer **Left sleeve**, **Right sleeve** and **Torso**; trousers offer legs and **Waist**, shoes offer left/right shoes, and other supported cloth uses **Cloth area**. Left and right follow the ped wearing the cloth.
2. Use **Smart select** to suggest a larger area from one click, including matching inner layers, and **Brush** for small corrections. The hint under each choice says what it does, gives an example and lists its controls; point at an area button or a selection mode to see which part of the body it follows or when it helps.
3. Check the solid colours. Grey cloth is unassigned. **Hide assigned areas** reveals the parts that still need a selection, including inner layers.
4. Review and correct the colours, then choose **Try repair** when enough is assigned.

Use **Undo** or **Ctrl+Z** to reverse the last region selection. The shortcut works in the Cloth Rigging Tool and its 3D Preview, and can be changed in **Options > Keybindings** (or press **Ctrl+K** and paste `@Change a shortcut`).

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-0c55a9ff37c14e9db75969fb072050dd72690208%2Fcloth-rigging-tool-marking.png?alt=media" alt="The Cloth Rigging Tool with Torso selected and Smart select (suggest an area) chosen, 100% of the cloth assigned and Try repair available, beside an open blouse with a bow in the 3D Preview: the ped&#x27;s left sleeve in orange on the right of the screen, the right sleeve in blue and the Torso in green."><figcaption><p>Left sleeve, Right sleeve and Torso marked on a blouse with Smart select: all of the cloth is assigned and Try repair is available. The ped's left sleeve appears on the right of the screen.</p></figcaption></figure>

{% hint style="info" %}
Click an already marked area to erase its selection, then drag to continue erasing, and mark it again with the correct area selected. Clicking the active area button again stops marking. The cloth stays still while you mark it; hold the middle mouse button or start dragging in empty space to rotate around the ped.
{% endhint %}

When another part of the cloth gets in the way, turn on **Hide nearby cloth (selection aid)**:

* For a left sleeve, leg or shoe, drag the slider from right to left; for the right side, drag from left to right. The cut hides the opposite side first and keeps the chosen side of the ped.
* For Torso and Waist, moving right widens the visible centre.
* Each area remembers its own setting, and the aid never deletes cloth.

To assign what is left:

* **Fill remaining areas** reveals the whole cloth and suggests labels for unassigned parts, including inner layers and erased gaps.
* To assign everything still visible to one chosen area, choose **Fill all visible (chosen area)** and press **Fill visible area**. Use the cutaway to limit that fill, or **Hide assigned areas** to keep existing marks.

#### Check and apply the repair

1. Once a repair is ready, the window switches to **Check the repair** and shows the cloth on the ped. The animation selector starts at **No Animation (T-Pose)**; choose a walking, raised-arm or aiming animation to check whether the cloth follows the ped.
2. Use **Preview original** and **Preview repaired** to compare, or **Edit selection** to correct the marked areas.
3. When DCT finds small sleeve holes, **Smart fill holes** fills them and shows the result in Preview; **Undo hole filling** removes those additions. To choose individual holes, use **Review sleeve holes**, check **Fill hole** for each accidental opening, then choose **Back** to preview your choices. Leave intentional openings, such as cuffs and pockets, unchecked.
4. When the result looks right, choose **Apply rig**. DCT prepares the cloth's LODs and companion models together, and Project History keeps a restore point.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-33231de9a3179edb2e3ac5089922a11eff8057c8%2Fcloth-rigging-tool-check-repair.webp?alt=media" alt="Animation: the Cloth Rigging Tool at Check the repair with the blouse in the 3D Preview. Walk (female) is chosen under Test the rig in motion. With Preview original the sleeves stay stiff while the arms swing out of them; with Preview repaired the sleeves follow the arms."><figcaption><p>Choose a walking animation, then switch between Preview original and Preview repaired to see whether the sleeves follow the arms.</p></figcaption></figure>

{% hint style="info" %}
Hole filling covers small sleeve holes in the current main-model view. Large shoulder gaps or missing sections still need a 3D editor.
{% endhint %}

#### Undo, cancel and failed attempts

* While a repair runs, the tool shows its current stage and elapsed time, and editing controls are unavailable. **Cancel** stops the current attempt and closes the tool.
* **Undo** restores the last selection stroke, fill or reset; you can step back through the last 20 changes. **Start over** clears the selections.
* Guidance and previews do not change the source files. Closing or cancelling leaves the current unapplied item unchanged and restores your previous Preview options.
* If another edit changes the source while the tool is open, reopen **Rig to freemode body** to analyze the current version.
* In a batch, completed repairs remain applied when you cancel later items.

If your marks cannot guide the repair, the tool stays on marking and says what to correct, for example to mark each sleeve all the way from the shoulder to the cuff and to keep the upper sleeves out of Torso. Correct the marks and choose **Try repair** again. If DCT had a repair ready before you edited the selection, **Use the automatic repair** goes back to it without a new analysis; to get your marks back afterwards, choose **Edit selection**, then **Undo**.

If DCT cannot safely repair the cloth itself, a warning explains the refusal and closes the repair flow, still offering **Use the automatic repair** when one is ready. The original stays unchanged. Check Project logs for details and correct the shape or rig in Blender or Sollumz before trying again.

{% hint style="warning" %}
Bent or pocketed sleeves, loose linings and ambiguous sleeve ends can still require Blender or Sollumz. DCT does not rebuild substantial missing sleeves or separate a sleeve welded to a pocket, and it refuses models with cloth physics or unsupported layouts with a reason. Skirts and long coats can still stretch between the legs, and bags can bend more than intended. Check every proposed hole repair against the cloth's intended design.
{% endhint %}

A successful analysis does not prove correct movement. Inspect walking, running, raised arms, sitting and aiming in the [3D Preview](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md), then test the cloth and its LODs in game.

{% hint style="warning" %}
Keep no more than four meaningful bone influences on a vertex. Sollumz exports the strongest four and normalizes them. Every deforming vertex should also have a useful weight; an unweighted vertex can fall back to the root and appear detached in-game.
{% endhint %}

## High Heel Rig

The game poses high heels through four dedicated bones on the Freemode skeleton: `EO_L_Foot` and `EO_L_Toe` under `SKEL_L_Foot`, and `EO_R_Foot` and `EO_R_Toe` under `SKEL_R_Foot`. When a heel is worn, the game raises the character by the heel height and rotates those four bones into the heel pose. It does not rotate `SKEL_L_Foot`, `SKEL_L_Toe0`, `SKEL_R_Foot` or `SKEL_R_Toe0` for this, so a shoe weighted only to the ordinary foot bones rises with the character but stays flat.

Base-game heels normally follow this pattern, and flat shoes do not:

* The ankle and shaft stay on `SKEL_L_Calf`, `SKEL_R_Calf`, `SKEL_L_Foot` and `SKEL_R_Foot`, as on a flat shoe.
* The foot and sole area of the shoe is weighted to `EO_L_Foot` and `EO_R_Foot` instead of the foot bones.
* The toe area is weighted to `EO_L_Toe` and `EO_R_Toe` instead of `SKEL_L_Toe0` and `SKEL_R_Toe0`.

The simplest way to get this right is to start from a heel that ships with the game, for example a female `feet` drawable that is flagged as a heel, and transfer its weights to your mesh as described above. If you rig by hand, create the four `EO_` vertex groups (the imported Freemode armature already contains the bones) and move the foot and toe weights from the `SKEL_` groups to them.

The High LOD must carry all four influences; lower LODs may simplify. When such a shoe is added, Durty Cloth Tool enables **High heels** on its own, and Cloth Analysis warns when the option is on without this rig. Set the option and the heel height as described in [High Heels](https://docs.gta.clothing/basics/essential-knowledge/high-heels.md).

You can also let the tool do it: **Rig as high heel** (context menu of any shoe, or the Fix of the finding) rigs a flat-rigged shoe to the heel bones so the heel pose moves it, and leaves the rest of your weights as they are. It only works with weights you already painted on the foot and toe bones, so a shoe skinned to other bones, or one with its own skeleton that lacks the heel bones, still needs a re-export. See [High Heels](https://docs.gta.clothing/basics/essential-knowledge/high-heels.md#let-durty-cloth-tool-add-the-heel-rig).

{% hint style="info" %}
**Rig as high heel** and **Make hair cuttable** need **Ultimate**.
{% endhint %}

## Hair That Hats Can Cut

Hats and helmets shrink hair through the **Cut hairs** options of a head prop. Only vertices weighted to two dedicated bones under `SKEL_Head`, `MH_Hair_Scale` and `MH_Hair_Crown`, shrink. A hair weighted to `SKEL_Head` alone keeps its full shape under every hat and clips through it.

Weight the parts of the hair that a hat should push down or hide to `MH_Hair_Scale`, keep `MH_Hair_Crown` for the top of the head where the crown of a hat sits, and leave the roots and any part that must stay in place on `SKEL_Head`. The hairs that ship with GTA V mix the three: typically 60 to 90 percent of the weight on `SKEL_Head`, the rest on the two hair bones; very short cuts use no hair bone at all, because nothing needs to move. Copying the weights from a shipped hair of a similar length is a good starting point.

Cloth Analysis reports a hair without any weight on the two hair bones as **Hair cannot be cut by hats**. It is an informational note, not a fault: a buzz cut does not need it. Configure the cut amount on the hat side as described in [Cutting Hairs](https://docs.gta.clothing/basics/essential-knowledge/cutting-hairs.md).

**Make hair cuttable** (context menu of any hair, or the Fix of the note) gives a hair that is skinned to the head alone weight on the two hair bones, so hats can cut it. Adjust its **Strength** and **Reach** while a cap shows the result in the 3D Preview. It is a good starting point; a hand-painted falloff is still better for long or asymmetric styles. See [Cutting Hairs](https://docs.gta.clothing/basics/essential-knowledge/cutting-hairs.md#let-durty-cloth-tool-make-a-hair-cuttable).

{% hint style="info" %}
To paint bone weights without leaving Durty Cloth Tool, use [Model Studio (Experimental)](https://docs.gta.clothing/basics/good-to-know/model-studio.md) (Ultimate).
{% endhint %}

## Test the Deformation

Check more than the rest pose. At minimum, inspect:

* Shoulders and armpits with the arms raised and crossed.
* Elbows, wrists and long sleeves with the arms bent.
* Waist and hips while crouching or leaning.
* Knees and ankles for pants and shoes.
* Loose edges, straps and accessories during large movements.

Look for collapsing volume, spikes, stretching, body clipping and vertices that remain behind. Also test each authored LOD because lower meshes can have different weight problems.

{% hint style="info" %}
Durty Cloth Tool checks every authored LOD and warns about broken rigs, such as missing or invalid weights and bones the skeleton does not have, and about damaged model data. Its [3D Preview](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md) can play animations for quick checks. These checks cannot judge body fit, clipping or whether a valid weight distribution deforms well. [Check clipping in poses](https://docs.gta.clothing/how-to-guides/optimize-clothing-models-and-textures.md#check-clipping-in-poses) (Ultimate) counts where the body comes through a cloth in a set of game poses, as guidance. Always test the built resource with a representative set of in-game animations.
{% endhint %}
