Adding Vehicles

Adding vehicles is a tedious task if you have a large number of vehicles that need to be added to the system at once, to assist with this if the majority of your vehicles will have the same information you can utilise the provided _DEFAULT.json file. This file is used when the ELS cannot find a JSON file for the vehicle you have listed.

This file can only be used for ELS vehicles

ELS Vehicles

The first step to take is to clone the _DEFAULT.json file in the ELS folder. Once you have cloned it, you should name it SPAWNCODE.json replacing SPAWNCODE with the spawn code of your vehicle. After you have created the file, go into it and begin to customise it for your vehicle.

Non-ELS Vehicles

The first step to take is to clone the NONELS.json file in the ELS folder. Once you have cloned it, you should name it SPAWNCODE.json replacing SPAWNCODE with the spawn code of your vehicle. After you have created the file, go into it and begin to customise it for your vehicle.

The majority of configuration for non-ELS vehicles is completed in the config.lua file.

JSON File Options

Extra Controls (ELS Only)

This section is where you provide all the information for how an extra should act. The customisable options are:

• colour - The accepted values are blue, red, white, amber, green. This is the colour of the environmental lights.

• enabled - This controls if oELS is able to control this extra, the accepted values are true/false.

• allowEnvLight - This controls if environmental lighting is made for that extra if it is turned on, the accepted values are true/false.

• directions - This is a table and will generate environmental lights in all directions listed when that extra is turned on. Accepted values are:

  • front

  • frontRight

  • right

  • backRight

  • back

  • backLeft

  • left

  • frontLeft

• offset - This is the offset used when the directional lighting is created, we recommend getting this from the creator or using the default ones provided.

Light Setup

This section is where you will define the pattern used as well as which other stages are activated when the primary lighting is turned on.

• lightPattern - The name of the pattern as displayed in your config.lua file.

• seconaryWithPrimary - Accepted values for this are true/false, will decide if the secondary pattern is turned on.

• warningWithPrimary - Accepted values for this are true/false, will decide if the warning pattern is turned on.

Sirens

This section is where you can define if the vehicle has sirens and if it has a bullhorn as well as the sounds for both.

• enabled - Accepted values are true/false, and will decide if sirens can be used on this vehicle.

• bullhorn - All settings of the bullhorn can be found here.

  • enabled - Accepted values are true/false, and will decide if the bullhorn can be used.

  • soundFile - The hash for the found file to use, if you have a custom pack see the creator.

  • soundPack - If you are using a default GTA hash, this can be 0 otherwise see pack creator.

• sirens - The amount of sirens a vehicle has is decided by how many entries are in this table.

  • soundFile - The hash for the found file to use, if you have a custom pack see the creator.

  • soundPack - If you are using a default GTA hash, this can be 0 otherwise see pack creator.

Misc

This is where all misc controls for the ELS are including steadyBurns, spotlights and who can control the ELS.

• steadyBurns (ELS ONLY)

  • enabled - Accepted values are true/false, does the vehicle have steady burns?

  • extras - If the above is true, put the numbers of the extras that are steady burns in here.

• seatsCanControl - This is a table of numbers determining which seats of the vehicle can control ELS.

  • -1 - Driver

  • 0 - Passenger

  • 1 - Rear Passenger (Driver Side)

  • 2 - Rear Passenger (Passenger Side)

• alleyLights (ELS ONLY)

  • enabled - Accepted values are true/false, Does the vehicle have alley lights?

  • leftExtra - If you use an extra for the left alley light, put the number here

  • rightExtra - If you use an extra for the right alley light, put the number here