---
name: "setPilotLight"
type: command
status: ok
groups: ["Lights"]
arma3_since: "1.32"
locality: {"argument": "local", "effect": "global", "server_exec": false}
source: https://community.bistudio.com/wiki/setPilotLight
revid: 379382
updated: 2026-10-30T23:59:04Z
---

# setPilotLight

*Command · Lights · Arma 3 v1.32*

Locality: arguments **local** · effect **global**

## Description

Switches headlights of a vehicle on/off. Note that the vehicle has to be [local](../topics/Multiplayer_Scripting.md#locality), for global variant use [Arma 3: Actions](../topics/Actions.md) "[LightOn](../topics/Actions.md#lighton)"/"[LightOff](../topics/Actions.md#lightoff)"

## Syntax

```sqf
vehicle setPilotLight set
```

**Parameters:**

- `vehicle`: [Object](../topics/Object.md)
- `set`: [Boolean](../topics/Boolean.md)

**Returns:** [Nothing](../topics/Nothing.md)

## Examples

### Example 1

```sqf
car setPilotLight true;
```

## See also

[isLightOn](../commands/isLightOn.md) · [isCollisionLightOn](../commands/isCollisionLightOn.md) · [setCollisionLight](../commands/setCollisionLight.md) · [isIRLaserOn](../commands/isIRLaserOn.md)

## Community notes

**HazJ** — 2018-09-28

This command will not work when using [enableSimulation](../commands/enableSimulation.md) FALSE before this command is executed. However collision lights still do using [setCollisionLight](../commands/setCollisionLight.md).

```sqf
// Workaround - Put in object init field
this setPilotLight true;
this setCollisionLight true;
[this] spawn {
    sleep 0.001;
    (_this select 0) enableSimulation false;
};
```

<sub>Source: [BI Community Wiki — setPilotLight](https://community.bistudio.com/wiki/setPilotLight) (revision 379382).</sub>