Wiki
Clone wikiGTA Vehicle Controller / Configuration
Configuration File
Vehicle controller is a very user friendly and configurable plug-in for GTA V. In order to configure the plug-in with your own taste, you just need to open the file named VehicleController.ini for which is bundled together with this plug-in download package. If you can't find this file or deleted by accident, just start the game and the plug-in will create the file again with the default configuration parameters.
Table of Contents
Parameter Types
Each parameter configurable have it own base type, which defines what values are valid and which ones are invalid or default.
Boolean
Boolean parameters are normally used by this plug-in to enable or disable a feature or a specific function. The only valid values are True or False, or its numeral representation where True equals to 1 and False to 0.
Keys
Keyboard binds are used to define which combination of keys will trigger a specific feature of this plug-in. It is possible to set it to a single key such as T, or set it to a combination of keys such as Ctrl+T or Ctrl+Shift+O, however it is important to remember that if the keys are used on GTA V originally, it will keep triggering both (GTA V and this plug-in) functions at the same time. To see a full list of available key names, please check the following link: Link
Controls
Control binds are used to define which button from your game pad will trigger a specific feature of this plug-in. Unfortunately, GTA V originally didn't implement a good way to access their control support via natives, so the only way to use it is by using their predefined names for specific functions. For example, if you want to use the right button from your controller dpad, you need to set it to a similar GTAV function which uses it buttons on another vehicle (eg. VehicleGrapplingHook). For a full list of valid values and it default buttons, please check the following link: Controls
Integers
Integers is a number which can be written without a fractional component, for example: 21, 4, 0, and −2048 are integers, while 9.75, 5½, and √2 are not. These numbers are used by this plug-in to adjust a specific feature to the user own taste. The valid range to this values is from −2147483648 to 2147483647, but it is not recommended to use such high values and also remember to check if it is logic or not to use a negative value on some parameters.
Float or Double
Floating numbers are numbers which might have their fractional component, such as 1.0, 9.75, -1.0, -9.75. These numbers are used by this plug-in to fine adjust a certain feature where an integer won't allow the necessary level of adjustment. It is important to notice that you should use the dot (.) to split the integer part from its fractional component regardless of your language settings.
Colours
Colour parameters are used to customize some graphical features of this plug-in. There are two possibilities to define this parameters: The first one is setting it by using an ARGB (#AARRGGBB) hexadecimal codes, while the second option is setting by its colour common name, defined by Microsoft on the following link:
Point
Point parameters are used to specify a point to be used by certain features of this plug-in. A point is a structure of two integers (numbers), which the first one is the X value, and the last one is the Y value, and its formal representation is X,Y (notice the comma being used to split both parameters).
Size
Size parameter is a similar parameter to Point, however its X and Y values are used to scale something on the plug-in.
Vector3
Vector3 parameter is a parameter used to define a specific 3d coordinate from GTAV. It uses X, Y and Z values, all of them being valid float numbers (it can be negative values).
Log Level
Special parameter utilized to define which level of logging you want on the plug-in. Valid values are (from the maximum to the lowest level of logging): Info, Warning, Error, Fatal, None. If you set this parameter to Error, it means that Info and Warning messages will be ignored, while Error and Fatal messages will be logged. None is used to disable completely the logging.
Plugin General Configuration
General
Parameter Name | Type | Default | Description |
---|---|---|---|
Enabled | Boolean | True | Enable or disable the entire plug-in. |
Installed | Boolean | True | Plug-in will generate the default ini file if this parameter has been set to False. |
BreakLightsWhenFullStopped | Boolean | False | Break lights will be activated when the vehicle is fully stopped. |
BreakLightsUntilMove | Boolean | True | Break lights will be activated and keep active until you move the vehicle. |
GTAIVExitVehicleStyle | Boolean | True | Define exit vehicle behaviour from GTA IV (Press = Exit with engine on, Hold = Turn off engines). |
Log
Parameter Name | Type | Default | Description |
---|---|---|---|
Verbosity | ELogLevel | Info | Logging level |
Engine
Parameter Name | Type | Default | Description |
---|---|---|---|
Enabled | Boolean | True | Define if this component is active. |
SaveStateWhenLeave | Boolean | False | Define if the engine state should be preserved when you leave the vehicle (It means if you kill the engine, you need to turn it on manually). |
ToggleKey | Keys | Ctrl+K | Define which keys will toggle the engine killing. |
ToggleControl | EControlKey | None | Define which game pad button will toggle the engine killing. |
Cruise Control
Parameter Name | Type | Default | Description |
---|---|---|---|
Enabled | Boolean | True | Define if this component is active. |
UpdateSpeedWhenAccelerating | Boolean | True | Define if the cruising speed should be updated when the user is accelerating. |
UpdateSpeedWhenBreaking | Boolean | True | Define if the cruising speed should be updated when the user is breaking. |
DisableWhenHandbreaking | Boolean | True | Define if the cruise control should auto disable when the user press the handbreak control. |
DisableWhenCrashDetected | Boolean | True | Define if the cruise control should auto disable when the user crashes the vehicle. |
ToggleKey | Keys | Ctrl+T | Define which keys will toggle the component. |
ToggleControl | EControlKey | None | Define which game pad button will toggle the component. |
Doors
Parameter Name | Type | Default | Description |
---|---|---|---|
HoodOpenLoose | Boolean | True | Define if the hood will be loose when opened. |
HoodOpenInstantly | Boolean | False | Define if the plug-in should skip the open animation. |
HoodCloseInstantly | Boolean | False | Define if the plug-in should skip the close animation. |
HoodNotificationMessage | Boolean | True | Define if the plug-in should show a message to this action. |
TrunkOpenLoose | Boolean | True | Define if the trunk will be loose when opened. |
TrunkOpenInstantly | Boolean | False | Define if the plug-in should skip the trunk open animation. |
TrunkCloseInstantly | Boolean | False | Define if the plug-in should skip the trunk close animation. |
TrunkNotificationMessage | Boolean | True | Define if the plug-in should show a message to this action. |
HoodToggle | Keys | Ctrl+J | Define which keys will toggle the hood. |
TrunkToggle | Keys | Ctrl+L | Define which keys will toggle the trunk. |
HoodControl | EControlKey | None | Define which game pad button will toggle the hood. |
TrunkControl | EControlKey | None | Define which game pad button will toggle the trunk. |
Indicators
Parameter Name | Type | Default | Description |
---|---|---|---|
Enabled | Boolean | True | Define if this component is active. |
LeftIndicatorKey | Keys | J | Define which keys will toggle the left indicator. |
RightIndicatorKey | Keys | L | Define which keys will toggle the right indicator. |
HarzardLightsKey | Keys | K | Define which keys will toggle the hazard lights. |
LeftIndicatorControl | EControlKey | None | Define which game pad button will toggle the left indicator. |
RightIndicatorControl | EControlKey | None | Define which game pad button will toggle the right indicator. |
HarzardLightControl | EControlKey | None | Define which game pad button will toggle the hazard lights. |
Lights
Parameter Name | Type | Default | Description |
---|---|---|---|
InteriorLightsToggleKey | Keys | I | Define which keys will toggle the interior lights. |
SearchLightToggleKey | Keys | Ctrl+I | Define which keys will toggle the siren lights without sound. |
TaxiLightToggleKey | Keys | Ctrl+I | Define which keys will toggle the taxi lights. |
InteriorLightsControl | EControlKey | None | Define which game pad button will toggle the interior lights. |
SirenLightControl | EControlKey | None | Define which game pad button will toggle the siren lights without sound. |
TaxiLightControl | EControlKey | None | Define which game pad button will toggle the taxi lights. |
SearchLight
Parameter Name | Type | Default | Description |
---|---|---|---|
Enabled | Boolean | True | Define if this component is active. |
SearchlightToggleKey | Keys | Ctrl+P | Define which keys will toggle the search lights. |
SearchlightControl | EControlKey | None | Define which game pad button will toggle the search lights. |
SearchlightUpKey | Keys | NumPad8 | Adjust the search light direction (up). |
SearchlightDownKey | Keys | NumPad2 | Adjust the search light direction (down). |
SearchlightLeftKey | Keys | NumPad4 | Adjust the search light direction (left). |
SearchlightRightKey | Keys | NumPad6 | Adjust the search light direction (right). |
SearchlightUpControl | EControlKey | None | Define which game pad button will adjust the search light direction (up). |
SearchlightDownControl | EControlKey | None | Define which game pad button will adjust the search light direction (down). |
SearchlightLeftControl | EControlKey | None | Define which game pad button will adjust the search light direction (left). |
SearchlightRightControl | EControlKey | None | Define which game pad button will adjust the search light direction (right). |
MovementFactor | Float | 0.03 | Define the adjustment factor for each key tick (lower = slower). |
RadiusDefault | Float | 10.0 | Define the search light radius for vehicles. |
RadiusHelicopters | Float | 10.0 | Define the search light radius for helicopters. |
RadiusBoats | Float | 10.0 | Define the search light radius for boats. |
BrightnessDefault | Float | 30.0 | Define the search light brightness for vehicles. |
BrightnessHelicopters | Float | 40.0 | Define the search light brightness for helicopters. |
BrightnessBoats | Float | 40.0 | Define the search light brightness for boats. |
DistanceDefault | Float | 60.0 | Define the search light distance for vehicles. |
DistanceHelicopters | Float | 250.0 | Define the search light distance for helicopters. |
DistanceBoats | Float | 250.0 | Define the search light distance for boats. |
ColorDefault | Float | White | Define the search light colour for vehicles. |
ColorHelicopters | Float | White | Define the search light colour for helicopters. |
ColorBoats | Float | White | Define the search light colour for boats. |
Windows
Parameter Name | Type | Default | Description |
---|---|---|---|
ToggleKey | Keys | Multiply | Define which keys will toggle the current window. |
ToggleAllKey | Keys | Ctrl+Multiply | Define which keys will toggle all vehicle windows. |
ToggleControl | EControlKey | None | Define which game pad button will toggle the current window. |
ToggleAllControl | EControlKey | None | Define which game pad button will toggle all vehicle windows. |
SkyLift
Parameter Name | Type | Default | Description |
---|---|---|---|
Enabled | Boolean | True | Define if this component is active. |
DetectionRadius | Float | 10 | Define the radius to grab vehicles from ground. |
Vehicle Configuration Parameters
Although most vehicles uses the same settings, some vehicles such as emergency vehicles or trucks needs special configuration. Using the VehicleController_vehicles.ini file the user is allowed to change specific features for each vehicle. In order to specific a vehicle configuration, the user need to create a section using the vehicle model name between brackets and it needs to be upper-case (e.g. [AMBULANCE]). Also it is possible to change default settings by changing the [DEFAULT] section. Below are all parameters available for each vehicle configuration.
Vehicle Configuration
Parameter Name | Type | Default | Description |
---|---|---|---|
HoodEnabled | Boolean | True | Define if the hood component is enabled for this vehicle. |
HoodFixWhenClose | Boolean | False | Define if the hood should use repair API instead of closing normally (some vehicles doesn't seem to work with normal door close API). |
HoodIdArray | Integer Array | 4 | Define which door(s) id(s) to use for the hood component (separated by : character) |
TrunkEnabled | Boolean | True | Define if the trunk component is enabled for this vehicle |
TrunkFixWhenClose | Boolean | False | Define if the trunk should use repair API instead of closing normally (some vehicles doesn't seem to work with normal door close API). |
TrunkIdArray | Integer Array | 5:6 | Define which door(s) id(s) to use for the hood component (separated by : character). |
TrunkDebug | Boolean | False | If defined to True it will execute the opening/close for all doors ids each 3 seconds. Useful for discovering which ID is used for a specific vehicle trunk. |
SirenLights | Boolean | False | Define if the siren muting component is enabled for this vehicle. |
SearchLightDriver | Boolean | False | Define if the search light component is enabled for this vehicle driver. |
SearchLightPassenger | Boolean | False | Define if the search light component is enabled for this vehicle passenger. |
SearchLightDebug | Boolean | False | If defined to True it will change the position of the search light starts (useful for positing it correctly). Uses NumPad7 and NumPad1 the Y-axis. |
SearchLightOffsetDriver | Vector3 | 0,0,0 | Define the offset from the vehicle model where the driver search light starts. |
SearchLightOffsetPassenger | Vector3 | 0,0,0 | Define the offset from the vehicle model where the passenger search light starts. |
Updated