vehicles.meta Flags

Comprehensive reference of all known flags (0–203) in vehicles.meta that control vehicle behavior, spawning, physics, and special abilities.

Flags 0–20: Basic Vehicle Rules

Flag	Name	Description
0	FLAG_SMALL_WORKER	Spawns only on worker-type path nodes.
1	FLAG_BIG	AI takes wider turns and avoids close chases.
2	FLAG_NO_BOOT	Legacy; unused in GTA V.
3	FLAG_ONLY_DURING_OFFICE_HOURS	Spawns only during office-hour time ranges.
4	FLAG_BOOT_IN_FRONT	Legacy; use FLAG_FRONT_BOOT instead.
5	FLAG_IS_VAN	Spawns without extra passengers in traffic.
6	FLAG_AVOID_TURNS	AI avoids intersections unless forced.
7	FLAG_HAS_LIVERY	Vehicle cycles through texture liveries.
8	FLAG_LIVERY_MATCH_EXTRA	Livery syncs with toggled extras.
9	FLAG_SPORTS	Higher prestige; alarms, faster AI, prioritized colors.
10	FLAG_DELIVERY	Parked spawns with angled wheels.
11	FLAG_NOAMBIENTOCCLUSION	Disables ambient occlusion shadows.
12	FLAG_ONLY_ON_HIGHWAYS	Only spawns on highways.
13	FLAG_TALL_SHIP	Prevents spawning under low bridges.
14	FLAG_SPAWN_ON_TRAILER	May spawn loaded onto trailers.
15	FLAG_SPAWN_BOAT_ON_TRAILER	Same as above but for boats.
16	FLAG_EXTRAS_GANG	Extras spawn if driven by gang members.
17	FLAG_EXTRAS_CONVERTIBLE	Toggles convertible roof extras.
18	FLAG_EXTRAS_TAXI	Taxi logic for roof lights and extras.
19	FLAG_EXTRAS_RARE	Extras spawn less often.
20	FLAG_EXTRAS_REQUIRE	Guarantees at least one extra appears.

Flags 21–76: Extras, Physics & Classifications

Flag	Name	Description
21	FLAG_EXTRAS_STRONG	Extras resist falling off.
22	FLAG_EXTRAS_ONLY_BREAK_WHEN_DESTROYED	Extras detach only if vehicle is destroyed.
23	FLAG_EXTRAS_SCRIPT	Blocks extras 5–9 from spawning randomly.
24	FLAG_EXTRAS_ALL	Always spawns with all extras.
25	FLAG_EXTRAS_MATCH_LIVERY	Matches extra with livery ID.
26	FLAG_DONT_ROTATE_TAIL_ROTOR	Tail rotor doesn't spin.
27	FLAG_PARKING_SENSORS	Enables parking sensor sound.
28	FLAG_PEDS_CAN_STAND_ON_TOP	Characters can stand without ragdolling.
29	FLAG_TAILGATE_TYPE_BOOT	Boot type tailgate; rarely used.
30	FLAG_GEN_NAVMESH	Generates navigation mesh around vehicle.
31	FLAG_LAW_ENFORCEMENT	Enables police behaviors like searchlights.
32	FLAG_EMERGENCY_SERVICE	Sets up emergency reactions and theft rules.
33	FLAG_DRIVER_NO_DRIVE_BY	Driver cannot perform drive-bys.
34	FLAG_NO_RESPRAY	Can't be resprayed in mod shops.
35	FLAG_IGNORE_ON_SIDE_CHECK	AI ignores "on side" vehicle state.
36	FLAG_RICH_CAR	Driven by "rich" NPCs.
37	FLAG_AVERAGE_CAR	Driven by average NPCs.
38	FLAG_POOR_CAR	Driven by poorer NPCs.
39	FLAG_ALLOWS_RAPPEL	Peds can rappel from vehicle.
40	FLAG_DONT_CLOSE_DOOR_UPON_EXIT	Peds leave doors open.
41	FLAG_USE_HIGHER_DOOR_TORQUE	Doors resist more force.
42	FLAG_DISABLE_THROUGH_WINDSCREEN	Prevents windshield ejection.
43	FLAG_IS_ELECTRIC	Vehicle behaves as electric (no fuel leaks).
44	FLAG_NO_BROKEN_DOWN_SCENARIO	Won't spawn as abandoned/broken.
45	FLAG_IS_JETSKI	Vehicle is a jetski.
46	FLAG_DAMPEN_STICKBOMB_DAMAGE	Reduces sticky bomb damage.
47	FLAG_DONT_SPAWN_IN_CARGEN	Not included in random traffic gens.
48	FLAG_IS_OFFROAD_VEHICLE	AI considers off-road paths valid.
49	FLAG_INCREASE_PED_COMMENTS	More NPC comments about it.
50	FLAG_EXPLODE_ON_CONTACT	Explodes on collision.
51	FLAG_USE_FAT_INTERIOR_LIGHT	Brighter interior lights.
52	FLAG_HEADLIGHTS_USE_ACTUAL_BONE_POS	Uses bone position for headlights.
53	FLAG_FAKE_EXTRALIGHTS	Extra lights treated as headlights.
54	FLAG_CANNOT_BE_MODDED	Can't be customized in shops.
55	FLAG_DONT_SPAWN_AS_AMBIENT	Won't spawn in general traffic.
56	FLAG_IS_BULKY	AI treats it as bulky.
57	FLAG_BLOCK_FROM_ATTRACTOR_SCENARIO	Won't spawn in scripted attractor scenes.
58	FLAG_IS_BUS	Vehicle is classified as a bus.
59	FLAG_USE_STEERING_PARAM_FOR_LEAN	Steering affects body lean.
60	FLAG_CANNOT_BE_DRIVEN_BY_PLAYER	Player can't drive it.
61	FLAG_SPRAY_PETROL_BEFORE_EXPLOSION	Sprays fuel before blowing up.
62	FLAG_ATTACH_TRAILER_ON_HIGHWAY	Spawns with trailer on highways.
63	FLAG_ATTACH_TRAILER_IN_CITY	Spawns with trailer in city.
64	FLAG_HAS_NO_ROOF	No roof logic (affects hats, anims).
65	FLAG_ALLOW_TARGETING_OF_OCCUPANTS	Can target passengers.
66	FLAG_RECESSED_HEADLIGHT_CORONAS	Headlights are recessed.
67	FLAG_RECESSED_TAILLIGHT_CORONAS	Taillights are recessed.
68	FLAG_IS_TRACKED_FOR_TRAILS	Tracks for trail effects.
69	FLAG_HEADLIGHTS_ON_LANDINGGEAR	Aircraft lights tied to landing gear.
70	FLAG_CONSIDERED_FOR_VEHICLE_ENTRY_WHEN_STOOD_ON	Easier to enter when on top.
71	FLAG_GIVE_SCUBA_GEAR_ON_EXIT	Gives scuba gear when exiting.
72	FLAG_IS_DIGGER	Classified as digger type.
73	FLAG_IS_TANK	Tank behavior (armor, physics).
74	FLAG_USE_COVERBOUND_INFO_FOR_COVERGEN	AI uses vehicle for cover.
75	FLAG_CAN_BE_DRIVEN_ON	Can drive on top of it.
76	FLAG_HAS_BULLETPROOF_GLASS	Windows/glass won't shatter.

Flags 77–120: Next-Gen / Online Additions

Flag	Name	Description
77	FLAG_CANNOT_TAKE_COVER_WHEN_STOOD_ON	Peds can't use it for cover.
81	FLAG_DRIVER_SHOULD_BE_FEMALE	Only female AI drivers.
82	FLAG_DRIVER_SHOULD_BE_MALE	Only male AI drivers.
90	FLAG_CAN_HONK_WHEN_FLEEING	AI honks while fleeing.
95	FLAG_CANNOT_BE_PICKUP_BY_CARGOBOB	Blocks Cargobob lift.
96	FLAG_CAN_HAVE_NEONS	May spawn with neons.
97	FLAG_HAS_INTERIOR_EXTRAS	Spawns with interior extras.
104	FLAG_DISABLE_WEAPON_WHEEL_IN_FIRST_PERSON	Weapon wheel disabled in FP view.
105	FLAG_USE_PILOT_HELMET	Forces pilot helmet.
114	FLAG_HAS_GULL_WING_DOORS	Doors open upwards.
118	FLAG_HAS_REAR_SEAT_ACTIVITIES	Special rear seat functions.
119	FLAG_HAS_LOWRIDER_HYDRAULICS	Enables hydraulics.
120	FLAG_HAS_BULLET_RESISTANT_GLASS	Bullet-resistant windows.

Flags 121–203: DLC & Arena War (Weaponized / Special)

Flag	Name	Description
121	FLAG_HAS_INCREASED_RAMMING_FORCE	More powerful ramming.
125	FLAG_JUMPING_CAR	Vehicle can jump.
126	FLAG_HAS_ROCKET_BOOST	Rocket boost ability.
128	FLAG_HAS_PARACHUTE	Deployable parachute.
129	FLAG_RAMP	Flips cars like a stunt ramp.
132	FLAG_HALF_TRACK	Marks as half-track.
137	FLAG_HAS_GLIDER	Can glide.
138	FLAG_INCREASE_LOW_SPEED_TORQUE	Boosts low-speed torque.
139	FLAG_USE_AIRCRAFT_STYLE_WEAPON_TARGETING	Aircraft-style aiming.
146	FLAG_HAS_EJECTOR_SEATS	Ejects peds mid-air.
148	FLAG_HAS_JATO_BOOST_MOD	Jet-assisted takeoff boost.
154	FLAG_HAS_VERTICAL_FLIGHT_MODE	VTOL style.
161	FLAG_HAS_VERTICAL_ROCKET_BOOST	Boosts upward instead of forward.
174	FLAG_HAS_NITROOUS_MOD	Nitro boost.
175	FLAG_HAS_JUMP_MOD	Jump via mod upgrade.
176	FLAG_HAS_RAMMING_SCOOP_MOD	Ramming scoop via mod.
178	FLAG_CRUSHES_OTHER_VEHICLES	Crushes vehicles when driving over.
179	FLAG_HAS_WEAPON_BLADE_MODS	Sawblade damage mods.
180	FLAG_HAS_WEAPON_SPIKE_MODS	Spike mods.
183	FLAG_HAS_TOMBSTONE	Ejectable rear tombstone barrier.
184	FLAG_HAS_SIDE_SHUNT	Side-shunt attack ability.
188	FLAG_HAS_SUPERCHARGER	Always shows supercharger boost.
190	FLAG_DISABLE_DEFORMATION	No visual body deformation.
197	FLAG_IS_FORMULA_VEHICLE	Formula-specific physics.
203	FLAG_PREFER_FRONT_SEAT	AI prefers front seats when entering.

Implementation Example

Flags are set in vehicles.meta as space-separated values within a single <flags> element:

<Item>
  <modelName>07gal</modelName>
  <layout>LAYOUT_LOW</layout>
  <flags>FLAG_SPORTS FLAG_RICH_CAR FLAG_AVERAGE_CAR FLAG_NO_BROKEN_DOWN_SCENARIO FLAG_HAS_INTERIOR_EXTRAS</flags>
  <type>VEHICLE_TYPE_CAR</type>
  <!-- other vehicle properties -->
</Item>

Important: Flags are space-separated on a single line, not individual elements. List as many flags as needed separated by spaces.

Flag Categories

Spawning & Traffic: Flags 0–6, 12–15, 47, 55, 62–63 Extras & Customization: Flags 7–8, 16–25, 96–97 NPC Behavior: Flags 28, 31–32, 36–39, 49, 81–82 Physics & Damage: Flags 46, 50, 61, 73, 75, 121, 138, 190 Visual Customization: Flags 34, 54, 66–67 Weaponized Features: Flags 125–129, 146, 148, 154, 174–180, 183–184, 188

Common Modding Tips

• Use FLAG_DONT_SPAWN_IN_CARGEN (47) to prevent custom vehicles from spawning naturally
• Combine FLAG_CANNOT_BE_MODDED (54) with FLAG_NO_RESPRAY (34) to lock down special vehicles
• FLAG_SPORTS (9) makes vehicles higher priority in traffic and increases prestige
• Weaponized flags (125+) are primarily for Arena War/DLC content but can be applied to any vehicle
• FLAG_HAS_LIVERY (7) requires matching entries in carvariations.xml

Important Notes

• Some flags are legacy (marked as "unused") and may not function
• Online-only flags may behave differently on FiveM servers
• Weaponized flags require proper handling to avoid unintended behavior
• Always test flag combinations in single-player before deploying to production