Reference

carcols.meta

The mod kit file: every part the mod shop can fit, every performance upgrade it can sell, and the siren setup for emergency vehicles.

File structure

carcols.meta declares mod kits. A kit is a named bundle of parts and upgrades; carvariations.meta then attaches that kit to a vehicle. Without a kit entry, a vehicle simply has nothing to buy in the mod shop.

The file has two top-level blocks: <Kits> for the mod kits themselves, and <Lights> for siren definitions. Most add-ons only need the first.

Skeleton

<CVehicleModelInfoVarGlobal>
  <Kits>
    <Item>
      <kitName>1234_mycar_modkit</kitName>
      <id value="1234" />
      <kitType>MKT_STANDARD</kitType>
      <visibleMods>
        <Item>
          <modelName>mycar_spoiler_1</modelName>
          <modShopLabel>MYCAR_SP1</modShopLabel>
          <linkedModels />
          <turnOffBones />
          <type>VMT_SPOILER</type>
          <bone>chassis</bone>
          <collisionBone>chassis</collisionBone>
          <cameraPos>VMCP_DEFAULT</cameraPos>
          <audioApply value="1.000000" />
          <weight value="10" />
          <turnOffExtra value="false" />
          <disableBonnetCamera value="false" />
          <allowBonnetSlide value="true" />
        </Item>
      </visibleMods>
      <statMods />
      <slotNames />
      <sirenSettings value="0" />
    </Item>
  </Kits>
  <Lights />
</CVehicleModelInfoVarGlobal>

Kit header

Name	Type	Description	Typical
kitName	string	Name referenced from carvariations.meta. Convention is `<id>_<model>_modkit`, which keeps ids and names in sync and makes clashes obvious.	—
id	integer	Unique numeric identifier. Must not collide with any other kit on the server.	—
kitType	enum	Which mod shop category the kit belongs to. Decides which garage sells it.	MKT_STANDARD
sirenSettings	integer	Index into the siren definitions in `<Lights>`. 0 for a vehicle with no sirens.	—

kitType values

Name	Description
MKT_STANDARD	Standard mod shop. The right choice for almost every add-on.
MKT_SPORT	Sports category.
MKT_SUV	SUV category.
MKT_SPECIAL	Special vehicles — Benny’s and similar.

Visible mods

Each <Item> in <visibleMods> is one physical part the shop can fit. The modelName must match a mesh that exists in the .yft — the part is not a separate file, it lives inside the vehicle model and is hidden until fitted.

Name	Type	Description	Typical
modelName	string	Name of the mesh inside the .yft. Case-sensitive and must match exactly.	—
modShopLabel	string	GXT label for the name shown in the shop. Without a matching text entry the part shows as a blank or raw label.	—
linkedModels	list	Other meshes shown at the same time as this part. Used when one visual upgrade spans several separate meshes.	—
turnOffBones	list	Bones hidden when this part is fitted. This is how a body kit removes the stock bumper it replaces.	—
type	enum	Which mod slot the part occupies. One part per slot at a time.	—
bone	string	Bone the part attaches to. `chassis` for most body parts.	—
collisionBone	string	Bone providing collision for the part.	—
cameraPos	enum	Where the mod shop camera frames the part while previewing it.	VMCP_DEFAULT
audioApply	float	Multiplier applied to the exhaust sound. Only meaningful on exhaust parts.	1.0
weight	integer	Weight added by the part. Feeds the in-game stat display; the physical effect is minimal.	—
turnOffExtra	boolean	Whether fitting this part disables the matching extra.	—
disableBonnetCamera	boolean	Disables the hood camera while this part is fitted — needed for tall scoops.	—
allowBonnetSlide	boolean	Allows the hood camera to slide back when the part blocks the view.	—

Body and exterior slots

Name	Description
VMT_SPOILER	Rear spoiler.
VMT_BUMPER_F	Front bumper.
VMT_BUMPER_R	Rear bumper.
VMT_SKIRT	Side skirts.
VMT_EXHAUST	Exhaust.
VMT_CHASSIS	Roll cage or chassis kit.
VMT_GRILL	Grille.
VMT_BONNET	Hood.
VMT_WING_L	Left fender.
VMT_WING_R	Right fender.
VMT_ROOF	Roof.
VMT_TRUNK	Boot or trunk part.
VMT_DOOR_L	Left door part.
VMT_DOOR_R	Right door part.
VMT_CHASSIS2 … VMT_CHASSIS5	Extra chassis slots for wide body kits.
VMT_LIVERY_MOD	Livery fitted as a mod rather than a texture.
VMT_PLTHOLDER	Plate holder.
VMT_PLTVANITY	Vanity plate.

Interior slots

Name	Description
VMT_INTERIOR1 … VMT_INTERIOR5	Dashboard, trim and interior panels.
VMT_SEATS	Seats.
VMT_STEERING	Steering wheel.
VMT_KNOB	Shifter knob.
VMT_PLAQUE	Interior plaque.
VMT_ICE	Audio system.
VMT_ENGINEBAY1 … VMT_ENGINEBAY3	Engine bay dressing.
VMT_HYDRO	Hydraulics.

Stat mods

Stat mods are the performance upgrades. They have no mesh — they only change numbers. Each entry has an identifier naming the slot, a modifier giving the level, and the usual weight and audio fields.

Levels run from 0 upward. The game applies the strength; you choose how many levels exist by how many items you declare.

Performance slots

Name	Description
VMT_ENGINE	Engine upgrade — raises drive force.
VMT_BRAKES	Brake upgrade — raises brake force.
VMT_GEARBOX	Transmission — faster shifts.
VMT_SUSPENSION	Suspension — lowers ride height and stiffens the car.
VMT_ARMOUR	Armour — reduces damage taken, adds weight.
VMT_NITROUS	Nitrous, where the game mode supports it.
VMT_TURBO	Turbo — adds power and the turbo sound.
VMT_SUBWOOFER	Subwoofer. Cosmetic and audio only.
VMT_HORN	Horn sound.

Three levels of engine upgrade

<statMods>
  <Item>
    <identifier>VMT_ENGINE</identifier>
    <modifier value="1" />
    <audioApply value="1.000000" />
    <weight value="0" />
  </Item>
  <Item>
    <identifier>VMT_ENGINE</identifier>
    <modifier value="2" />
    <audioApply value="1.000000" />
    <weight value="0" />
  </Item>
  <Item>
    <identifier>VMT_ENGINE</identifier>
    <modifier value="3" />
    <audioApply value="1.000000" />
    <weight value="0" />
  </Item>
</statMods>

Siren settings

The <Lights> block defines siren light patterns for emergency vehicles. Each entry is referenced by index from the kit or from carvariations.meta. Building these by hand is painful — the community siren editors write this block for you, and there is no advantage to doing it manually.

Siren set header

Name	Type	Description
id	integer	Index referenced by sirenSettings.
name	string	Readable name for the set.
timeMultiplier	float	Global speed of the whole sequence.
lightFalloffMax	float	Maximum distance the light reaches.
lightFalloffExponent	float	How sharply the light fades with distance.
lightInnerConeAngle	degrees	Angle of the bright inner cone.
lightOuterConeAngle	degrees	Angle of the soft outer cone.
lightOffset	float	Offset of the light from its bone.
textureName	string	Corona texture used for the flare.
sequencerBpm	integer	Tempo of the flash sequence.

Per-siren item

Name	Type	Description
rotation	block	Rotation sequence, speed, start angle and delta.
flashiness	block	Flash sequence and intensity over time.
corona	block	Corona size, intensity and face-camera behaviour.
color	ARGB hex	Colour of this light.
intensity	float	Brightness.
lightGroup	integer	Group used to switch banks of lights together.
scale	float	Size of the light.