triggerAmmo: Difference between revisions

From Bohemia Interactive Community
No edit summary
mNo edit summary
 
Line 20: Line 20:
|s2since= arma3 2.22
|s2since= arma3 2.22
|p21= munition: [[Object]] - ammo. If 'timeLeft' and 'distanceLeft' are not provided, the action is identical to the main syntax.
|p21= munition: [[Object]] - ammo. If 'timeLeft' and 'distanceLeft' are not provided, the action is identical to the main syntax.
|p22= timeLeft (Optional): [[Number]] - 'timeToExplosion' (see [[getShotInfo]]). Can only be set to <= relevant config value. Default: -1 - ignore.
|p22= timeLeft: [[Number]] - (Optional) 'timeToExplosion' (see [[getShotInfo]]). Can only be set to <= relevant config value. Default: -1 - ignore.
|p23= distanceLeft (Optional): [[Number]] - 'fuseDistanceLeft' (see [[getShotInfo]]). Can only be set to <= relevant config value. Default: -1 - ignore.
|p23= distanceLeft: [[Number]] - (Optional) 'fuseDistanceLeft' (see [[getShotInfo]]). Can only be set to <= relevant config value. Default: -1 - ignore.


|r2= [[Nothing]]
|r2= [[Nothing]]

Latest revision as of 12:53, 1 January 2026

Hover & click on the images for description

Description

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.
Groups:
Object Manipulation

Syntax

Syntax:
triggerAmmo munition
Parameters:
munition: Object
Return Value:
Nothing

Alternative Syntax

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

Examples

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

Additional Information

See also:
getShotParents "Fired" Event Handler

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord.
Only post proven facts here! Add Note