vehicles.meta Flags: A Selected Reference

The flags field in vehicles.meta is a space-separated list of named flag bits, each controlling a specific behavior. The complete list runs to dozens of entries; this post covers the most commonly used ones with their documented purpose, sourced from the GTAMods wiki.

Customization and visual flags

• FLAG_HAS_LIVERY - "This vehicle has liveries, some texture will be swapped upon instancing." Required if you want livery options to appear at LS Customs.
• FLAG_NO_RESPRAY - "Vehicle is not allowed to be resprayed at garages." Used for emergency vehicles or others where paint changes should be locked.
• FLAG_RICH_CAR - influences vehicle generation; rich cars spawn in wealthier areas.

Class and behavior flags

• FLAG_LAW_ENFORCEMENT - marks the vehicle as a police/law-enforcement type, affecting AI behavior and dispatch logic.
• FLAG_IS_BUS - vehicle behaves as a bus (passenger AI behavior).
• FLAG_IS_VAN - vehicle behaves as a van.
• FLAG_IS_OFFROAD_VEHICLE - influences AI driving behavior and engine sound choices for off-road vehicles.
• FLAG_IS_ELECTRIC - electric vehicle. Affects sound and refuel scenarios.
• FLAG_IS_TANK - tank behavior (turret, treads).
• FLAG_IS_JETSKI - jet ski watercraft behavior.
• FLAG_IS_BULKY - large vehicle, affects parking and traffic generation.
• FLAG_SMALL_WORKER - small commercial/work vehicle category.

Headlight and taillight flags

• FLAG_HEADLIGHTS_ON_LANDINGGEAR - aircraft-specific; headlights mount on the landing gear.
• FLAG_HEADLIGHTS_USE_ACTUAL_BONE_POS - emit headlights from the actual bone position rather than the calculated default.
• FLAG_RECESSED_HEADLIGHT_CORONAS - the bright corona/glow effect is recessed into the body geometry.
• FLAG_RECESSED_TAILLIGHT_CORONAS - same for taillights.

Roof and body construction flags

• FLAG_HAS_NO_ROOF - convertible / open-top vehicle. Affects cover behavior and rain handling.
• FLAG_NO_BOOT - vehicle has no rear cargo area / trunk.
• FLAG_INTERIOR_BLOCKED_BY_BOOT - boot/trunk geometry blocks rear interior visibility.

Turret and weapons flags

• FLAG_HAS_REAR_MOUNTED_TURRET - vehicle has a rear-mounted turret.
• FLAG_HAS_TURRET_SEAT_ON_VEHICLE - turret has its own seat position.
• FLAG_PREFER_ENTER_TURRET_AFTER_DRIVER - AI passenger preference for entering turret over standard seats.

Misc / utility flags

• FLAG_PARKING_SENSORS - vehicle has parking sensors (proximity beep behavior).
• FLAG_PEDS_CAN_STAND_ON_TOP - peds can walk on top of the vehicle without sliding off.
• FLAG_REPORT_CRIME_IF_STANDING_ON - standing on top of this vehicle is reported as a crime.
• FLAG_INCREASE_PED_COMMENTS - vehicle generates more ambient ped commentary when nearby.
• FLAG_NO_BROKEN_DOWN_SCENARIO - this vehicle does not generate the broken-down-on-roadside scenario.
• FLAG_IGNORE_ON_SIDE_CHECK - skip the lying-on-side check for this vehicle.
• FLAG_IGNORE_RWINDOW_COLLISION - rear window has no collision (typical for hatchbacks where the rear glass is mostly cosmetic).

How to read the official flag list

The GTAMods wiki page for vehicles.meta has the complete flag list with brief descriptions. Some flags have engine-side behavior that is poorly documented; if a specific flag does not seem to do what you expect, search the Cfx.re forum for community-discovered behavior - several flags have community knowledge that has not been formalized in the wiki.

Combining flags

Flags are space-separated within the flags field. A typical sport-car entry might look like:

<flags>FLAG_RICH_CAR FLAG_RECESSED_HEADLIGHT_CORONAS FLAG_RECESSED_TAILLIGHT_CORONAS</flags>

An emergency-vehicle entry might include FLAG_LAW_ENFORCEMENT and FLAG_NO_RESPRAY together. Each flag is independent; they do not conflict unless documented otherwise.

Sources

• GTAMods Wiki: vehicles.meta (#flags section)