Vehicle Lights

Overview

Headlights

Qilin with headlights on

If a vehicle has headlights, they are usually available for the driver of the vehicle and if the driver is a human player, the headlights could be operated via keyboard binding (normally L) or scroll action menu. If the driver is AI, it will operate the headlights depending on some preset condition. For example it will turn the lights at night and turn them off in the day time. The exact time when AI may decide to use the lights can be obtained via the following formula (⚠ current formula but could change):

From scripts the headlights could be operated via either the script command setPilotLight or the actions"LightOn" and "LightOff". To check if headlights are on or off use isLightOn command.

If a human player is the driver/pilot, the commands will work unconditionally. However if AI is driving or piloting, then it might resist lights status change. Whether or not AI will attempt to operate the headlights depends on the time of the day and AI's lifeState or behaviour mode. An unconscious/incapacitated AI and AI in the STEALTH, COMBAT or AWARE modes will not operate the headlights and hence won't resist the changes.

Overriding

Since Arma 3 v1.92 it is possible to override AI ability of operating vehicle headlights by using new "LIGHTS" directive with disableAI/enableAI commands.

Search Light

WY-55 Hellcat with the search light activated

At the moment, the WY-55 Hellcat helicopter is the only vehicle in vanilla Arma 3 game that has the search light implemented on the observer turret. This light could only be operated manually either by human player via the scroll action menu or via scripted actions"SearchLightOn" and "SearchLightOff", in which case it could also be switched on/off with AI on the observer turret. To get the status of the search light use isLightOn command with turret path.

The search light is model's VolumeLight proxy that is revealed or hidden by the engine, following user action.

Other Light Sources

Examples

Unit Lights

Overview

Some weapons in Arma 3 allow attachments in form of flashlight or IR laser. Both could be used by human players and AI units.

Flashlight

A FIA soldier with the gun flashlight

When equipped, the flashlight could normally be operated by pressing L if the player is human or via "GunLightOn" and "GunLightOff"actions. The status of the flashlight could be checked with isFlashlightOn command. Flashlights might need to be explicitly enabled for a group before they could be used.

Enabling/Disabling

Flashlights could only be enabled or disabled for a group. The enableGunLights command can have 3 options: "ForceOn", "ForceOff" and "Auto". Passing "Auto" will let AI automatically switch flashlight on and off depending on combat mode. If force enabled, the individual unit flashlight state could be controlled with "GunLightOn" and "GunLightOff"actions:

_unit enableGunLights "ForceOn"; // enables flashlight for the _units's group
_unit action ["GunLightOff", _unit]; // switches flashlight off for the _unit only

Enabling and disabling works only for AI units, human player can always operate flashlight regardless of the mode.