# Extra Integrations

## 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:

{% embed url="<https://www.youtube.com/watch?v=V-j__JXwqOk>" %}
SoundOff BluePRINT Functionality
{% endembed %}

{% embed url="<https://youtu.be/-Ww6jQxuL2g?t=562>" %}
Whelen Cencom Carbide Functionality
{% endembed %}

### **Currently Supported States/Extras:**

<table><thead><tr><th width="188.33333333333331" align="center">Common Name</th><th width="141">String</th><th width="417.6666666666667">Trigger</th></tr></thead><tbody><tr><td align="center">Brake Lights</td><td><code>Brake</code></td><td>Vehicle is in braking.</td></tr><tr><td align="center">Reverse Lights</td><td><code>Reverse</code></td><td>Vehicle is in reverse.</td></tr><tr><td align="center">Right Indicator</td><td><code>RIndicator</code></td><td>Vehicles left turn signal is active.</td></tr><tr><td align="center">Left Indicator</td><td><code>LIndicator</code></td><td>Vehicles right turn signal is active.</td></tr><tr><td align="center">Takedowns</td><td><code>Takedowns</code></td><td>Take-downs are enabled (requires <em>takedowns</em> plugin).</td></tr><tr><td align="center">Driver Seat</td><td><code>DSeat</code></td><td>Driver seat occupied.</td></tr><tr><td align="center">Driver Door</td><td><code>DDoor</code></td><td>Driver door not latched.</td></tr><tr><td align="center">Passenger Door</td><td><code>PDoor</code></td><td>Passenger door not latched.</td></tr><tr><td align="center">Trunk</td><td><code>Trunk</code></td><td>Trunk is not latched.</td></tr><tr><td align="center">Main Siren</td><td><code>MainSiren</code></td><td>Main/Primary siren is activated.</td></tr><tr><td align="center">Aux Siren</td><td><code>AuxSiren</code></td><td>Aux/Pwrcall siren is activated.</td></tr><tr><td align="center">Air Horn</td><td><code>AirHorn</code></td><td>Air horn is active.</td></tr><tr><td align="center">Manual Tone</td><td><code>Manu</code></td><td>Primary or Secondary Manual tone is active.</td></tr></tbody></table>

### 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.\
   \&#xNAN;*Example:*

   <pre class="language-lua" data-title="SETTINGS.lua"><code class="lang-lua">EXTRA_ASSIGNMENTS = {
       ['LAPD'] = { 
       			--[&#x3C;extra_id>] = { repair = &#x3C;true/false>, toggle = {&#x3C;string(s)>}, reverse = &#x3C;true/false>}
   			[7] = { repair = true, toggle = { "Takedowns", "AirHorn" } },
   			[8] = { repair = true, toggle = { "DSeat" } },
   			[9] = { repair = true, toggle = { "DSeat" } , reverse = true},
   		},
   }
   </code></pre>

   ####

#### 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" } },`

{% hint style="success" %}
Finished, configure your personal settings in game under 'Plugins->Extra Integrations' menu.
{% endhint %}