Luxart Engineering
ProductsDocsDiscordDownload
  • Welcome to Luxart Engineering
  • 🗺️Product Roadmaps
  • ➕Frameworks & Exports
  • Fleet
    • 🚔What is LVC:Fleet?
    • 📄Resource Installation
      • 🛠️Customize VCFs
      • ⚙️Configure Base Settings
      • 💻Advanced Configuration
    • 🎮In Game Use Guide
      • LVC:Fleet Menu
  • v3
    • 📄Resource Installation
      • Configure Base Settings
      • Configure Sirens
      • Assign Sirens
      • Advanced Configuration
      • Server Sided Siren Integration
    • ❔FAQ
  • Shared Plugins
    • 🔌Introduction to Plugins
    • 🔦Take-downs
    • 🎮Extra Controls
    • ⚡Extra Integrations
    • 🔛Traffic Advisor
    • 🚛Trailer Support
  • Pro Laser 4
    • 📄Resource Installation
    • 💾Persistent Records & Tablet
    • 🎮In Game Use Guide
    • 📩Framework Guide
Powered by GitBook
On this page
  • Introduction
  • Configuration
  • Extras Table

Was this helpful?

Edit on GitHub
  1. Shared Plugins

Extra Controls

Toggle extras on the fly with hotkeys.

PreviousTake-downsNextExtra Integrations

Last updated 2 years ago

Was this helpful?

Introduction

The "extra_controls" plugin handles specific extra toggling on demand using key bindings. The allows players the ability to toggle spotlights, light cuts, scene lights conveniently without navigating through existing menus. Controls can be set by default or left disabled, if allow_custom_controls is set to true, players can change each control combo and key in game through an LVC menu.

Configuration

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

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

  3. Example:

    SETTINGS.lua
    CONTROLS = {
    	-- COMBOS = { <list of index/key ID of approved combo-keys> }, 
    	-- KEYS = { <list of index/key ID of approved toggle keys> }
    	COMBOS = { 326, 155, 19, 349 },    --LCTRL, LSHIFT, LALT, TAB
    	KEYS = { 187, 188, 189, 190, 20 }  -- ARROW DWN, UP, LFT, RGT, Z
    }
  4. Configure the EXTRA_CONTROLS table to your liking. Example:

    SETTINGS.lua
    EXTRA_CONTROLS = {
    	['DEFAULT'] = { 	},	
    	['LAPD'] = { 
    			--  	{ '<name>', Extras = {<extras table>}, Combo = <default combo>, Key = <default key>, (opt.) Audio = < button soundFX> }
    				{ Name = 'Front Cut', Extras = {add = 8, remove = 9, repair = true}, Combo = 155, Key = 20, Audio = true }, 
    				{ Name = 'Scene Lights', Extras = {toggle = 9, repair = true}, Combo = 349, Key = 20, Audio = true }, 
    				{ Name = 'Pass. Spot Light', Extras = {add = 3, remove = 4, repair = true}, Combo = 326, Key = 20, Audio = false }, 
    	},	
    	['so3'] = { 
    			--  	{ '<name>', Extras = {<extras table>}, Combo = <default combo>, Key = <default key>, (opt.) Audio = < button soundFX> }
    				{ Name = 'Test', Extras = {add = 4, remove = 9, repair = true}, Combo = 155, Key = 20, Audio = true }, 
    				{ Name = 'Test2', Extras = {toggle = 5, repair = true}, Combo = 349, Key = 20, Audio = true }, 
    				{ Name = 'Test3', Extras = {add = 6, remove = 7, repair = true}, Combo = 326, Key = 20, Audio = false }, 
    	},
    }

Every default Combo and Key assignment need to be present at a minimum in the CONTROLS table.

Extras Table

Toggle

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

  • Single Example: { Name = 'Test', Extras = { toggle = 4 }, Combo = 155, Key = 20 }

  • Multiple Example: { Name = 'Test', Extras = { toggle= { 4, 5 } }, Combo = 155, Key = 20 }

Add & Remove

An add and remove key will add the passed extra(s) on trigger and remove passed extras(s) on trigger. When the control is pressed again, the behavior will reverse adding the removed extra(s) and removing the added extra(s).

  • Single Example: `{ Name = 'Test', Extras = { add = 4, remove = 5 }, Combo = 155, Key = 20}

  • Multiple Example: { Name = 'Cruise', Extras = { add = { 4, 8 }, remove = { 5, 9 }, Combo = 155, Key = 20}

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:

    • { Name = 'Test', Extras = { toggle = 4, repair = true }, Combo = 155, Key = 20 }

    • { Name = 'Cruise', Extras = { add = { 5 }, remove = { 6 }, repair = true }, Combo = 155, Key = 20 }

Controls

  • Combo: combokey to be pressed in addition to key in order to activate profile. Combo = 0 to disable the need for a combo key.

  • Key: control to be pressed with combokey (if set) in order to activate profile.

Audio

The audio flag determines if the plugin plays a button press soundfx (like heard when toggling siren) when the extra_control profile is toggled.

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

Determine a set of controls/combos that players can use. Configure the EXTRA_CONTROLS table to your liking. List of Keys:

🎮
CFX Game Reference - Controls