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

Head-prop hair modifiers and component hair alternations are different systems. Masks, tops, and undershirts can use alternate hair models instead. See Cutting Hairs for the complete workflow.

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 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 for the matching build setting.

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.

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.