---
name: "triggerAmmo"
type: command
status: ok
groups: ["Object Manipulation"]
arma3_since: "1.92"
locality: {"argument": "local", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/triggerAmmo
revid: 377211
updated: 2026-01-01T11:53:01Z
---

# triggerAmmo

*Command · Object Manipulation · Arma 3 v1.92*

Locality: arguments **local**

## Description

Triggers a munition such as shells, bullets, missiles, rockets, mines and bombs (*shotSubmunition/shotShell/shotBullet/shotMissile/shotRocket*) as if it did hit.
If ammo uses submunition, then creation of submunition will be triggered. Since Arma 3 v 2.22 it is possible to manipulate mine timer, cook grenades and alter missile trigger distance.

## Syntax

### Syntax 1

```sqf
triggerAmmo munition
```

**Parameters:**

- `munition`: [Object](../topics/Object.md)

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

### Syntax 2

*since arma3 2.22*

```sqf
triggerAmmo [munition, timeLeft, distanceLeft]
```

**Parameters:**

- `munition`: [Object](../topics/Object.md) - ammo. If 'timeLeft' and 'distanceLeft' are not provided, the action is identical to the main syntax.
- `timeLeft`: [Number](../topics/Number.md) - (Optional) 'timeToExplosion' (see [getShotInfo](../commands/getShotInfo.md)). Can only be set to <= relevant config value. Default: -1 - ignore.
- `distanceLeft`: [Number](../topics/Number.md) - (Optional) 'fuseDistanceLeft' (see [getShotInfo](../commands/getShotInfo.md)). Can only be set to <= relevant config value. Default: -1 - ignore.

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

## Examples

### Example 1

```sqf
triggerAmmo bomb1;
```

### Example 2

```sqf
player addEventHandler ["FiredMan", {triggerAmmo [_this select 6, 1]}]; // explodes handgrenade or sets smoke on smokegrenade 1 sec after the throw.
```

## See also

[getShotParents](../commands/getShotParents.md) · [Arma 3: Event Handlers](../topics/Event_Handlers.md)

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