Download - Els User Guide
-
5/19/2018 Els User Guide
1/25
Luxart Emergency Lighting System
USER GUIDE AND REFERENCE- SECOND EDITION -
ELS V8.0
-
5/19/2018 Els User Guide
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
-
5/19/2018 Els User Guide
3/25
ELS User Guide and Reference
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 .......................................................................................................................................................................................
-
5/19/2018 Els User Guide
4/25
ELS User Guide and Reference
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/19/2018 Els User Guide
5/25
ELS User Guide and Reference
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
-
5/19/2018 Els User Guide
6/25
ELS User Guide and Reference
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 -
5/19/2018 Els User Guide
7/25
ELS User Guide and Reference
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.)
-
5/19/2018 Els User Guide
8/25
ELS User Guide and Reference
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.
-
5/19/2018 Els User Guide
9/25
ELS User Guide and Reference
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.
-
5/19/2018 Els User Guide
10/25
ELS User Guide and Reference
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.
-
5/19/2018 Els User Guide
11/25
ELS User Guide and Reference
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
-
5/19/2018 Els User Guide
12/25
ELS User Guide and Reference
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.
-
5/19/2018 Els User Guide
13/25
ELS User Guide and Reference
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.
-
5/19/2018 Els User Guide
14/25
ELS User Guide and Reference
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
-
5/19/2018 Els User Guide
15/25
ELS User Guide and Reference
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.
-
5/19/2018 Els User Guide
16/25
ELS User Guide and Reference
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.
-
5/19/2018 Els User Guide
17/25
ELS User Guide and Reference
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.
-
5/19/2018 Els User Guide
18/25
ELS User Guide and Reference
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 '
-
5/19/2018 Els User Guide
19/25
ELS User Guide and Reference
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
-
5/19/2018 Els User Guide
20/25
ELS User Guide and Reference
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.
-
5/19/2018 Els User Guide
21/25
ELS User Guide and Reference
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.
NOTES ELS information panel must be active for effect.
Chng_Pat_WRNL FUNCTION Browses through the WRNL flashing patterns.FUNCTION ALT Browses through the WRNL flashing patterns backwards.
NOTES ELS information panel must be active for effect.
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.
NOTES LSTG must be at 3 for effect. In MP, this key is disabled.
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.
NOTES LSTG must be at 3 for effect. In MP, this key is disabled.
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.
NOTES LSTG must be at 3 for effect. In MP, this key is disabled.
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
-
5/19/2018 Els User Guide
22/25
ELS User Guide and Reference
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.
VALID ENTRIES ON, OFF.
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.
-
5/19/2018 Els User Guide
23/25
ELS User Guide and Reference
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).
-
5/19/2018 Els User Guide
24/25
ELS User Guide and Reference
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.
VALID ENTRIES ON, OFF.
UseExtra1 EFFECT Sets whether CR will use extra/light 1 when active.VALID ENTRIES ON, OFF.
UseExtra2 EFFECT Sets whether CR will use extra/light 2 when active.VALID ENTRIES ON, OFF.
UseExtra3 EFFECT Sets whether CR will use extra/light 3 when active.
VALID ENTRIES ON, OFF.
UseExtra4 EFFECT Sets whether CR will use extra/light 4 when active.VALID ENTRIES ON, OFF.
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).
VALID ENTRIES ON, OFF.
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).
NOTES Toggle and pattern entries must be separated by a comma (toggle, 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).
NOTES Toggle and pattern entries must be separated by a comma (toggle, 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).
NOTES Toggle and pattern entries must be separated by a comma (toggle, 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).
NOTES Toggle and pattern entries must be separated by a comma (toggle, 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.
-
5/19/2018 Els User Guide
25/25
ELS User Guide and Reference
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.
PatId_Lstg2 EFFECT Sets the automatic SECL pattern for LSTG 2will be forced if ForcePatForLstg is set to on.VALID ENTRIES Any valid SECL pattern IDmust be a number, do not include letters or symbols.
PatId_Lstg3 EFFECT Sets the automatic SECL pattern for LSTG 3will 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.
VALID ENTRIES ON, OFF.
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