triggerAmmo: Difference between revisions

From Bohemia Interactive Community
m (Text replacement - "‎" to "")
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 9: Line 9:


|descr= Triggers a munition such as shells, bullets, missiles, rockets, mines and bombs (''shotSubmunition/shotShell/shotBullet/shotMissile/shotRocket'') as if it did hit.
|descr= 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.
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.


|s1= [[triggerAmmo]] munition
|s1= [[triggerAmmo]] munition
Line 16: Line 16:


|r1= [[Nothing]]
|r1= [[Nothing]]
|s2= [[triggerAmmo]] [munition, timeLeft, distanceLeft]
|s2since= arma3 2.22
|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.
|p23= distanceLeft (Optional): [[Number]] - 'fuseDistanceLeft' (see [[getShotInfo]]). Can only be set to <= relevant config value. Default: -1 - ignore.
|r2= [[Nothing]]


|x1= <sqf>triggerAmmo bomb1;</sqf>
|x1= <sqf>triggerAmmo bomb1;</sqf>
|x2= <sqf>player addEventHandler ["FiredMan", {triggerAmmo [_this select 6, 1]}]; // explodes handgrenade or sets smoke on smokegrenade 1 sec after the throw.</sqf>


|seealso= [[getShotParents]] [[Arma 3: Event Handlers#Fired|"Fired" Event Handler]]
|seealso= [[getShotParents]] [[Arma 3: Event Handlers#Fired|"Fired" Event Handler]]
}}
}}

Latest revision as of 23:14, 18 December 2025

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 (Optional): Number - 'timeToExplosion' (see getShotInfo). Can only be set to <= relevant config value. Default: -1 - ignore.
distanceLeft (Optional): Number - '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