> 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/game-mechanics/ped-expression-flags.md).

# Ped Expression Flags

Learn how Ped Expression Modifiers control high heels and head-prop hair visibility

## Introduction

The name **Ped Expression Flags** can be a little misleading. In Durty Cloth Tool, they are numeric settings used by supported hair and high-heel features rather than simple on/off flags.

Durty Cloth Tool currently uses this system for two supported features:

* cutting or hiding compatible hair when a head prop is worn;
* adjusting ped posture for high-heel shoes.

Expression modifiers are saved per drawable. All texture variations belonging to that drawable therefore share the same setting.

## How Durty Cloth Tool Uses Them

| Feature                    | Item type | DCT values                                                                                                                | What it controls                                            |
| -------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| **Head-prop hair options** | Head Prop | `0` for Show Hairs, `-0.5` for the Cut Hairs preset, `-1` for the Remove Hairs preset, or a custom value from `0` to `-1` | Changes a compatible hair model while the prop is equipped. |
| **High Heels**             | Shoes     | `0` when disabled, or the configured Heel Height when enabled                                                             | Adjusts the ped's high-heel posture for the shoe drawable.  |

## Head Props and Hair

Head props such as hats and helmets can change a compatible hair model while the prop is equipped.

* **Show Hairs** uses a value of `0`.
* **Cut hairs** uses DCT's `-0.5` preset.
* **Remove hairs** uses DCT's `-1` preset.
* **Custom cut hairs** lets you fine-tune the value between `0` and `-1`.

These values are control values, not guaranteed percentages. For example, `-0.5` does not always mean that exactly 50% of the visible hair will disappear. The result depends on how the selected hair model was created.

The hair must be weighted to the `MH_Hair_Scale` or `MH_Hair_Crown` bone, which the game scales while the prop is equipped. If it is not, changing the modifier will have no useful visual effect. See [Hair That Hats Can Cut](https://docs.gta.clothing/cloth-modding/rigging-and-weight-painting.md#hair-that-hats-can-cut).

{% hint style="warning" %}
Head-prop hair modifiers and component hair alternations are different systems. Masks, tops, and undershirts can use alternate hair models instead. See [Cutting Hairs](https://docs.gta.clothing/basics/essential-knowledge/cutting-hairs.md) for the complete workflow.
{% endhint %}

## High Heels

For Shoes, enable **High heels**, then adjust **Heel height** until the ped's feet and the shoe model sit correctly on the floor. The value only raises the character and enables the heel pose; the pose itself moves the four heel bones `EO_L_Foot`, `EO_L_Toe`, `EO_R_Foot` and `EO_R_Toe`, so the shoe model must be weighted to them. See [High Heel Rig](https://docs.gta.clothing/cloth-modding/rigging-and-weight-painting.md#high-heel-rig).

The final result also depends on the ped, shoe model, animation, and current movement state. Test standing, walking, running, entering vehicles, and recovering from ragdoll before publishing a resource.

See [High Heels](https://docs.gta.clothing/basics/essential-knowledge/high-heels.md) for a step-by-step setup guide.

## Keep Extra YMT Creation Enabled

Durty Cloth Tool generates an extra creature metadata YMT when these features need it.

Do not enable **Disable extra YMT files creation** when your resource uses head-prop hair options or high heels. Without the extra file, these features will not work correctly. See [Build Options](https://docs.gta.clothing/basics/essential-knowledge/build-options.md) for the matching build setting.

{% hint style="warning" %}
In current Durty Cloth Tool releases, a resource that contains only **Remove hairs** or only **Custom cut hairs** head props may fail to generate the required creature metadata. Verify that `mp_creaturemetadata_<collection>.ymt` exists in the built resource. A **Cut hairs** or high-heel item in the same build can cause the shared file to be generated, but this should be treated as a temporary workaround.
{% endhint %}

## Troubleshooting

If a modifier works in the 3D preview but not in game, check the following:

1. Confirm that the item is configured as the correct drawable type: **Head Prop** for hair modifiers or **Shoes** for high heels.
2. Make sure extra YMT creation is enabled before rebuilding the resource.
3. For hair, test a known compatible hair model with the required hair-scale control.
4. Restart the resource and reapply both the hair/shoes and the prop after rebuilding.
5. Test on the same GTA V/FiveM build and ped model that your players will use.
6. Check whether another resource or script replaces the component, prop, or ped appearance after it is applied.
