The Complete GTA 5 & FiveM Developer Guide Carcols.Meta

The Complete GTA 5 & FiveM Developer Guide Carcols.Meta

Full carcols.meta reference for FiveM: every VMT_* mod slot from 0 to 49, safe ModKit ID ranges, 32-bit siren sequencer values and fixes for ID conflicts.

carcols.meta is the file that decides three things on every GTA 5 and FiveM vehicle: which tuning parts exist, which IDs they claim, and how the emergency lights flash.

Get it right and parts appear in the mod shop and sirens run clean. Get one ID wrong and parts vanish from vehicles that were working yesterday — usually because another pack claimed the same number.

This is the full reference: all 50 VMT_* mod slots, ModKit structure and safe ID ranges, the 32-bit siren sequencer with paste-ready values, and how carcols.meta connects to vehicles.meta and carvariations.meta.

1. Architectural Role and Runtime Memory Pipeline

Within the Rockstar Advanced Game Engine (RAGE) and the FiveM multiplayer framework, carcols.meta operates as the central definition registry for procedural vehicle visual customization, aftermarket component indexing, emergency lighting sequences, and photometric emitter behaviors.

While vehicles.meta establishes physical bounding hierarchies, wheel scale attributes, and archetype flags, and carvariations.meta handles spawn-state configurations (color palettes, default extras, and livery indices), carcols.meta builds the internal structural bridge that binds raw polygon geometries stored within .yft model files directly to engine-level Native invocations such as SET_VEHICLE_MOD (Hash: 0x6AF0636DDEDCB6DD).

2. Complete Mod Slot Enumeration: VMT_* Enum Types (Slots 0–49)

The RAGE vehicle modification pipeline provides 50 dedicated hardware mod slots (indexed 0 to 49). To ensure total compatibility across custom UI frameworks, vMenu implementations, and mechanic scripts, every mod part registered inside carcols.meta must map directly to its corresponding VMT_* enum flag:

Native Slot ID carcols.meta Enum (VMT_*) Hardware Category / Component Description
0VMT_SPOILERAerodynamic Spoilers, Wings, and Active Aero Flaps
1VMT_BUMPER_FFront Bumpers, Splitters, and Lower Lips
2VMT_BUMPER_RRear Bumpers, Diffusers, and Undershields
3VMT_SKIRTSide Skirts and Rocker Panels
4VMT_EXHAUSTExhaust Tips, Cat-Back Systems, and Flame Points
5VMT_CHASSISInternal Roll Cages, Strut Braces, and Spaceframes
6VMT_GRILLFront Radiator Grilles and Mesh Inserts
7VMT_BONNETEngine Hoods, Cowl Inductions, and Vented Panels
8VMT_WING_LLeft Front Fender and Widebody Arch
9VMT_WING_RRight Front Fender and Widebody Arch
10VMT_ROOFRoof Panels, Carbon Caps, and Light Mounts
11VMT_ENGINEEngine Block Tuning Stages (statMods)
12VMT_BRAKESBrake Calipers and Slotted Rotors (statMods)
13VMT_GEARBOXTransmission Stages and Gear Ratios (statMods)
14VMT_HORNCustom Acoustic Horn Configurations
15VMT_SUSPENSIONSuspension Geometry & Ride Height Lowering (statMods)
16VMT_ARMOURBallistic Armor Plating Upgrades (statMods)
17VMT_NITROUSNitrous Oxide Injection Hardware
18VMT_TURBOForced Induction / Turbocharger Kits
19VMT_SUBWOOFERCabin Audio Systems and Subwoofers
20VMT_TYRE_SMOKEBurnout Tire Smoke Color Particulates
21VMT_HYDRAULICSHydraulic Suspension Accumulators & Pumps
22VMT_XENON_LIGHTSHID / Xenon Headlight Bulbs and Tint Profiles
23VMT_WHEELSFront Wheels (Automotive All / Motorcycle Front)
24VMT_WHEELS_REAR_OR_HYDRAULICSRear Wheels (Motorcycle Dedicated Rear Slot)
25VMT_PLTHOLDERLicense Plate Mounts and Decorative Holders
26VMT_PLTVANITYVanity Front Plates and Custom Badges
27VMT_INTERIOR1Interior Dashboard Panels and Carbon Trims
28VMT_INTERIOR2Cabin Ornaments, Bobbleheads, and Trinkets
29VMT_INTERIOR3Instrument Cluster Dial Housings and Faces
30VMT_INTERIOR4Interior Door Cards and Door Pull Straps
31VMT_INTERIOR5Racing Bucket Seats and Harness Assemblies
32VMT_SEATSSteering Wheels and Quick-Release Hubs
33VMT_STEERINGSequential Shifter Knobs and Linkages
34VMT_KNOBDashboard Plaques and Serial Number Badges
35VMT_PLAQUERear Parcel Shelf and Speaker Trays
36VMT_ICETrunk-Mounted In-Car Entertainment (ICE)
37VMT_TRUNKRear Trunk Lid and Tailgate Replacements
38VMT_HYDROHydraulic Trunk Tanks and Pressure Gauges
39VMT_ENGINEBAY1Engine Block Covers and Billet Accessories
40VMT_ENGINEBAY2Cold Air Intake Filters and Charge Pipes
41VMT_ENGINEBAY3Engine Bay Strut Tower Braces
42VMT_CHASSIS2Left Rear Quarter Panel / Widebody Flare
43VMT_CHASSIS3Right Rear Quarter Panel / Widebody Flare
44VMT_CHASSIS4Fender Louvers, Canards, and Vortex Generators
45VMT_CHASSIS5Fuel Filler Caps and Quick-Fill Ports
46VMT_DOOR_LLeft Door Skin and Mirror Assemblies
47VMT_DOOR_RRight Door Skin and Mirror Assemblies
48VMT_LIVERY_MODDynamic Livery / Paint Wrap Geometry Slot
49VMT_LIGHTBARRoof Light Bars, Spotlights, and Strobe Pods

3. ModKit Structure & Optimization Pipeline (<Kits>)

Mod components are cataloged inside the <Kits> array. Every part must be mapped with correct model bindings, visibility toggles, and metadata flags:

<Item> <kitName>1050_ttmodz_spec_kit</kitName> <id value="1050"/> <kitType>MKT_SPECIAL</kitType> <visibleMods> <Item> <modelName>spoiler_race_01</modelName> <modShopLabel>TT_SPOILER_01</modShopLabel> <type>VMT_SPOILER</type> <minIntVars> <Item>0</Item> </minIntVars> <maxIntVars> <Item>0</Item> </maxIntVars> <weight value="18"/> <turnOffExtra value="false"/> <disableBonnetCamera value="false"/> <allowBonnetSlide value="false"/> </Item> </visibleMods> <linkMods/> <statMods> <Item> <identifier>ENGINE_STAGE_4</identifier> <type>VMT_ENGINE</type> <modifier value="25"/> <weight value="12"/> </Item> </statMods> <slotNames> <Item> <slotName>WID_SLOT_SPOILER</slotName> <type>VMT_SPOILER</type> </Item> </slotNames> <liveryNames/> </Item>

Core Attribute Standards

  • id: A 16-bit integer identifier (0–65535). Using identical IDs across multiple addon packs causes ModKit collisions, resulting in missing parts or cross-vehicle UI bleeding. Always allocate IDs within safe custom ranges (1000–65000).
  • kitType: Mod classification flag (MKT_STANDARD, MKT_SPORT, MKT_SUPER_SPORT, or MKT_SPECIAL).
  • modelName: The internal mesh dummy name located inside the vehicle's .yft file. Must match case sensitivity exactly.
  • turnOffExtra: When set to true, automatically toggles off conflicting procedural extra_* dummies whenever this specific mod part is installed.
  • weight: Inertial physics penalty added directly to the vehicle's handling balance when the modification is fitted.

4. Non-ELS Emergency Lighting & 32-Bit Sequencer Mechanics (<sirens>)

Emergency vehicle lighting in standard FiveM architectures (Non-ELS) relies entirely on procedural sequencers, beam projection cones, and rotational vectors defined inside <sirens>.

<Item> <id value="2050"/> <name>ttmodz_pursuit_sirens</name> <timeMultiplier value="1.00000000"/> <lightFalloffMax value="35.00000000"/> <lightFalloffExponent value="10.00000000"/> <lightInnerConeAngle value="20.00000000"/> <lightOuterConeAngle value="60.00000000"/> <lightCoronaIntensity value="65.00000000"/> <sirens> <Item> <rotation> <delta value="0.00000000"/> <start value="0.00000000"/> <speed value="0.00000000"/> <sequencer value="2863311530"/> <multiples value="1"/> <direction value="0"/> <syncToBpm value="true"/> </rotation> <flashiness> <delta value="0.00000000"/> <start value="0.00000000"/> <speed value="1.00000000"/> <sequencer value="2863311530"/> <multiples value="1"/> <direction value="0"/> <syncToBpm value="true"/> </flashiness> <corona> <intensity value="35.00000000"/> <size value="0.75000000"/> <pull value="0.25000000"/> <faceCamera value="false"/> </corona> <color value="0xFFFF0000"/> <intensity value="40.00000000"/> <lightGroup value="0"/> <rotate value="false"/> <scale value="false"/> </Item> </sirens> </Item>

Binary Sequencer Calculation (32-Bit Bitmasks)

The sequencer parameter operates on a 32-bit binary timeline where 1 represents an illuminated frame and 0 represents a dark frame. Converting these binary strings to decimal integers produces precise strobe patterns:

  • High-Speed Alternating Strobe: 10101010101010101010101010101010 → Decimal: 2863311530 | Hex: 0xAAAAAAAA
  • Quad-Pulse Burst (4 On / 4 Off): 11110000111100001111000011110000 → Decimal: 4042322160 | Hex: 0xF0F0F0F0
  • Half-Cycle Split Phase (Wig-Wag Left): 11111111111111110000000000000000 → Decimal: 4294901760 | Hex: 0xFFFF0000
  • Half-Cycle Split Phase (Wig-Wag Right): 00000000000000001111111111111111 → Decimal: 65535 | Hex: 0x0000FFFF

Color and Projection Attributes

  • color (ARGB Format): 32-bit hexadecimal value (Alpha, Red, Green, Blue):
    • 0xFFFF0000: Pure Signal Red
    • 0xFF0000FF: Pure Deep Blue
    • 0xFFFFFFFF: Brilliant High-Lumen White
    • 0xFFFF8000: DOT Compliance Amber / Warning Orange
    • 0xFF00FF00: Tactical / Command Green
  • lightInnerConeAngle / lightOuterConeAngle: Defines the focused core hotspot and peripheral falloff dispersion angles of the projected light beam.
  • lightCoronaIntensity & corona.size: Governs volumetric lens bloom, distance visibility scaling, and atmospheric glare in dense fog conditions.

5. Cross-Metadata Dependency Matrix

Source (carcols.meta) Target Metadata Linked XML Node / Target Operational Purpose
<kitName>my_kit</kitName> carvariations.meta <kits><Item>my_kit</Item></kits> Binds ModKit definitions to the vehicle model entry.
<id value="2050"/> (<sirens>) carvariations.meta <sirenSettings value="2050"/> Assigns lightbar strobe profiles to the vehicle.
<id value="15"/> (<lights>) carvariations.meta <lightSettings value="15"/> Assigns headlight color, intensity, and corona sets.
<modelName>spoiler_01</modelName> vehicle.yft Hierarchy Child Mesh Node Name Links XML records to physical 3D mesh components.

6. FiveM Resource Manifest Configuration (fxmanifest.lua)

To load custom vehicle metadata into FiveM memory space without parsing errors, define both files entries and data_file registry mounts:

fx_version 'cerulean' game 'gta5' files { 'carcols.meta', 'carvariations.meta', 'handling.meta', 'vehicles.meta' } data_file 'CARCOLS_FILE' 'carcols.meta' data_file 'VEHICLE_VARIATION_FILE' 'carvariations.meta' data_file 'HANDLING_FILE' 'handling.meta' data_file 'VEHICLE_METADATA_FILE' 'vehicles.meta'

7. Developer Troubleshooting & Best Practices

  • ModKit Collision (Overlapping Menus): When two separate vehicle resources share identical ModKit numeric IDs, parts overlap or vanish in tuning shops. Always assign unique IDs across server resources.
  • Static / Non-Flashing Sirens: Ensure sequencer is not set to 0, timeMultiplier is greater than 0.0, and 3D dummy nodes are sequentially named (siren1 to siren20) under the primary chassis node.
  • Offset / Detached Mod Parts: In 3D modeling environments (Blender/ZModeler), ensure each mod part’s local axis is centered at the exact origin coordinates (0, 0, 0) relative to the base chassis before export.
  • Parser Crashes on Server Boot: Missing XML closing tags (such as unclosed </visibleMods> or </Item> blocks) will cause immediate engine initialization crashes. Validate all meta files using a strict XML linter prior to deployment.

SUPPORT & COMMUNITY CONTACT


Find more custom FiveM cars, peds, clothing packs, and maps at TTModz.

Add taxis and medical response with the FiveM city fleet pack, or browse all lore-friendly FiveM cars.


Discord 
BMW M340i FiveM sedan in green with a rear spoiler, rear three-quarter under a house carportChrysler 300C FiveM and GTA5 sedan in white with a rear lip spoiler, rear three-quarter in a cracked lotWhite Porsche 911 GT3 FiveM model from the front three-quarter, a red one parked behind in an alleyCyan chrome wrapped Mercedes-Benz EQS V297 for FiveM and GTA5, high front three-quarter parked by a curbLight blue Lamborghini Urus Mansory Venatus FiveM model with a carbon hood, front three-quarter by a houseLight blue Lamborghini Huracán Sterrato for FiveM and GTA5, black fender flares, by a shuttered buildingYellow-green Mercedes-AMG GT C190 FiveM car in low side profile on a tree-lined road with sun glareGreen BMW X6 M G06 FiveM model with silver wheels and a black front splitter, low front three-quarter downtownGrey BMW M4 Coupe F82 FiveM model with the top down and black interior, front three-quarter in a parking lotUbermacht Sentinel 5 TTS FiveM patrol car in grey Pursuit livery with blue and red lights lit, rear view in a tunnelUbermacht Sentinel GTS FiveM patrol car in dark grey livery with push bar and lit lightbar, seen under an overpassUbermacht Sentinel GTS FiveM cars in black Sheriff and white Police liveries with lights on at a gas stationDMCA.com Protection Status
DMCA.com Protection Status