What is a VCF (vehicle configuration file)?
A VCF (vehicle configuration file) is an XML file read by ELS, the Emergency Lighting System, that describes the emergency equipment of one specific vehicle model. It states which of the model's extras are lights and what colour they are, which siren tones and horn the vehicle uses, and which flash patterns the primary, secondary and warning lights run. ELS looks up the file by the vehicle's spawn name, so every ELS vehicle on a server needs a VCF named after its model.
What a VCF contains
The file is organised into blocks, each covering one aspect of the vehicle's equipment. The exact set of supported tags depends on the ELS resource in use, but the layout inherited from the original single-player ELS is broadly the same everywhere:
| Block | Purpose |
|---|---|
INTERFACE | How the lighting controls are presented and activated |
EOVERRIDE | One entry per vehicle extra: whether ELS controls it, its light colour and the position of its glow |
MISC | Options such as takedown lights, scene lights and arrow boards |
CRUISE | Which lights stay on as steady cruise lights |
SOUNDS | The horn and the siren tones the vehicle uses |
WRNL, PRML, SECL | Warning, primary and secondary light configuration and patterns |
Have the resource on disk already? The Resource Inspector checks its manifest, stream files, textures and metas in your browser. Open the Resource Inspector
Example
<?xml version="1.0" encoding="utf-8"?>
<vcfroot Description="Example patrol car" Author="Your Name">
<EOVERRIDE>
<Extra01 IsElsControlled="true" AllowEnvLight="true" Color="red" />
<Extra02 IsElsControlled="true" AllowEnvLight="true" Color="blue" />
<Extra03 IsElsControlled="true" AllowEnvLight="true" Color="white" />
<!-- one line per extra on the model -->
</EOVERRIDE>
<SOUNDS>
<MainHorn InterruptsSiren="true" AudioString="SIRENS_AIRHORN" />
<SrnTone1 AllowUse="true" AudioString="VEHICLES_HORNS_SIREN_1" />
<SrnTone2 AllowUse="true" AudioString="VEHICLES_HORNS_SIREN_2" />
</SOUNDS>
<!-- INTERFACE, MISC, CRUISE, WRNL, PRML and SECL blocks omitted -->
</vcfroot>Always start from the VCF that ships with the vehicle. The extras on a model are numbered by its author, so a VCF written for one light bar layout will light the wrong parts on another.
Where it goes and how it is named
In single-player ELS, VCFs sit in a folder inside the game directory. On FiveM they belong to the ELS resource, not to the vehicle resource: the file is copied into that resource's VCF folder, and resources that keep an explicit list of VCF files need the new file added to the list.
The name is the link. The file must be named after the vehicle's spawn name, so a car spawned as police3 needs police3.xml. If you rename a vehicle, rename its VCF too. A replace police car that takes over the stock police model needs police.xml.
els-resource/
fxmanifest.lua
vcf/
police.xml
police3.xml
sheriff2.xmlCommon problems and fixes
- Lights do nothing: the VCF is missing, misnamed or not registered with the ELS resource. Check the name against the model name character by character.
- All extras visible and static: ELS is not managing the car at all. The ELS resource is not running or has no VCF for the model.
- Wrong parts light up, or colours are swapped: the VCF belongs to a different model or a different version of the same model.
- ELS resource fails to start after adding a file: the XML is malformed. A missing closing tag or quote in one VCF can stop the resource from parsing its files.
- Car is non-ELS: it has no VCF and does not need one. Its lights come from carcols.meta; see ELS vs non-ELS.
If the console shows errors when the ELS resource starts, the Error Analyzer can help narrow down the cause. The ELS installation guide walks through a full setup. Converting LSPDFR police cars covers registering the VCF with ELS-FiveM for a vehicle that started as an LSPDFR download.
Frequently asked questions
Where do I put VCF files on a FiveM server?
In the VCF folder of your ELS resource, not in the vehicle's own resource. Some ELS resources also require each file to be listed in a configuration file.
What should a VCF file be named?
Exactly the spawn name of the vehicle with the .xml extension. A vehicle spawned as police3 needs a file called police3.xml.
Do non-ELS vehicles need a VCF?
No. Non-ELS vehicles use the game's built-in siren system, configured in carcols.meta and carvariations.meta.
Tools for this
Related guides
Related terms
Still need the car as a FiveM resource?
Paste a gta5-mods.com vehicle link and get a FiveM-ready resource with the manifest and metas in place. 3 free conversions, no signup.
- 3 conversions free, no account needed
- 2 more free if you leave an email
- After that: $15 once for unlimited conversions and the Pro tools. No subscription, 14-day refund policy