Els User Guide

5/19/2018 Els User Guide

1/25

Luxart Emergency Lighting System

USER GUIDE AND REFERENCE- SECOND EDITION -

ELS V8.0


2/25

ELS User Guide and Reference

1

Then He said, let there be light; and there was light.

The ELS User Guide and Reference is written and illustrated by Lt.Caine.

Copyright 2014 Luxart


3/25


2

Table of Contents

SEC. 1 EMERGENCY LIGHTING SYSTEM OVERVIEW .............................................................................................................................................................. ................

1.01 DISCLAIMER ............................................................................................................................................................................................................................

1.02 INTRODUCTION ...................................................................................................................................................... .................................................................

1.03 CREDITS AND ACKNOWLEDGEMENTS (ELS V8.0) ....................................................................................................................................................................

1.04 OPERATION AND LIMITATIONS ...............................................................................................................................................................................................

1.05 REQUIREMENTS ......................................................................................................................................................................................................................

1.06 INSTALLATION ............................................................................................................................................................................ .............................................

SEC. 2 GENERAL CONFIGURATION FILES ..............................................................................................................................................................................................

2.01 ELS.INI OVERVIEW...................................................................................................................................................................................................................

2.02 ELS.INI: CONTROLS SECTION ...................................................................................................................................................................................................

2.03 ELS.INI: INTERFACE SECTION ......................................................................................................................................................... ..........................................

2.04 ELS.INI: ENV LIGHTING SECTION ...................................................................................................................................................................................... .......

2.05 ELS.INI: MISC SETTINGS SECTION ........................................................................................................................................................ ....................................

2.06 VEHICLE SLOT CONTROL FILE .............................................................................................................................................................................................. ....

SEC. 3 VEHICLE CONFIGURATION FILES ................................................................................................................................................................................................

3.01 OVERVIEW ............................................................................................................... ...............................................................................................................

3.02 NOTE REGARDING SLICKTOP OPTION AND ENV. LIGHT POSITIONS ........................................................................................................................................

SEC. 4 MAIN ELS FEATURES ............................................................................................................................................................... ...................................................

4.01 ELS INFORMATION DISPLAY PANEL .........................................................................................................................................................................................

4.02 LIGHTING TIERS ................................................................................................................................................................................ .......................................

4.03 LIGHTING TYPES ......................................................................................................................................................................................................................

4.04 LIGHTING STAGES ................................................................................ ...................................................................................................................................

4.05 ELS MAIN SIREN AND SPECIAL HORNS ....................................................................................................................................................................................

4.06 SECONDARY SIREN ..................................................................................................................................................................................................................

4.07 TAKEDOWNS ...........................................................................................................................................................................................................................

4.08 BLACKOUT MODE ..................... ........................................................................................................................................................................................... ...

4.09 CRUISE MODE .........................................................................................................................................................................................................................

4.10 EXPRESS MODE .......................................................................................................................................................................................................................

4.11 ELS KEY LOCK ........................................................................................................................................................... ...............................................................

4.12 ARROW BOARDS .......................................................................................................................................................... ...........................................................

4.13 CORONAS .............................................................................................................................................................................. ..................................................

4.14 TAKEDOWN CORONAS ........................................................................................................................................................ ....................................................

4.15 MULTIPLAYER ................................................ .........................................................................................................................................................................

SEC. 5 VEHICLE MODEL MODIFICATIONS .............................................................................................................................................................................................

5.01 HOW ELS WORKS ....................................................................................................................................................................................................................

5.02 ELS EXTRA PART ALLOCATIONS .................................................................................................................................................. .............................................

5.03 EXTRA 10 ...................................................................................................................................................... ...........................................................................

5.04 NOTE REGARDING SECL LEDS AND STRB TYPES ............................................................ ..........................................................................................................

5.05 NOTE REGARDING ARROW BOARDS .......................................................................................................................................................................................


4/25


3

5.06 ADJUSTING A VEHICLE MODEL FOR CORONAS .......................................................................................................................................................................

SEC. 6 APPENDIX ..................................................................................................................................................................................................................................

6.01 ELS ABBREVIATIONS ............................................................................................................................................................................... .................................

6.02 CONTROL KEY CODES ..............................................................................................................................................................................................................

6.03 VEHICLE MODEL NAMES .........................................................................................................................................................................................................

6.04 ELS PART PLACEMENT .................................................................................................................................................. ...........................................................

6.05 ELS.INI OPTIONS .......................................................................................................................................................... ............................................................

6.06 VEHICLE SLOT CONTROL OPTIONS ..........................................................................................................................................................................................

6.07 VEHICLE CONFIGURATION FILE OPTIONS ....................................................................................................................................................... .........................


5/25


4

Sec. 1 Emergency Lighting System overview

1.01 DISCLAIMER

The Luxart Emergency Lighting System (ELS) is freeware and may not be exploited for personal, financial or commercial gain. ELS is provided witho

any form of warranty. Therefore, responsibility for any damages caused by this product or its misuse rest solely with the user, as the author will acc

no liability. Redistribution of this product is authorized unless instructed otherwise by the author. However, the following condition(s) must be met:

contents of the archive containing this document and the product (ELS.asi file and its dependents) must not be modified or tampered with; this

document must remain in its original state and must not be modified in any way; this document must be provided alongside the product; and all pro

credits must be clearly indicated and respected.

1.02 INTRODUCTION

The Luxart Emergency Lighting System (ELS) is a modification for the PC platform version of the game Grand Theft Auto IV (GTAIV) by Rockstar

Games. ELS is a .ASI script modification meant to alter the behavior of the game. Its purpose is to provide emergency lighting and audio effects fo

vehicle models specifically configured to make use of ELSs features (pro-ELS models).

1.03 CREDITS AND ACKNOWLEDGEMENTS (ELS V8.0)

ELS is coded by L t . C a i n e using the C++ ScriptHook development toolkit by Aru.

The default ELS configuration files, Luxart ELS documentation materials, and ELS User Guide and Reference are authored by Lt.Caine.

Many ELS V8 features are the result of a collaborative effort between Luxart Systems and the G17 Media team, using the powerful AdvancedHook

Library System created by LMS. As such, ELS features code contributions from the following people:

LMS

Sam

Furthermore, to underscore their invaluable participation in the ELS project, the contributions and assistance of the following people must be

acknowledged:

LMS, for his powerful AdvancedHook, the amazing features of which (including the vehicle damage enablement system) ELS depends upon, in addition to his valued assistance wit

AdvancedHook, numerous contributions to the ELS code, his persistence with regard to the vehicle damage is sue, and his very generous and invaluable work pertaining to ELS

debugging and crash prevention;

Sam, for his valued assistance and contributions to the ELS code, his powerful and professional public relations skills and work on behalf of ELS, as well as his persistent desire to le

helping hand;

PoliceWag, for his expert feedback, suggestions, and extremely dedic ated help and patience, particularly in testing MP compatibilityhe is the in spiration and motivation for ELS

online features, and he worked tirelessly to ensure that these were up to standard;

BxBugs123, for hisdedicated help, feedback, andconstant innovation with regard to ELS vehicle models.

NicolaiB, for his unrelenting help and support throughout the testing process and, of course, for his awesome videos;

Break, for his advice regarding German lighting patterns, his countless suggestions, and his instrumental assistance in weeding out issues;

cp702, for his valued assistance in weeding out issues and, without whose persistence, ELS would not have supported added vehicle slots;

Aru, AlexanderBlade, and HazardX, without whom coding for GTAIV would be impossible; and,

the ELS users, who ultimately provide the motivation necessary to take upon such endeavors.

The ELS testing team consisted of (in alphabetical order, except lead): PoliceWag(lead), bosco154, Break, BxBugs123, cp702, James, kjel0112,

Mag292, NicolaiB, Sam, SnH FireFighter, UndercoverChicken, and VooDoobie. The releases of ELS version 7 and subsequent iterations are in large p

attributable to their invaluable feedback, suggestions, support, friendship, and above all, dedication.

1.04 OPERATION AND LIMITATIONS

ELS makes use of the vehicle components available to GTAIV vehicle models (also commonly referred to as extras). By toggling these parts on pro

ELS models in various sequences, ELS simulates emergency lighting patterns. Thus, ELS must be used in conjunction with pro-ELS vehicle models. N

ELS models (or vehicle models not specifically configured to make use of the ELS features), such as the default GTAIV vehicle models, are to be

considered incompatible with ELS.

Due to uncontrollable elements native to GTAIV, ELS is not without its limitations. For instance, though measures have been taken to reduce its imp

on performance, particularly users with less-optimal PC configurations may notice a negative effect in this area as a result of using ELS. Users will a


6/25


5

notice that ELS lights cannot sustain damage. This is a direct result of the inner-workings of GTAIV and, regretfully, is an issue for which a solution h

yet to be discovered. Furthermore, due both to the way ELS is forced to operate and the unstable nature of GTAIVand though extensive work has

been done to prevent themgame crashes are likely to occur; particularly in multiplayer or when enabling ELS on vehicle models often used by the

game AI. A users PC configuration and other game modifications may further impact game stability.

Finally, ELS is primarily intended for use within the single player mode of GTAIV. Thus some ELS features in multiplayer are altered or limited, and m

not synchronize with other players.

1.05 REQUIREMENTS

ELS requires the following elements (in addition to the provided files) in order to operate:

A working PC-platform copy of the game GTAIV (or its EFLC DLC) updated to the latest patch;

the Microsoft Visual C++ 2010 Redistributable Package (found here: http://www.microsoft.com/en-ca/download/details.aspx?id=5555);

the Microsoft Visual C++ Redistributable for Visual St udio 2012 Update 4 (found here: http://www.microsoft.com/en-ca/download/details.aspx?id=30679); and,

the presence of pro-ELS vehicle models t o make adequate use of the systemsuch vehicles may be downloaded from the websit es www.lcpdfr.com and www.gtapolicemods.com

1.06 INSTALLATION

Installing ELS may be done in a few easy steps:

Completely uninstall any existing version of ELS;

Place the ELS.asi, the ELS folder, and the AdvancedHook.dllinto your main GTAIV game directory (this is the same folder that houses the gtaiv.exe fi le);

unless you already possess the following files and they are more recent than the ones provided, place the dsound.dlland ScriptHook.dllfiles into your main GTAIV game directory;

if you do not already have any, download and install pro-ELS vehicle models to use with ELS;

(update any existing vehicle configurations files you may have to the latest ELS version standard, as older VCFs may be incompatible with new ELS versions);

open, configure the ELS.ini file and the ELS vehicle configuration file(s) from the ELS folder to suit your needs, save them; and,

launch your game.

Provided in the download is a VisualSettings.dat file. This file is a modified version of the original one used by GTAIV. This file serves to make the EL

lights larger, brighter, and in many cases, more realistic. Installing this file is purely optional. Though, should you wish to use it, you may simply ad

to the common\data folder of your main GTAIV game directory, thus overwriting the original. It is always a recommended practice to make a back

of the original file.
http://www.microsoft.com/en-ca/download/details.aspx?id=5555http://www.microsoft.com/en-ca/download/details.aspx?id=5555http://www.microsoft.com/en-ca/download/details.aspx?id=5555http://www.microsoft.com/en-ca/download/details.aspx?id=30679http://www.microsoft.com/en-ca/download/details.aspx?id=30679http://www.microsoft.com/en-ca/download/details.aspx?id=30679http://www.microsoft.com/en-ca/download/details.aspx?id=30679http://www.microsoft.com/en-ca/download/details.aspx?id=5555


7/25


6

Sec. 2 General configuration files

2.01 ELS.INI OVERVIEW

The main configuration file for ELS is ELS.ini and, if installed correctly, is located in the main GTAIV game folder. This file may be opened, viewed, a

edited with any text editor (though preferably Microsoft Notepad or Notepad++ should be used). This file allows the user to set several ELS paramet

including control keys and other general settings.

In the ELS.ini, the following elements should never be altered (unless otherwise indicated):

Words in brackets, as they represent a file section; and,

text found to the left side of equal (=) signs, as these are specific option labels.

To alter settings in the ELS.ini file, the user must change the values to the right side of the equal signs with values appropriate to the option being

changed. An entry that is either innately invalid or invalid with respect to the particular option being modified will be ignored and the default value

imposed in-game. The ELS.ini contains four sect ions:

CONTROLS;

INTERFACE;

ENV LIGHTING; and,

MISC SETTINGS.

Consult the appendix for lists containing detailed information on each ELS.ini option.

Important note:If a game session is active, GTAIV must be shut down and launched again in order for changes made to the ELS.ini (or other ELS

configuration files) to take effect.

2.02 ELS.INI: CONTROLS SECTION

The control section serves to configure which keyboard buttons will perform which ELS actions. For each of the options contained in this section, val

entries are restricted to any decimal keyboard key ID code (a list of these may be found in the appendix of this guide). A keys function is the action

performs when it is pressed in-game. Some keys have an alternate function when used in combination with the FunctionKey. Beware of conflicts wit

the GTAIV game controls as well as any possible conflicts with other script modifications that may be installed.

2.03 ELS.INI: INTERFACE SECTION

The Interface section contains options relating to the ELS user interface, mainly the location display text and the color of some of the elements of th

ELS information display panel.

2.04 ELS.INI: ENV LIGHTING SECTION

The Environmental Lighting section allows the user to configure several options pertaining to the ELS environmental lighting effects. For instance, he

the user may set the range and intensity of the environmental lighting for the various lighting tiers, as well as the potency of the environmental ligh

per time of day.

2.05 ELS.INI: MISC SETTINGS SECTION

The Miscellaneous Settings section allows the user to configure various options ranging from the flash speed of the ELS lights to whether or not the

(non-player controlled) vehicles will use ELS.

2.06 VEHICLE SLOT CONTROL FILE

The ELS vehicle slot control file (VSCF) is named _SLOTCONTRL.ini. If installed correctly, it is located inside the ELS folder, alongside the ELS vehi

configuration file(s). Every section in the _SLOTCONTROL.ini file begins with the name of a vehicle model within square brackets, (for example:

[AMBULANCE]), and represents a section specific to that vehicle model. Any change therein will only affect that model and any vehicle of that mod

type. (For instance, any changes made to the AMBULANCE section will affect all ambulancesand only ambulancesin-game.)


8/25


7

Thus, the vehicle sections in the _SLOTCONTROL.ini are regarded as vehicle control sections (VSCS) because they allow the user to (1) regulate wh

vehicle model(s) will be used (or not) by ELS; and (2) link to the files (in the ELS folder) from which these models will retrieve their configuration da

To this effect, every vehicle control section has two parts: Statusand File. Statusmay be set to either onor offand controls whether the vehicle mo

in question will be used or ignored by ELS. The Fileoption allows the user to specify which vehicle configuration file (VCF) from the ELS folder the

vehicle model should be associated with. The name of the VCF as specified here should not contain a file extension. Furthermore, a VCF may bear a

name but should not contain odd characters or spaces.

It is important to note that not all vehicle models are listed in the _SLOTCONTROL.ini by default. Should the user wish to add new vehicles to the lis

simple procedure must be followed:

Copy an existing single vehicle section in its entirety;

paste it somewhere in the _SLOTCONTROL.ini;

rename the title (part between brackets) of the new section to the name of the desired vehicle (must be a recognized name*); and,

modify the Fileand Statusoptions of the new VSCS as preferred.

*A list of the vehicle model names as recognized by ELS can be found in sec. 6.03 of this guide. Note that ELS supports 7 added vehicle slots: EMER

to EMERG7.


9/25


8

Sec. 3 Vehicle configuration files

3.01 OVERVIEW

Vehicle configuration files (VCF) allow the user to set several parameters specific to particular vehicle models. In order to be activated, a VCF must b

specified by its file name in the Fileparameter of a vehicle control section in the _SLOTCONTROL.ini. Though VCFs are .ini files, their extension sh

not be specified in the _SLOTCONTROL.ini. So, for instance, if a user wishes to use a file called car.ini, he must identify it is simply as car (witho

the quotes) in the Filesection of the appropriate VSCS in the _SLOTCONTROL.ini.

A VCF may be used by one or several vehicle models at once, or it may not be used at all if not specified in any VSCS. However, every VSCS must

designate a VCF, otherwise the default ELS configuration options will be imposed. All VCFs must be contained in the ELS folder, or they will not be

detected by ELS.

To create a new VCF, a user need simply copy an existing one, rename it, and configure it as desired. As with the ELS.ini, words in brackets or to th

left of equal signs should never be altered. To alter settings in VCFs, the user must change the values to the right side of the equal signs with values

appropriate to the option being changed. An entry that is either innately invalid or invalid with respect to the particular option being modified will be

ignored and the default value imposed in-game.

VCFs contain eight sections:

MISCoptions pertaining to various features not covered in other sections;

CRUISEoptions pertaining to the cruise (CR) feature;

SOUNDSoptions pertaining to the horn (AH), manual tone (M1/M2), and siren (SRN);

CORONASoptions pertaining to corona-related features;

WRNLoptions pertaining to the warning lights;

PRMLoptions pertaining to the primary lights;

SECLoptions pertaining to the secondary lights;

ENV_LIGHT_COLORSoptions to set the colors of the environmental lighting;

ENV_LIGHT_ACTIVEoptions to set whether environmental lighting will be enabled or not for the given extras/lights; and,

ENV_LIGHT_POSoptions to set the positions of the environmental lighting relative to the vehicle;

Consult the appendix for lists containing detailed information on each VCF option, including valid entries.

3.02 NOTE REGARDING SLICKTOP OPTION AND ENV. LIGHT POSITIONS

The Slicktopoption in the MISCsection of the VCF has a simple effect. It is mostly intended for use with vehicle models that possess a minimal amo

of lighting equipment and particularly no roof-mounted lighting, such as traditional slicktop or unmarked vehicles. When set to on, the Slicktopop

will simply apply the secondaryenvironmental lighting range and intensity (as specified in the ELS.ini through the Range_SECLand Intens_SECL

options) to the primaryenvironmental lighting. This normally results in smaller, more localized, and yet more intense primary environmental lightin

The end result for slicktop or unmarked vehicles using the Slicktopfeature should be a more visually realistic one. They should no longer be surroun

in a large glow of light. Instead, their environmental lighting should be more representative of their overall physical lighting configuration.

When using the Slicktopfeature, it is important that the user modify the positions of the primary environmental lights by way of the options in the

ENV_LIGHT_POSsection of the VCF in order to place these more closely to the main lighting parts used on the vehicle model.


10/25


9

Sec. 4 Main ELS features

4.01 ELS INFORMATION DISPLAY PANEL

The ELS information display panel is the systems central hub. It can be toggled by pressing the Toggle_InfoPanel in conjunction with the ComboKey

The display panel shows all necessary information regarding the state of the system. Some features are only accessible when the display panel is ac

For instance, flashing patterns may not be changed if the panel is off. Below is a diagram explaining the basics of the ELS information display panel:

It is important to note the pattern ID codes. These identify a specific flashing pattern within a particular lighting tier and type. Whenever prompted i

VCF to indicate a desired pattern ID, the user should refer to these codes. And, in these cases, the user should simply provide the appropriate nume

digit representing the pattern in question. Left-side zeros, as well as dashes and letters must be omitted.

Feature status indicators (ex. AB, CR) will appear visibly more transparent to signify to the user that they are not available on a given model.

Should the user desire, the color of the (by default) orange flash display squares and the (also orange by default) active text color can be changed b

altering the PanelOnColorR, PanelOnColorG, and PanelOnColorBparameters in the ELS.ini. These options allow the user to set respectively the red,

green, and blue RGB values of the desired replacement color.

4.02 LIGHTING TIERS

ELS separates lighting functions into three separate tiers: warning lights (WRNL), primary lights (PRML), and secondary lights (SECL). Each tier is

independent from the others and includes a specific set of lights (or extras for those familiar with GTAIV vehicle modeling):

WRNL: lights/extras 5 and 6.

PRML: lights/extras 1, 2, 3, and 4.

SECL: lights/extras 7, 8, and 9.

Each lighting tier is automatically activated or deactivated depending on the lighting stage (LSTG) the system is placed in by the user and other sett

specified in the VCF. Additionally, the WRNL and SECL may be manually toggled by the user by way of the Toggle_WRNLand Toggle_SECLkeys

respectively. Furthermore, each lighting tier may be set by the user to mimic specific lighting formats such as LEDs, strobe lights, or rotators, for

instance. These are lighting types and are explained in the next section.

4.03 LIGHTING TYPES

ELS allows the user to select from several different lighting types for each of the three light tiers (WRNL, PRML, and SECL). Lighting type must be se

for each tier in the VCF. Lighting types may not be switched or browsed through in-game, as they are normally meant to be mutually exclusive. Her

a brief list showing each ELS lighting tier and the lighting types available to it (keep in mind the extras mentioned in section 3.1):

WRNL:

LEDS/HALO: halogen and LED imitation patterns; extras 5 and 6 flash and are both used for the TKD feature.

STRB: strobe imitation patterns; extras 5 and 6 flash and are both used for the TKD feature.

TKDN: mix of halogen and strobe patterns available; only extra 5 will flash, as extra 6 is reserved exclusively for TKD.

SBRN: mix of halogen and strobe patterns avai lable; only extra 5 will fl ash, as extra 6 is reserved exclusively as a steady burning light (at LSTG 2 and 3); no TKD option is avail able.


11/25


10

PRML:

LEDS: LED imitation patterns.

STRB: strobe imitation patterns.

ROTA: halogen rotator imitation patterns.

DROT: LED imitation patters; extra 1 static and intended to toggle the emissive lights on the default siren rotators.

RMIX: extras 1 and 4 are used to imitate halogen rotators (with a fixed p attern), and extras 2 and 3 are offered a mix of LED and strobe imitation patterns.

SECL:

LEDS: LED imitation patterns; main use of extras 7 and 9; extra 8 will fl ash but is not synchronized with 7 and 9.

STRB: strobe imitation patterns; main use of extras 7 and 9; extra 8 will fl ash but is not synchronized with 7 and 9.

ROTA: halogen rotator imitation patterns; extras 7, 8, and 9 used to mimic a rotating lig ht source.

DRCT: LED directional or traffic advisor style patterns; extras 7, 8, and 9 synchronized.

ARRW: LED directional or traffic advisor style patterns (mainly intended for use with arrow-shaped lighting setups); extras 7, 8 , and 9 synchronized.

MARQ: static text marquee imitation patterns; extras used vary based on the selected pattern.

The configuration of a vehicle model or the suggestions of its author should determine what lighting type to use. For instance, a vehicle modified to

make use of directional type secondary lighting patterns should have its SECL type set to DRCT.

4.04 LIGHTING STAGES

ELS possesses four lighting stages (LSTG): LSTG 0 (or off), LSTG 1, LSTG 2, and LSTG 3. The LSTG can be changed by making use of the

Toggle_WRNL, Toggle_SECL, and mainly Toggle_LSTGkeys. Each LSTG will activate or deactivate certain light tiers as well as other ELS features. His a very simplified overview of each stage in its default state:

LSTG 0: All ELS lighting is disabled.

LSTG 1: SECL are active.

LSTG 2: SECL are active, as wel l as PRML (in LO setting), and any s trobe coronas.

LSTG 3: SECL, PRML (in full), WRNL, and any headlight or taillight coronas are active; siren may be used.

At LSTG 2, the PRML are activated in a LO setting. This means that only two of the four available primary lights/extras will flash, and the

environmental glow produced by them will be reduced by half. Which two primary lights become operational at LSTG 2 is determined by the

Lstg2ActiveExtrasoption in the vehicles VCF.

The user, by way of the LstgActivationTypeoption in the VCFs can set the activation method for the lighting stages. Four modes are available and

explained briefly below. In all cases, the main activation results from pressing the Toggle_LSTG button, and the alternate activation by pressing the

FunctionKey in combination withToggle_LSTG.

DEFAULT: First main press sets system to LSTG 1, second press LST G 2, third press LSTG 3, and fourth press LSTG 0. Alternate combo will repeat this p rocess backwards.

INVERTED: First main press sets system to LSTG 3, second press LSTG 2, third press LSTG 1, and fourth press LSTG 0. Alternate combo will repeat this process backwards.

JUMP: First main press sets system to LSTG 3, second press LST G 0. Alternate combo will cycle through the lighting stages backwards.

EURO: First main press sets system to LSTG 3, second press LSTG 0. Alternate combo wil l cycle through the lighting stages backwards. (In EURO mode, the lever clicking sounds wil

be heard when cycling through the lighting stagesonly beeps will be audible.)

4.05 ELS MAIN SIREN AND SPECIAL HORNS

When ELS is active on a vehicle in single player, the default game siren (usually activated by the games horn key) is unavailable. Instead, it is repla

by the ELS siren. The ELS siren may make use of the four siren tones available in GTAIV. The ELS siren may only be activated if the system is in LST

3. When the system is in LSTG 3 and the siren is active, once the LSTG is lowered, the siren will be automatically toggled off. While the ELS siren w

work on any vehicle slot in the single player game, when playing online, since the default GTAIV siren function is used instead of the ELS siren (for

synchronization reasons), vehicles not meant to have sirens (civilian vehicle slots) will not have access to a siren or any audible tones.

The ELS has three horn types: the air horn (AH), a primary manual siren tone (M1) and a secondary manual siren tone (M2). The AH may be used a

any time and regardless of LSTG. Once the AH is triggered by press of the Horn_Airhkey, any playing siren will be muted while the AH is active. Wh

activated by the user, the M1 type horn will play a wail tone if the siren is off. When the Horn_Airhand Horn_Man buttons are pressed simultaneous

the tone specified in theAH_SrnToneForM2option of the VCF will play (this is M2). When the siren is active, the M1 button will no longer play a man

tone and will instead browse through the different siren tones. These can also be browsed through backwards at any time by using the FunctionKey

conjunction with the Horn_Manukey.

ELS provides two siren operation modes: standby (STBY) and hands-free (HDSF). The user may switch between these two modes by pressing the

Toggle_SRNkey in conjunction with the FunctionKey. In STBY mode, the user must activate the siren when desired. In HDSF mode, the siren will


12/25


11

automatically be triggered whenever the system enters LSTG 3. In both cases, the siren will be disabled as soon as LSTG 3 is exited or the siren is

manually toggled off by the user.

All ELS sirens and horns will usually affect AI behavior. However, this only applies to vehicles meant to have a siren in the default game. Thus, repla

civilian vehicles will not cause AI traffic to yield. To get AI vehicles to move over to the side of the road, it is suggested to make multiple uses of the

M1, and M2 or activate and switch between the various siren tones.

In addition, ELS also provides four siren tone buttons (SirenTone_WL, SirenTone_YP, SirenTone_A1, and SirenTone_A2) which allow any tone to be

played manually by the user at any time so long as the system is in LSTG 3. Respectively, these buttons play the wail tone, the yelp tone, the altern

1 tone, and the alternate 2 tone.

Due to the limitations of the multiplayer version of GTAIV, in this game mode, the default GTAIV siren system is used instead, with limited functiona

Furthermore, ELS vehicles in non-emergency vehicle slots will not have access to a siren or airhorn.

4.06 SECONDARY SIREN

ELS offers the possibility of playing two sirens simultaneously; a feature often referred to as dual sirens. The secondary siren may be activated by

pressing the Horn_Airh keyin conjunction with theFunctionKey. When the secondary siren is toggled on, the X2 graphic on the ELS information pa

will display in an opaque yellow (by default) color. When active, the secondary siren will play as a wail tone and cannot be changed. The secondary

siren will only play so long as the main siren is playing. The secondary siren will be disabled immediately as soon as it is toggled off by the user (via

Horn_Airh + FunctionKey), or automatically once the main siren is switched off.

Due to the limitations of the multiplayer version of GTAIV, the secondary siren feature is not available in multiplayer mode.

4.07 TAKEDOWNS

The takedown (TKD) option can be toggled by pressing the Toggle_Takedownskey. When active, a powerful light will be emitted at the front of the

vehicle. In the VCF, the takedowns can be replaced by scene lights (SCN) which will instead provide larger scene illuminationthough this option is

mostly recommended for use with larger vehicles, such as ambulances.

Traditional (extra-based) takedowns may be replaced by corona-based takedowns in the VCF via the UseCoronaTakedownsoption. If corona takedo

are active, they will emit forward-facing directional lighting to illuminate the front of the vehicle.

For additional information regarding how to setup vehicle models to use corona takedowns, see section 5.06 of this guide.

4.08 BLACKOUT MODE

Blackout mode (BL) allows the user to instantly disable or enable the vehicles headlights and taillights simultaneously. It may be toggled by pressin

the Toggle_Takedownsin conjunction with the FunctionKey. If active, BL mode will be automatically exited as soon as any ELS emergency lighting

features are enabled.

4.09 CRUISE MODE

Cruise lights (CR), when activated, will result in the vehicles primary lights being turned on. These will maintain a steady pattern and will emit a low

intensity environmental light than when the regular PRML patterns are active. In the VCF, the user may select which primary lights will activate with

Note that the CR feature is not available to all PRML types. For instance, vehicles set to use the ROTA primary lighting type will not have access to C

4.10 EXPRESS MODE

Express mode is practical for online play, or when desiring a more natural gaming experience. Express mode may be toggled at any time by pressing

the ToggleExpressModekey in conjunction with the ComboKey. Express mode disables all ELS key controls and harmonizes them into a single key:

GTAIVs default horn/siren button. Thus in Express mode, no ELS key command will have any effect except for the Express mode key combo which,

when pressed will exit Express mode, returning ELS to a normal state of operation. In Express mode, activating the vehicles default siren will

automatically set the system in LSTG 3, thus enabling all 3 lighting tiers (WRNL, PRML, and SECL) by default. Turning off the vehicles default siren

set the system in LSTG 0, thus shutting off all active ELS emergency lighting.

If the vehicles emergency lighting is active and its siren is not, once Express mode is toggled on, the vehicles siren will play.


13/25


12

If the ELS information display panel is active when Express mode is engaged, its transparency will be significantly increased. At this point, it will not

possible to toggle the display panel off until Express mode is exited.

While Express mode is active, a message will be displayed at the bottom-left corner of the screen to inform the player of the state of the system.

4.11 ELS KEY LOCK

The ELS control keys can be enabled or disabled at any time via press of the Scroll Lock button. When ELS key lock is active, all ELS keys will be

disabled. At this point, pressing any ELS key will have no effect. A warning message will also appear at the bottom-left corner of the users screen to

indicate that ELS key lock is active and that all ELS keys have been disabled. This mode is particularly useful whenever typing or interaction with

another script modification is required.

ELS key lock is always disabled by default. However, if it has been activated by the user and the warning message is present on the screen, a simple

press of the Scroll Lock button will disable ELS key lock. At this point, all ELS control keys will become active and ELS will operate as normal.

4.12 ARROW BOARDS

ELS allows for the use of arrow boards, or physical platforms for the mounting of emergency or directional lights, which can be raised and lowered u

the users command. The arrow board feature works by rotating up and down the vehicles hood and/or trunk lid (depending on the vehicle models

design and its corresponding VCF configuration). Thus, the arrow board feature should only be used with vehicle models specifically designed to sup

it. An arrow board can be enabled on a vehicle via the EnableArrowBoardoption in the MISC section of the VCF. There, four entries are possible:

OFF: (Default option) the arrow board feature will not be enabled on the vehicle.

HOOD: The arrow board feature will be enabled on the vehicle; the hood wi ll be used as the platform.

TRUNK: The arrow board feature will be enabled on the vehicle; the trunk will be used as the platform.

BOTH: The arrow board feature will be enabled on the vehicle; both the hood and the trunk will be used and will move simultaneously.

It is important to ensure that the option that has been selected is compatible with the vehicle model in question. For instance, a vehicle model desig

to use the hood as an arrow board will not behave correctly if its EnableArrowBoard option is set to trunk.

The arrow board can be raised and lowered by the user via press of the FunctionKeyin conjunction with the Toggle_SECL key.

For additional information regarding how to setup vehicle models to use the arrow board feature, see section 5.05 of this guide.

4.13 CORONAS

In order to reduce the necessity of using traditional extras to mimic some emergency lightingand therefore, to free these for lighting uses elsew

on the vehicle, ELS enables the user to setup light coronas in order to simulate wig-wags and peripheral strobe lights.

ELS coronas are separated into five tiers: Headlights, Taillights, IndicatorsF, IndicatorsB, and Reverselights. The corona options allow the user to

configure how each groups area will behave when ELS is active on the given vehicle. Coronas are completely separate from the traditional extra li

process and independent of the other lighting tiers (PRML, SECL, or WRNL). Also, each corona group is independent from the others, so flash patter

will not synchronize across groups.

Coronas may be damaged during collisions in-game and will thereafter cease to function until the vehicle is repaired. Furthermore, their colors are p

set and cannot be changed, and their f lash patterns must be specified by the user in the VCF and cannot be altered in-game.

Below is some relevant information regarding the behavior of each corona group:

HEADLIGHTS: Become active at LSTG 3; use halo gen-imitation patterns; halogen white color.

TAILLIGHTS: Become active at LSTG 3; use halogen-imitation patterns; red color. INDICATORSF: Become active at LSTG 2; use strobe-imitation patterns; strobe white color.

INDICATORSB: Become active at LSTG 2; use strobe-imitation patterns; red color.

REVERSELIGHTS: Become active at LSTG 2; use strobe-imitation patterns; strobe white color.

Coronas should only be used on vehicle models designed to make use of them. Thus, vehicle models which use the traditional extra method (via th

WRNL or other tier) to simulate front or rear wig-wags, for instance, or vehicle models not specifically designed to accommodate corner strobe coron

should be considered incompatible with these features.

A known issue which may sometimes result from using coronas is clipping: in some cases, coronas may be seen through small or thin objects.


14/25


13

When using coronas, it is also important to remember to either properly reposition or disable the Extra_5 and Extra_6 environmental lights (in the

ENV_LIGHT_ACTIVE and ENV_LIGHT_POS sections of the VCF), as these may conflict with those of the coronas.

For additional information regarding how to setup vehicle models to use the coronas feature, see section 5.06 of this guide.

4.14 TAKEDOWN CORONAS

In addition to warning lighting coronas, ELS provides the user with the ability to use light coronas in order to simulate takedown lights. Corona

takedowns can be enabled or disabled for a given vehicle slot via the UseCoronaTakedownsoption in the MISCsection of the VCF. Similarly to other

coronas, takedown coronas will project directional environmental lighting, in this case, to illuminate the front of the vehicle. Corona takedowns will

typically supersede WRNL (extra-based) takedown lights. Consider the following in-game scenarios (when the TL feature is active):

Using LEDS/HALO STRB or SBRN WRNL types corona takedowns OFF:Extras 5 and 6 are forced to steady burn pattern; white environment lighting illuminates front and sides of ve

Using LEDS/HALO STRB or SBRN types corona takedowns ON:Extras 5 and 6 are undisturbed, coronas used instead; white projected environment lighting illuminates front of vehi

Using TKDN WRNL type corona takedowns OFF: Extra 6 forced to steady burn pattern; white environment lighting illuminates front and sides of vehicle.

Using TKDN WRNL type corona takedowns OFF:Extra 6 forced to steady burn pattern, and coronas used as well; white projected environment lighting illu minates front of vehicle w

white regular environment lighting illuminates sides of vehicle.

4.15 MULTIPLAYER

ELS is primarily intended for use in the single player version of GTAIV. Due to GTAIVs limitations, particularly with respect to multiplayer

synchronization, it is very difficultif not impossibleto ensure that one players ELS experience will be mirrored on the machines of the players aro

him without any discrepancies. However, though issues will persist, steps have been taken to ensure as smooth a multiplayer experience as possibleIndeed, advancements have been made which allow some ELS features to synchronize (most of the time) over an online server. Though, due to the

volatility of the overall GTAIV multiplayer experience, complete ELS stability cannot be ensured. Therefore, in order to mitigate the probability of iss

it is recommended that players using ELS online do so on private or controlled servers, where all playersshould use the same vehicle models a

ELS configurations.Players should also ensure that the Els_Ai_Mpfeature in the ELS.ini is set to on. This will allow ELS to detect and animate the

controlled vehicles, as well as those of other (human) players.

The following ELS features should normally synchronize online: WRNL, SECL, PRML, CR, TL, NL, BL, and AB. Thus, if a player activates any of these

features, it should be apparent for all other players as well, provided that the Els_Ai_Mp option is set to on. However, flash patterns will not

synchronize. Instead, other players will always see a random pattern. Though there is a workaround: if all players are using the same ELS

configurations in which they have set default pattern IDs for the various lighting tiers, then the same patterns should appear for all. This should be

especially beneficial for clans or organized groups of players. (Note that even if default pattern IDs are set, should a player change a pattern mid-ga

only the original default pattern will ever be seen by others.) The AB feature will synchronize in most cases. However, at times its behavior may bec

unpredictable, at which point it is recommended that the user turn off all ELS features that may be active on the vehicle, discard or delete the vehic

and transfer to a new vehicle.

When joining an online server, spawning a new vehicle, or repairing a vehicle, it is possible that all or some of its ELS lights may be active (in a stea

non-flashing state). In these cases, it is recommended that the user set the system to LSTG 3 and then back to LSTG 0 in order to correct the probl


15/25


14

Sec. 5 Vehicle model modifications

5.01 HOW ELS WORKS

Before beginning, it is important to understand how ELS works at the code level. Parts named extra are those which will appear randomly on a veh

as it spawns in the game. Any given vehicle can be outfitted with a maximum of 9 of these (extra_1 to extra_9). These parts can be added onto or

removed from a vehicle in-game at any time by use of special codes. ELS makes use of these extra parts by toggling them on and off at various

intervals in order to mimic light flashing patterns. Therefore, ELS at the modeling level, relies solely upon extra parts. In a vehicle model's hierarc

the dummies of these parts abide by the following nomenclature pattern: extra_1. That is, extra followed by an underscore, then followed by the

number of the part (1-9). The names of the meshes within these dummies can bear any name, however, they must be followed by a LOD suffix suc

_L0, _L1, or _L2. For the purposes of ELS, no collision ([COL]) mesh is required for these extras. The graphic below demonstrates the most basic

correct hierarchical layout for extra parts within a vehicle model:

Notice how extras 5, 6, and 9 are setup slightly different from the other extras. This difference is necessary in the aforementioned cases, as without

these lights would not emit any light once in-game.

On default game vehicles, extra parts are normally ads, roof scoops, supplemental grilles, and other such vehicular accessories. However, for ELS, t

extra parts must simply be lights. In order to do this, extra parts intended to be ELS lights must be assigned lightsemissive textures. This will ensu

that they will glow once toggled on in-game. Therefore, an ELS light extra part, in the vast majority of instances, is nothing more than a rectangle w

a (lightsemissive) light texture mapped onto it. ELS makes use of the 9 extra parts a vehicle can be outfitted with. The numbers in this case are ver

important as they determine with which light tier (WRNL, PRML, or SECL) any given extra part will flash. It is also necessary to know that the lowe

the number of the extra part, the closer it should be to the left side of the car -- this is so that once the environmental lights come into play in-game

they will be more naturally synchronized with the position of the extra parts.


16/25


15

5.02 ELS EXTRA PART ALLOCATIONS

The list below explains how vehicle extra parts are allocated according to ELS lighting tier:

WRNL: Extras 5 and 6.

PRML: Extras 1, 2, 3, and 4.

SECL: Extras 7, 8, and 9.

To get a better understanding of how extra parts should be placed and oriented on a vehicle model, consult the ELS Part Placement Map in the

appendix.

5.03 EXTRA 10

While Extra_10 cannot be used by the ELS code due to game limitations, GTAIV still treat the part as a regular component when it is present on

vehicles: it will spawn randomly. Therefore, Extra_10 may be a good option for vehicle modelers wishing to add an additional miscellaneous compon

(such as a pushbar) to their vehicles which will appear at random in-game.

5.04 NOTE REGARDING SECL LEDS AND STRB TYPES

The LEDS and STRB secondary lighting types are intended for use as general or peripheral secondary lighting, and are also meant to be symmetrica

the vehicle model (on a left-right split)hence the emphasis on the use of only two extras rather than three. Thus, though the DRCT, MARQ, and RO

types make equal use of all three secondary extras (7, 8, and 9), the LEDS and STRB type flashing patterns instead make main use of extras 7 and

However, this does not mean that extra 8 is disabled for the LEDS and STRB types. It will still flash if it exists on the model, but its patterns will be

random and generally unsynchronized with those of extras 7 and 9.

5.05 NOTE REGARDING ARROW BOARDS

The arrow board feature makes use of the hood (or bonnet) component of vehicle models in order to power the moving warning platforms. As such,

a vehicle model designed to make use of this feature, the vehicles actual hood (bonnet) or trunk (boot) partdepending on the modelers desired

configurationmust be renamed to something else (such as misc_a, for instance), and its spherical dummy must be converted to a box type dumm

order to prevent the hood (or trunk) from swinging freely in-game. Likewise, the part intended to serve as the moving warning platform must be

renamed bonnet (or boot). The dummy associated with this part will form its axis of rotation; it must be converted to a sphere type dummy.

Furthermore, the warning platform should be kept in the lowered position by default (in the editing program). In order for the lights (extras) to mov

along with the warning platform, they should be made children of the warning platform part. Remember to set the EnableArrowBoard option in the

vehicles VCF according to the models design.

5.06 ADJUSTING A VEHICLE MODEL FOR CORONAS

The ELS coronas feature works by automatically determining the position of recognized light dummies on the vehicle model and spawning coronas a

those locations. Therefore, any vehicle model can be rather easily adjusted to accommodate the coronas feature. Once coronas are activated via the

VCF, their position and color will be automatically set by ELS in-game. The only model-based requirement is that the recognized dummies be proper

positioned, according to the designers needs. Recognized light dummies will depend on the corona group(s) activated in the VCF.

Below is a list of the corona tiers and their corresponding vehicle dummy associations:

HEADLIGHTS: headlight_l, and headlight_r.

TAILLIGHTS: taillight_l, and taillight_r.

INDICATORSF: indicator_lf, and indicator_rf.

INDICATORSB: indicator_lr, and indicator_rr.

REVERSELIGHTS: reversinglight_l, and reversinglight_r.

TAKEDOWNS: extra_5 dummy, and extra_6 dummy.

Vehicle model designers should ensure that coronas and extras do not overlap or are used to fulfil the same roles, as that would be redundant and

could possibly lead to visual conflicts in-game. Furthermore, when using coronas, it is important to remember to either properly reposition or disable

Extra_5 and Extra_6 environmental lights (in the ENV_LIGHT_ACTIVE and ENV_LIGHT_POS sections of the VCF), as these may conflict with those o

coronas.


17/25


16

Finally, when using corona takedowns, while the positions of the extra_5 and extra_6 dummies are important, (they are used to set the takedown

corona positions), all additional lights/parts or dummies contained within the extra_5 or extra_6 dummies are of no importance to this particular

feature. Thus, extra_5 and extra_6 ELS lights may still be added and used normally.

In order to prevent or reduce the probability of corona clipping (or coronas being seen through objects) it is recommended that coronas be placed

behind several mesh layers.


18/25


17

Sec. 6 Appendix

6.01 ELS ABBREVIATIONS

The abbreviations and acronyms used in the ELS realm are many. The following list should help clarify some.

AH:Air horn.

A1:Alternate 1 siren tone.

A2:Alternate 2 siren tone.AB:Movable warning platform.

ARRW: Arrow-based lighting type, applies to SECL tier.

BKT/BL:Blackout mode.

CR:Cruise lights feature.

DRCT:Directional lighting type, applies to SECL tier.

ELS:Emergency Lighting System.

HALO:Halogen lighting type, applies to WRNL tier (replaced by LEDS).

HDSF:Hands-free siren mode.

LEDS:LED lighting type, applies to PRML, SECL, and WRNL tiers.

LSTG:Lighting stage.

M1/MAN:Main manual siren tone.

M2:Secondary manual siren tone.

MARQ:Marquee lighting type, applies to SECL tier.

NL:Night light feature.

PRML:Primary lighting tier.

RMIX:Rotator and LED imitation lighting type, applies to PRML tier.

ROTA:Rotator imitation lighting type, applies to PRML and SECL tiers.SBRN:Steady-burn lighting type, applies to WRNL tier.

SCN/SL:Scene lights (override TKD lights if set to do so in a VCF).

SECL:Secondary lighting tier.

SRN:ELS siren (and not GTAIV default game siren).

STBY:Standby siren mode.

STRB:Strobe lighting type, applies to PRML, SECL, and WRN L tiers.

TKD/TL:Takedown lights.

TKDN:Takedown lighting type, applies to WRNL tier.

VCF:Vehicle configuration file.

VSCS:Vehicle slot control section (these ar e contained within _SLOTCONTROL.ini).

VSCF: Vehicle slot control file (used to refer to _SLOTCONTROL.ini).

WL:Wail siren tone.

WRNL:Warning lighting tier.

YP:Yelp siren tone.

6.02 CONTROL KEY CODES

The following is a list of mouse and keyboard key IDs which can be used when configuring control keys in the ELS.ini file. (There is no need to add t

extra zeroes ahead of the numbers; they are simply added here for aesthetic purposes.)

000Nothing/disabled

001 Mouse Left

002 Mouse Right

004 Mouse Mid.

005 Mouse Alt1

006 Mouse Alt2

008 Backspace

009 Tab

012 Clear013 Enter

016 Shift

017 Ctrl

018 Alt

019 Pause

020 Caps Lock

027 Esc

032 Spacebar

033 Pg Up

034 Pg Dn

035 End

036 Home

037 Left

038 Up

039 Right

040 Down

042 Print

044 Print Screen

045 Ins

046 Del

047 Help

048 0049 1

050 2

051 3

052 4

053 5

054 6

055 7

056 8

057 9

065A

066B

067C

068D

069E

070F

071G

072H

073I

074J

075K

076L

077M078N

079O

080P

081Q

082R

083S

084T

085U

086V

087W

088X

089Y

090Z

096Numpad 0

097Numpad 1

098Numpad 2

099Numpad 3

100Numpad 4

101Numpad 5

102Numpad 6

103Numpad 7

104Numpad 8105Numpad 9

106Numpad *

107Numpad +

109Numpad -

110Numpad .

111Numpad /

112F1

113F2

114F3

115F4

116F5

117F6

118F7

119F8

120F9

121F10

122F11

123F12

144Num Lock

145Scroll Lock

160Left Shift

161Right Shift162Left Ctrl

163Right Ctrl

186 ;

187 =

188 ,

189 -

190 .

191 /

192 `

219 [

220 \

221 ]

222 '


19/25


18

6.03 VEHICLE MODEL NAMES

The following is a list of vehicle names which can be used when creating new ELS vehicle control sections in the ELS.ini file.

ADMIRAL

AIRTUG

AMBULANCE

BANSHEE

BENSON

BIFF

BLISTA

BOBCAT

BOXVILLE

BUCCANEER

BURRITO

BURRITO2

BUS

CABBY

CAVALCADE

CHAVOS

COGNOSCENTI

COMET

COQUETTE

DF8

DILETTANTE

DUKES

E109

EMPEROR

EMPEROR2

ESPERANTO

FACTION

FBI

FELTZER

FEROCI

FEROCI2

FIRETRUK

FLATBED

FORTUNEFORKLIFT

FUTO

FXT

HABANERO

HAKUMAI

HUNTLEY

INFERNUS

INGOT

INTRUDER

LANDSTALKER

LOKUS

MANANA

MARBELLA

MERIT

MINIVAN

MOONBEAM

MRTASTY

MULE

NOOSE

NSTOCKADE

ORACLE

PACKER

PATRIOT

PERENNIAL

PERENNIAL2

PEYOTE

PHANTOM

PINNACLE

PMP600

POLICE

POLICE2

POLPATRIOT

PONY

PREMIER

PRES

PRIMO

PSTOCKADE

RANCHER

REBLA

RIPLEYROM

ROMERO

RUINER

SABRE

SABRE2

SABREGT

SCHAFTER

SENTINEL

SOLAIR

SPEEDO

STALION

STEED

STOCKADE

STRATUM

STRETCH

SULTAN

SULTANRS

SUPERGT

TAXI

TAXI2

TRASH

TURISMO

URANUS

VIGERO

VIGERO2

VINCENT

VIRGO

VOODOO

WASHINGTON

WILLARD

YANKEE

FAGGIO

HELLFURY

NRG900

PCJ

SANCHEZ

ZOMBIEB

DINGHY

JETMAX

MARQUISPREDATOR

REEFER

SQUALO

TUGA

TROPIC

ANGEL

APC

BLADE

BUFFALO

BULLET

CADDY

DEAMON

DIABOLUS

F620

FLOATER

GBURRITO

HEXER

LIMO2

LYCAN

NGHTBLADE

POLICE3

POLICE4

POLICEB

POLICEW

REVENANT

SERRANO

SERRANO2

SCHAFTER2

SCHAFTER3

SLAMVAN

SUPERD

SUPERD2

TOWTRUCK

VADER

WOLFSBANE

EMERG1

EMERG2

EMERG3EMERG4

EMERG5

EMERG6

EMERG7


20/25


19

6.04 ELS PART PLACEMENT

Naturally, ELS relies on the ingenuity and imagination of those creating or modifying vehicle models. However, the graphic below illustrates the basi

ELS extra part placement schemes for every lighting tier and type.


21/25


20

6.05 ELS.INI OPTIONS

The following lists explain each of the options contained within the main ELS configuration file (ELS.ini).

CONTROLSToggle_LSTG FUNCTION Changes the lighting stage (LSTG).

FUNCTION ALT Changes LSTG backwards/alternate.

NOTES N/A

Toggle_SECL FUNCTION Enables and disables the secondary lights (SECL).FUNCTION ALT Operates the arrow board/warning platform on vehicles which have that feature enabled.

NOTES N/A

Toggle_WRNL FUNCTION Enables and disables the warning lights (WRNL).FUNCTION ALT N/A

NOTES N/A

Toggle_SRN FUNCTION Enables and disables the ELS siren (SRN).FUNCTION ALT Toggles between standby siren mode (STBY) and hands-free siren mode (HDSF).

NOTES In MP, this key is disabled.

Toggle_InfoPanel FUNCTION Enables and disables the ELS information display panel.FUNCTION ALT N/A

NOTES Must be pressed in combination with the ComboKey for effect.

Toggle_HazLights FUNCTION Enables and disables the hazard lights.FUNCTION ALT N/A

NOTES Must be pressed in combination with the ComboKey for effect.

Toggle_Takedowns FUNCTION Enables and disables the takedown lights (TL).FUNCTION ALT Enables and disables the blackout mode (BL).

NOTES N/A

Toggle_Cruise FUNCTION Enables and disables the cruise light function (CR).FUNCTION ALT Enables and disables the night light feature (NL).

NOTES N/A

Chng_Pat_PRML FUNCTION Browses through the PRML flashing patterns.FUNCTION ALT Browses through the PRML flashing patterns backwards.

NOTES ELS information panel must be active for effect.

Chng_Pat_SECL FUNCTION Browses through the SECL flashing patterns.FUNCTION ALT Browses through the SECL flashing patterns backwards.


Chng_Pat_WRNL FUNCTION Browses through the WRNL flashing patterns.FUNCTION ALT Browses through the WRNL flashing patterns backwards.


Horn_Manu FUNCTION When siren is off, plays the wail tone; when siren is on, browses through siren tones forward.FUNCTION ALT Browses through siren tones backwards.

NOTES In MP, this key is disabled while the siren is in use.

Horn_Airh FUNCTION Sounds the air horn. If the siren is on, it will be muted while the horn is active.FUNCTION ALT Toggles the double siren feature when the main siren is already playing.

NOTES Will play an alternate siren tone if pressed concurrently with the Horn_Manu key.

SirenTone_WL FUNCTION Activates the wail siren tone.FUNCTION ALT Deactivates the wail tone (and, therefore, the siren) if the wail tone is already playing.

NOTES LSTG must be at 3 for effect. In MP, this key is disabled.

SirenTone_YPFUNCTION Activates the yelp siren tone.

FUNCTION ALT Deactivates the yelp tone (and, therefore, the siren) if the yelp tone is already playing.


SirenTone_A1 FUNCTION Activates the alternate 1 siren tone.FUNCTION ALT Deactivates the alt. 1 tone (and, therefore, the siren) if the alt. 1 tone is already playing.


SirenTone_A2 FUNCTION Activates the alternate 2 siren tone.FUNCTION ALT Deactivates the alt. 2 tone (and, therefore, the siren) if the alt. 2 tone is already playing.


FunctionKey FUNCTION Used in combination with some keys to activate their alternate functions.FUNCTION ALT N/A

NOTES N/A

ComboKey FUNCTION Required to be used concurrently with some keys for effect.FUNCTION ALT N/A

NOTES N/A

ToggleExpressMode FUNCTION Enables and disables ELS Express mode.FUNCTION ALT N/A

NOTES N/A

INTERFACE

LocationDisplay EFFECT Sets whether and under what circumstances location text at bottom of screen will show.VALID ENTRIES OFF, ONINFOPANEL, ONINANYCAR, ONALWAYS

NOTES N/A

PanelOnColorR EFFECT Sets red RGB value of yellow ELS information panel text.VALID ENTRIES 0-255

NOTES N/A

PanelOnColorG EFFECT Sets green RGB value of yellow ELS information panel text.VALID ENTRIES 0-255

NOTES N/A

PanelOnColorB EFFECT Sets blue RGB value of yellow ELS information panel text.VALID ENTRIES 0-255

NOTES N/A


22/25


21

ENV LIGHTING

Range_PRML EFFECT Sets range of PRML environmental lighting.VALID ENTRIES 1-100

NOTES N/A

Inten_PRML EFFECT Sets intensity of PRML environmental lighting.VALID ENTRIES 1-100

NOTES N/A

Range_SECL EFFECT Sets range of SECL environmental lighting.VALID ENTRIES 1-100

NOTES N/A

Inten_SECL EFFECT Sets intensity of SECL environmental lighting.VALID ENTRIES 1-100

NOTES N/A

Range_WRNL EFFECT Sets range of WRNL environmental lighting.VALID ENTRIES 1-100

NOTES N/A

Inten_WRNL EFFECT Sets intensity of WRNL environmental lighting.VALID ENTRIES 1-100

NOTES N/A

Range_TKDN EFFECT Sets intensity of environmental lighting for takedowns (TKD).VALID ENTRIES 1-100

NOTES N/A

Inten_TKDN EFFECT Sets intensity of environmental lighting for takedowns (TKD).VALID ENTRIES 1-100

NOTES N/A

IntMult_Crnas EFFECT Sets intensity of environmental lighting for coronas.VALID ENTRIES 0.0 (OR ANY VALUE HIGHER)

NOTES N/A

EnvMult_Morning EFFECT Sets the morning time intensity multiplier for the ELS environmental lighting.VALID ENTRIES 0.0 - 1.0

NOTES N/A

EnvMult_Evening EFFECT Sets the evening time intensity multiplier for the ELS environmental lighting.VALID ENTRIES 0.0 - 1.0

NOTES N/A

EnvMult_Night EFFECT Sets the nighttime intensity multiplier for the ELS environmental lighting.VALID ENTRIES 0.0 - 1.0

NOTES N/A

MISC SETTINGSFlashSoundFx EFFECT Enables or disables the ticking sounds that accompany the flashing lights.

VALID ENTRIES ON, OFF.

NOTES N/A

FlashDelay_Sp EFFECT Modifies the speed of the ELS flashing lights in single player.VALID ENTRIES 0-5

NOTES 0 represents no speed reduction; every subsequent value represents an additional 100% reduction.

FlashDelay_Mp EFFECT Modifies the speed of the ELS flashing lights in multiplayer.VALID ENTRIES 0-5NOTES 0 represents no speed reduction; every subsequent value represents an additional 100% reduction.

Els_Range_Pl EFFECT Sets the range (in meters) after which player vehicles using ELS will be discarded.VALID ENTRIES 50-5000

NOTES N/A

Els_Range_Ai EFFECT Sets the range (in meters) after which AI vehicles using ELS will be discarded.VALID ENTRIES 50-5000

NOTES The greater the number, the larger the impact on performance may be.

Ai_Els_Sp EFFECT Determines whether or not ELS will animate AI vehicles in single player.VALID ENTRIES ON, OFF.

NOTES N/A

Ai_Els_Mp EFFECT Determines whether or not ELS will animate AI and other player vehicles in multiplayer.VALID ENTRIES ON, OFF.

NOTES N/A

MaxElsCarsAtOnce EFFECT Sets the maximum number of ELS-enabled vehicles that can run at the same time.VALID ENTRIES 1-100

NOTES The greater the number, the larger the impact on performance may be.

ClearRandAiExtrasSpEFFECT Sets whether ELS will remove random still ELS lights from nearby vehicles (when their siren is off) in single player.


NOTES N/A

ClearRandAiExtrasMp EFFECT Sets whether ELS will remove random still ELS lights from nearby non-player vehicles (when their siren is off) in multiplayer.VALID ENTRIES ON, OFF.

NOTES N/A

ClearAiExtrasDist EFFECT Controls the distance at which the ClearRandAiExtrasSp/Mp features will take effect when they are set to on.VALID ENTRIES 50-5000

NOTES Recommended distance is 200-500. Lower setting will result in vehicles being closer to the player before their extras are turned off.

Lstg3LightsMoveTraf EFFECT Sets weather the ELS lights (without any siren tones playing) will cause AI traffic to move over when the system is in LSTG 3.VALID ENTRIES ON, OFF.

NOTES This option does not affect the siren tones and horn soundsthey will always cause AI traffic to move over.


23/25


22

6.06 VEHICLE SLOT CONTROL OPTIONS

The following lists explain each of the options contained within the vehicle slot configuration file (_SLOTCONTROL.ini).

ANY VALID VEHICLE SLOT NAME

Status EFFECT Sets whether ELS will be active on the particular vehicle model.VALID ENTRIES ON, OFF

NOTES N/A

File EFFECT Identifies the name of the vehicle configuration file (VCF) to use with the vehicle model.VALID ENTRIES The name of any existing VCF inside the ELS folder.

NOTES The file name specified should notcontain the extension of the file bei ng referenced (it will be automatically detected).


24/25


23

6.07 VEHICLE CONFIGURATION FILE OPTIONS

The following lists explain each of the options contained in the ELS vehicle configuration files (VCFs).

MISC

Slicktop EFFECT When set to on, will apply range and intensity of SECL environmental lights to PRML.VALID ENTRIES ON, OFF.

NOTES When using this setting, it is recommended to carefully position the environmental lights in the ENV_LIGHT_POS section.

LstgActivationType EFFECT Identifies the name of the vehicle configuration file (VCF) to use with the vehicle model.VALID ENTRIES DEFAULT, INVERTED, JUMP, EURO.

NOTES (J // Alt+J) Default: LSTG // LSTG; Inverted: LSTG // LSTG; Jump/Euro: LSTG3-LSTG0 // LSTG.

EnableArrowBoard EFFECT Sets whether or not or which type of arrow board functionality to enable for the vehicle.VALID ENTRIES OFF, HOOD, TRUNK.

NOTES This option should only be enabled on vehicle models specifically designed to make use of the arrow board feature.

AllowTakedowns EFFECT Sets whether takedown lights feature (TL) will be available for the vehicle.VALID ENTRIES ON, OFF.

NOTES N/A

UseCoronaTakedowns EFFECT Sets whether coronas will be used as takedown lights when the TL feature is allowed and active.VALID ENTRIES ON, OFF.

NOTES This option should only be enabled on vehicle models specifically designed to make use of this feature.

CRUISEDisableAtLstg3 EFFECT Sets whether CR option can be used when LSTG is at 3.


UseExtra1 EFFECT Sets whether CR will use extra/light 1 when active.VALID ENTRIES ON, OFF.


UseExtra3 EFFECT Sets whether CR will use extra/light 3 when active.



SOUNDS

AH_Type EFFECT Sets which type of sound to use for the vehicles air horn (AH) function.VALID ENTRIES AH, FIRE, CIV1, CIV2, CIV3.

AH_SrnToneForM2 EFFECT Sets which siren tone to use when engaging manual 2 (when pressing AH+M1).VALID ENTRIES WAIL, YELP, ALT1, ALT2.

SRN_DefaultMode EFFECT Sets the default mode for the vehicle siren.VALID ENTRIES STBY, HDSF.

SRN_ResetSrnTone EFFECT Sets whether the siren tone will be reset to wail once the siren is turned off.VALID ENTRIES ON, OFF.

SRN_AllowToneYelp EFFECT Sets whether the yelp tone will be available for the vehicle (does not affect the manual 2 tone).VALID ENTRIES ON, OFF.

SRN_AllowToneAlt1 EFFECT Sets whether the alt1 tone will be available for the vehicle (does not affect the manual 2 tone).VALID ENTRIES ON, OFF.

SRN_AllowToneAlt2EFFECT Sets whether the alt2 tone will be available for the vehicle (does not affect the manual 2 tone).


CORONAS

Headlights EFFECT Toggles whether the headlight-based coronas will be used on the given vehicle, and sets their flash pattern.VALID ENTRIES ON, OFF (for toggle); 0-5 (for pattern).

NOTES Toggle and pattern entries must be separated by a comma (toggle, pattern).

Taillights EFFECT Toggles whether the taillight-based coronas will be used on the given vehicle, and sets their flash pattern.VALID ENTRIES ON, OFF (for toggle); 0-5 (for pattern).


IndicatorsF EFFECT Toggles whether the front indicator-based coronas will be used on the given vehicle, and sets their flash pattern.VALID ENTRIES ON, OFF (for toggle); 0-5 (for pattern).


IndicatorsB EFFECT Toggles whether the rear indicator-based coronas will be used on the given vehicle, and sets their flash pattern.VALID ENTRIES ON, OFF (for toggle); 0-5 (for pattern).


Reverselights EFFECT Toggles whether the reverse light-based coronas will be used on the given vehicle, and sets their flash pattern.VALID ENTRIES ON, OFF (for toggle); 0-5 (for pattern).


WRNL

Type EFFECT Sets the WRNL lighting type.VALID ENTRIES LEDS (or HALO), STRB, TKDN, SBRN.

UseScnNotTkd EFFECT Controls whether SCN lights replace TKD lights on this modelintended for larger vehicles.VALID ENTRIES ON, OFF.

ForcePatForLstg EFFECT Controls whether the patterns selected in the two options below will be enforced when the system is in LSTG 2 and LSTG 3.VALID ENTRIES ON, OFF.

PatId_Lstg3 EFFECT Sets the automatic WRNL pattern for LSTG 3will be forced if ForcePatForLstg is set to on.VALID ENTRIES Any valid WRNL pattern IDmust be a number, do not include letters or symbols.


25/25


24

PRMLType EFFECT Sets the PRML lighting type.

VALID ENTRIES LEDS, STRB, ROTA, RMIX.

ForcePatForLstg EFFECT Controls whether the patterns selected in the two options below will be enforced when the system is in LSTG 2 and LSTG 3.VALID ENTRIES ON, OFF.

PatId_Lstg2 EFFECT Sets the automatic PRML pattern for LSTG 2will be forced if ForcePatForLstg is set to on.VALID ENTRIES Any valid PRML pattern IDmust be a number, do not include letters or symbols.

PatId_Lstg3 EFFECT Sets the automatic PRML pattern for LSTG 3will be forced if ForcePatForLstg is set to on.VALID ENTRIES Any valid PRML pattern IDmust be a number, do not include letters or symbols.

Lstg2ActiveExtras EFFECT Sets which PRML extras will flash when the system is in LSTG 2.VALID ENTRIES 1AND4, 2AND3.

ExpressModeRandPat EFFECT Determines whether or not a random pattern will be applied every time the lights are switched on when in Express mode.VALID ENTRIES ON, OFF.

ForcePatForSrnTones EFFECT Sets whether or not the patterns specified below will be applied whenever the siren tone is changed.VALID ENTRIES ON, OFF.

PatId_Yelp EFFECT When ForcePatForSrnTones is on, specifies the pattern that will be forced for the yelp siren tone.VALID ENTRIES Any valid PRML pattern IDmust be a number, do not include letters or symbols.

PatId_Alt1 EFFECT When ForcePatForSrnTones is on, specifies the pattern that will be forced for the alt1 siren tone.VALID ENTRIES Any valid PRML pattern IDmust be a number, do not include letters or symbols.

PatId_Alt2 EFFECT When ForcePatForSrnTones is on, specifies the pattern that will be forced for the alt2 siren tone.VALID ENTRIES Any valid PRML pattern IDmust be a number, do not include letters or symbols.

SECL

Type EFFECT Sets the SECL lighting type.VALID ENTRIES LEDS, STRB, ROTA, DRCT, ARRW, MARQ.

DisableAtLstg3 EFFECT Sets whether or not the SECL will be automatically disabled once the system is in LSTG 3.VALID ENTRIES ON, OFF.

ForcePatForLstg EFFECT Controls whether the patterns selected in the options below will be enforced whenever the LSTG changes.VALID ENTRIES ON, OFF.

PatId_Lstg1 EFFECT Sets the automatic SECL pattern for LSTG 1will be forced if ForcePatForLstg is set to on.VALID ENTRIES Any valid SECL pattern IDmust be a number, do not include letters or symbols.



ENV_LIGHT_COLORSExtra_1 to Extra_9 EFFECT Sets the color for the environmental lighting of the corresponding light/extra.

VALID ENTRIES RED, BLUE, EBLUE, WHITE, AMBER, GREEN, MAGENTA.

ENV_LIGHT_ACTIVE

Extra_1 to Extra_9EFFECT Sets whether environmental lighting will show for corresponding light/extra. Does not apply to ROTA types or TKD/SCN lights.


ENV_LIGHT_POSExtra_1 to Extra_9 EFFECT Sets the X, Y, and Z axis position/offset for the corresponding environmental light/extra (relative to the vehicle).

VALID ENTRIES Any valid vehicle offset float/decimal value.

NOTES Values must be separated by commas (x, y, z). Example: Extra_1 = -3.5, 0.0, 1.85

Els User Guide

Documents

Transcript of Els User Guide