Emergency Vehicles

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:

BlockPurpose
INTERFACEHow the lighting controls are presented and activated
EOVERRIDEOne entry per vehicle extra: whether ELS controls it, its light colour and the position of its glow
MISCOptions such as takedown lights, scene lights and arrow boards
CRUISEWhich lights stay on as steady cruise lights
SOUNDSThe horn and the siren tones the vehicle uses
WRNL, PRML, SECLWarning, 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
<?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>
Heavily abridged illustration of the VCF layout, not a complete working file

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.

text
els-resource/
  fxmanifest.lua
  vcf/
    police.xml
    police3.xml
    sheriff2.xml
Typical placement; folder names vary between ELS resources

Common 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.

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