switchLight

Description

Controls whether a lamp is lit or not.

Note
This command was originally designed to only work with CfgNonAIVehicles class "StreetLamp" only. Since Arma 3 v1.92 this command was extended to work with street lights and some prop lights, like portable construction light.

Syntax

lamp switchLight mode

Parameters:

lamp: Object
mode: String - mode can be: "ON", "OFF" or "AUTO" (lamp is on only during nighttime, default)

Returns: Nothing

Examples

Example 1

(object 12345) switchLight "OFF";

Example 2

nearestObject [player, "Streetlamp"] switchLight "OFF";

Example 3

cursorObject switchLight "ON";

Community notes

Killzone_Kid2013-09-16

Before Arma 3 v1.92 use setHit instead:

_lamp = nearestObject [player, "Lamps_base_F"];
_lamp setHit ["light_1_hitpoint", 0.97];    // off
_lamp setHit ["light_1_hitpoint", 0];        // on

Switch all lights off in the 500 radius of player:

private _lamps = nearestObjects [player, ["Lamps_base_F", "PowerLines_base_F", "PowerLines_Small_base_F"], 500];

{
    for "_i" from 0 to (count getAllHitPointsDamage _x -1) do
    {
        _x setHitIndex [_i, 0.97];
    };
} forEach _lamps;

Sa-Matra2023-03-01

How to disable all lamps using the latest Arma 3 commands, a modern method. Disable all lights that are pre-placed on the map, on the entire map:

{
    _x switchLight "OFF";
} forEach (1 allObjects 0);

Disable all script-spawned and editor-placed lamps:

{
    _x switchLight "OFF";
} forEach (8 allObjects 0);

These snippets iterate through all buildings and run switchLight on them. If they're lamps, they'll be turned off.