Extra Integrations - TrevorBarns/luxart-vehicle-control GitHub Wiki

⚠️ Notice: The information below outlines instructions for EI Version 1.1 after. To see old instructions click here: EI Version 1.0.0 Wiki

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.

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 lvc/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:

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

  4. Finished ✅ , configure your personal settings in game under 'Plugins/Extra Integrations' menu.

⚠️ **GitHub.com Fallback** ⚠️