> 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/behaviour-flags.md).

# Behaviour Flags

Learn about GTA V's Ped Component Flags / Cloth Behaviour Flags

## Introduction

The "Ped Component Flags" or "Behaviour Flags" are a set of flags used by the game to define specific behaviors for various pieces of clothing and accessories. These flags determine how an item behaves in different scenarios, such as entering a vehicle, handling first-person view, and automatic helmet selection.

## How to set Behaviour Flags in Durty Cloth Tool

Select a cloth drawable in the list. In **Item Details**, open the **Behaviour flags** field, beside **Audio preset** in the **Options** section (hover it, or the **?** after its name, for a short explanation): it lists the flags the drawable's type offers, grouped by what they affect, with one sentence per group and a tooltip on each flag. Tick the flags you need; the closed field names the ticked flags, or **None**.

| Group                | Flags                                                               |
| -------------------- | ------------------------------------------------------------------- |
| **In vehicles**      | Remove in Vehicle, Bike Only, Flight Equipment, Pilot Equipment     |
| **Helmets and hats** | Motorcycle Helmet, Random Helmet, Use Hat Physics (head props only) |
| **Protection**       | Armoured, Lightly Armoured                                          |
| **Camera**           | Hide in First Person                                                |
| **Other**            | Bulky                                                               |

A group with no flag for the drawable's type is left out. To change the flags of several items at once, use [Bulk metadata editing](https://docs.gta.clothing/basics/good-to-know/bulk-metadata-editing.md), where you can add, remove or replace flags.

### Use the game's usual flags

The **Auto** button beside the field (**Use the game's usual flags**) ticks the flags that most of the game's own freemode items of the same type carry. You also find it in the item's right-click menu and, with several items selected, in the multiple-selection panel under **Edit and organize**.

| Type        | The game's usual flags                         |
| ----------- | ---------------------------------------------- |
| Head props  | Bulky, Remove in Vehicle, Hide in First Person |
| Bags        | Remove in Vehicle                              |
| Heads       | Hide in First Person                           |
| Other types | None                                           |

The same flags apply to male and female items. They come from the stock freemode items of GTA V title build 1.0.3889.0 and are a starting point, not a guarantee of how your item behaves in game.

* Under the field, DCT shows what it would add or remove on the selected item. The info icon beside the button says which flags the game's items of that type usually carry.
* Only the flags the type offers change; for a type whose game items usually carry no flags, nothing changes and DCT tells you so.
* When an item would lose a flag it carries now, DCT lists what each item gains and loses and asks first.
* **Undo** puts every changed item back in one step.
* One item at a time is free. Several items at once need an Ultimate license.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-3f9a4ae6b38abedfe7dc5e5a04ea2add25b4dc5d%2Fimage.png?alt=media" alt="The Behaviour flags list of a top opened in the Options of Item Details, with the groups In vehicles, Protection, Camera and Other, a check box per flag and a line on what each group does."><figcaption><p>Durty Cloth Tool Behaviour Flags Option</p></figcaption></figure>

## Behaviour Flags in DCT

| Name                     | Description                                                                                   | Additional Info                                                                                   |
| ------------------------ | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| **None**                 | No special behavior is applied.                                                               |                                                                                                   |
| **Bulky**                | Marks bulky clothing for outfit and scenario selection.                                       | It does not dynamically remove an already equipped player item when entering a car.               |
| **Remove in Vehicle**    | Hides or removes the item in eligible vehicles.                                               | Bikes, aircraft, special seats, ped state, and script overrides can behave differently.           |
| **Bike Only**            | Marks the item for bike-only ambient or outfit selection.                                     | It does not dynamically remove an already equipped player item.                                   |
| **Armoured**             | Supports the protection and replacement rules used by compatible armored headwear.            | It is not a general armor value for arbitrary vests, components, or props.                        |
| **Lightly Armoured**     | Can modify weapon damage when the hit body region maps to the flagged component.              | It does not reduce fall damage, and applying it to an arbitrary prop does not add protection.     |
| **Motorcycle Helmet**    | Marks a head prop as the normal motorcycle-helmet category used by automatic helmet handling. | The result also depends on the equipped helmet, vehicle, and automatic helmet state.              |
| **Random Helmet**        | Marks a head prop as the bicycle-helmet category.                                             | Despite its name, this is not simply a random motorcycle-helmet pool.                             |
| **Flight Equipment**     | Marks compatible head, ear, or mask equipment for aircraft helmet handling.                   | The result depends on the vehicle type, seat, and other equipment.                                |
| **Hide in First Person** | Hides the item when in first-person view.                                                     | Commonly used to prevent items from obstructing view.                                             |
| **Use Hat Physics**      | Uses the alternate knocked-off hat object for compatible head props.                          | It does not add cloth/YLD simulation or guarantee that a hat is thrown away after motorcycle use. |
| **Pilot Equipment**      | Participates in keeping or selecting pilot equipment for certain plane and helicopter seats.  | It is not guaranteed for every aircraft, passenger seat, or server script.                        |

Each of these flags provides control over how different items of clothing and accessories behave based on various conditions, allowing for nuanced gameplay and visual experiences. Some flags are context-specific, so always test the complete use case on the ped and runtime build you support.
