Arma 3: Lights

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):

private _isTimeForLightsOn = [0,0,0] getEnvSoundController "night" > 0.7;

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.

_vehicle disableAI "LIGHTS"; // override AI _vehicle setCollisionLight false; // force switch collision lights off

Config Related

It is possible to set initial state of the headlights in a vehicle config, so that when vehicle is spawned it has headlights either on or off.

class CfgVehicles
{
	// ...
	class MyVehicle
	{
		// ...
		pilotLight = true; // true - spawn with headlights on, false - spawn with headlights off. Default: false;
		// ...
	};
	// ...
};

Collision Lights

Collision lights on the Speedboat

Normally used in air and naval vehicles.

Overriding

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

_vehicle disableAI "LIGHTS"; // override AI _vehicle setCollisionLight false; // force switch collision lights off

Config Related

It is possible to set initial state of the collision lights in a vehicle config, so that when vehicle is spawned it has collision lights either on or off.

class CfgVehicles
{
	// ...
	class MyVehicle
	{
		// ...
		collisionLight = true; // true - spawn with collision lights on, false - spawn with collision lights off. Default: false;
		// ...
	};
	// ...
};

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.

_heli turretUnit [0] action ["SearchLightOn", _heli]; _heli turretUnit [0] action ["SearchLightOff", _heli];

The turret could be rotated and the search light elevated. To get the orientation of the search light beam:

private _searchLightRotation = deg (_heli animationSourcePhase "obsTurret"); private _searchLightElevation = deg (_heli animationSourcePhase "obsGun");

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

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.

Street Lights

A street light on Malden

Particle Light Sources

See Also

• Arma 3: CfgLights
• Light Source Tutorial