1. Alexandre Leites Avatar Alexandre Leites
  2. Untitled project
  3. GTA Vehicle Controller

Wiki

Clone wiki

GTA Vehicle Controller / Configuration

View History

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