{"name":"triggerAmmo","operator":null,"title":"triggerAmmo","type":"command","url":"https://community.bistudio.com/wiki/triggerAmmo","revid":377211,"updated":"2026-01-01T11:53:01Z","groups":["Object Manipulation"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"1.92"}],"since":{"game":"arma3","name":"Arma 3","version":"1.92"},"arma3_since":"1.92","branch":null,"locality":{"argument":"local","effect":null,"server_exec":false},"exec":null,"description":"Triggers a munition such as shells, bullets, missiles, rockets, mines and bombs (*shotSubmunition/shotShell/shotBullet/shotMissile/shotRocket*) as if it did hit.\nIf 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.","syntaxes":[{"syntax":"triggerAmmo munition","since":null,"effect":null,"exec":null,"params":[{"name":"munition","type":"Object","optional":false,"default":null,"description":null,"types":["Object"],"since":null,"text":"munition: Object"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"unary","operator":null,"left":null,"right":{"text":"munition","types":["Object"]}},{"syntax":"triggerAmmo [munition, timeLeft, distanceLeft]","since":"arma3 2.22","effect":null,"exec":null,"params":[{"name":"munition","type":"Object","optional":false,"default":null,"description":"ammo. If 'timeLeft' and 'distanceLeft' are not provided, the action is identical to the main syntax.","types":["Object"],"since":null,"text":"munition: Object - ammo. If 'timeLeft' and 'distanceLeft' are not provided, the action is identical to the main syntax."},{"name":"timeLeft","type":"Number","optional":true,"default":null,"description":"'timeToExplosion' (see getShotInfo). Can only be set to <= relevant config value. Default: -1 - ignore.","types":["Number"],"since":null,"text":"timeLeft: Number - (Optional) 'timeToExplosion' (see getShotInfo). Can only be set to <= relevant config value. Default: -1 - ignore."},{"name":"distanceLeft","type":"Number","optional":true,"default":null,"description":"'fuseDistanceLeft' (see getShotInfo). Can only be set to <= relevant config value. Default: -1 - ignore.","types":["Number"],"since":null,"text":"distanceLeft: Number - (Optional) 'fuseDistanceLeft' (see getShotInfo). Can only be set to <= relevant config value. Default: -1 - ignore."}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"unary","operator":null,"left":null,"right":{"text":"[munition, timeLeft, distanceLeft]","types":["Array"]}}],"examples":[{"text":"```sqf\ntriggerAmmo bomb1;\n```","code":["triggerAmmo bomb1;"]},{"text":"```sqf\nplayer addEventHandler [\"FiredMan\", {triggerAmmo [_this select 6, 1]}]; // explodes handgrenade or sets smoke on smokegrenade 1 sec after the throw.\n```","code":["player addEventHandler [\"FiredMan\", {triggerAmmo [_this select 6, 1]}]; // explodes handgrenade or sets smoke on smokegrenade 1 sec after the throw."]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["getShotParents","Arma 3: Event Handlers"],"notes":[],"categories":["Arma 3: New Scripting Commands","Arma 3: Scripting Commands","Command Group: Object Manipulation","Introduced with Arma 3 version 1.92","Scripting Commands"]}