⚡Extra Integrations

Toggle extras based on vehicle states.

Introduction

The "extra_integration" plugin handles specific actions based on vehicles state (braking, accelerating, reversing, stopped, etc.). The primary function is to enable LVC to add / remove vehicle extras based on these states. This allows vehicle developers to map extras to specific vehicle features like light bar brake lights, or rear emergency light reverse override. Future states and extras may be added later.

In addition to toggling extras, this plugin can be used to handle brake light function when stopped, automatically applying brake lights without the control needing to be held.

Real-life Examples:

SoundOff BluePRINT Functionality

Whelen Cencom Carbide Functionality

Currently Supported States/Extras:

Common Name	String	Trigger
Brake Lights	Brake	Vehicle is in braking.
Reverse Lights	Reverse	Vehicle is in reverse.
Right Indicator	RIndicator	Vehicles left turn signal is active.
Left Indicator	LIndicator	Vehicles right turn signal is active.
Takedowns	Takedowns	Take-downs are enabled (requires takedowns plugin).
Driver Seat	DSeat	Driver seat occupied.
Driver Door	DDoor	Driver door not latched.
Passenger Door	PDoor	Passenger door not latched.
Trunk	Trunk	Trunk is not latched.
Main Siren	MainSiren	Main/Primary siren is activated.
Aux Siren	AuxSiren	Aux/Pwrcall siren is activated.
Air Horn	AirHorn	Air horn is active.
Manual Tone	Manu	Primary or Secondary Manual tone is active.

Configuration

1. Ensure that plugins_installed is set to true in lvc/SETTINGS.lua.

2. Open the SETTINGS.lua located in /plugins/extra_integration. Adjust settings to your liking.

3. Now configure the EXTRA_ASSIGNMENTS table to your liking. The Extra Assignments table is very dynamic an allows for multiple set up variations. Example:

   SETTINGS.lua

   EXTRA_ASSIGNMENTS = {
       ['LAPD'] = { 
       			--[<extra_id>] = { repair = <true/false>, toggle = {<string(s)>}, reverse = <true/false>}
   			[7] = { repair = true, toggle = { "Takedowns", "AirHorn" } },
   			[8] = { repair = true, toggle = { "DSeat" } },
   			[9] = { repair = true, toggle = { "DSeat" } , reverse = true},
   		},
   }

Toggle

A toggle key will toggle a single extra on trigger or multiple extra if a table is passed in.

• Single Example: toggle = { "DSeat" }

• Multiple Example: toggle = { "Takedowns", "AirHorn" }

Add & Remove

Add / Remove tables are not currently supported, instead use toggle. Use reverse flag to change when state is "active".

Repair Flag

A repair flag can optionally be added for higher poly extras. GTA will set extras of low poly items without repairing the vehicle, however for things like spotlights, lightbars, etc. the repair flag may need to be set. By default repair is set to disabled, to override add repair = true somewhere inside the desired trigger table.

• Examples:

  • [7] = { repair = true, toggle = { "Takedowns", "AirHorn" } },

  • [8] = { repair = true, toggle = { "DSeat" } },

Finished, configure your personal settings in game under 'Plugins->Extra Integrations' menu.