> 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

## 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 support the compatible `MH_Hair_Scale` control. If it does not, changing the modifier will have no useful visual effect.

{% 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](/basics/essential-knowledge/cutting-hairs.md) for the complete workflow.
{% endhint %}

## High Heels

For Shoes, enable **Is High Heels**, then adjust **Heel Height** until the ped's feet and the shoe model sit correctly on the floor.

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](/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](/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.