doArtilleryFire: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Page overhaul, edited my comment)
m (Text replacement - "(\|[pr][0-9]+ *= *[^- ]*) *- *M([a-z ])" to "$1 - m$2")
 
(33 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma3 |Game name=
|game1= arma3
|version1= 0.50


|0.50|Game version=
|arg= local


|gr1= Artillery |GROUP1=
|gr1= Artillery


|descr= Orders an artillery unit to fire a burst on the given position (silently).


| Orders an artillery unit to fire a burst on the given position (silently). |DESCRIPTION=
|pr= The unit will fire a burst even if the '''rounds''' parameter is 0 or a negative number.


|pr= The unit will fire a burst even if the '''rounds''' parameter is 0 or a negative number. |PROBLEMS=
|s1= unit [[doArtilleryFire]] [position, type, rounds]


|p1= unit: [[Object]]


| unit [[doArtilleryFire]] [position, type, rounds] |SYNTAX=
|p2= position: [[Array]] format [[Position#PositionAGL|PositionAGL]]


|p1= '''unit''': [[Object]] |PARAMETER1=
|p3= type: [[String]] - magazine class name from [[Arma_3:_CfgMagazines|CfgMagazines]] (case sensitive).


|p2= '''position''': [[Position]] |PARAMETER2=
|p4= rounds: [[Number]]


|p3= '''type''': [[String]] - Magazine class name from [[Arma_3:_CfgMagazines|CfgMagazines]] (case sensitive). |PARAMETER3=
|r1= [[Nothing]]


|p4= '''rounds''': [[Number]] |PARAMETER4=
|x1= <sqf>Mortar doArtilleryFire [[3000, 120, 1000], "8Rnd_82mm_Mo_shells", 3];</sqf>


| [[Nothing]] |RETURNVALUE=
|seealso= [[commandArtilleryFire]] [[getArtilleryAmmo]] [[getArtilleryETA]] [[enableEngineArtillery]] [[getArtilleryComputerSettings]] [[shownArtilleryComputer]] [[inRangeOfArtillery]] [[fire]] [[doFire]] [[commandFire]] [[canFire]] [[fireAtTarget]] [[forceWeaponFire]] [[commandSuppressiveFire]] [[doSuppressiveFire]] [[isManualFire]]
}}


{{Note
|user= ansin11
|timestamp= 20200418142600
|game= arma3
|version= 1.98
|text= This command can not fire bursts consisting of more rounds than the given magazine type holds, even if there are several magazines of the same type available. The fire mission issued by this command ends once the artillery unit has to reload.<br><br>
'''Example:'''
<br>The Mk6 Mortar comes with four "8Rnd_82mm_Mo_shells" magazines, giving it a total of 32 HE shells. However, <sqf inline>_mortar doArtilleryFire [_somePos, "8Rnd_82mm_Mo_shells", 10];</sqf> will only fire 8 rounds instead of 10.<br><br>
Similarly, ...
<sqf>_mortar doArtilleryFire [_somePos, "8Rnd_82mm_Mo_shells", 7]; // First burst
sleep 20; // Wait until first burst has been fired
_mortar doArtilleryFire [_somePos, "8Rnd_82mm_Mo_shells", 2]; // Second burst</sqf>
... will only fire 8 rounds total instead of 9; the second round of the second burst is never fired because the artillery unit has to reload after the first round of the second burst.
}}


|x1= <code>Mortar [[doArtilleryFire]] [<nowiki/>[3000, 120, 1000], "8Rnd_82mm_Mo_shells", 3];</code> |EXAMPLE1=
{{Note
 
|user= Leopard20
 
|timestamp= 20220825210517
| [[getArtilleryAmmo]], [[getArtilleryETA]], [[enableEngineArtillery]], [[getArtilleryComputerSettings]], [[shownArtilleryComputer]], [[inRangeOfArtillery]], [[fire]], [[doFire]], [[commandFire]], [[canFire]], [[fireAtTarget]], [[forceWeaponFire]], [[commandArtilleryFire]], [[commandSuppressiveFire]], [[doSuppressiveFire]], [[isManualFire]] |SEEALSO=
|text= After using this command, use [[unitReady]] to see if the unit is done firing all rounds:
<sqf>
_mortar doArtilleryFire [[3000, 120, 1000], "8Rnd_82mm_Mo_shells", 3];
waitUntil {sleep 1; unitReady _mortar}; // Note: make sure you run this in scheduled environment
_mortar sideChat "Rounds fired!";
</sqf>
}}
}}
{{GameCategory|arma3|New Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on April 18, 2020 - 14:26 (UTC)</dd>
<dt class="note">[[User:ansin11|ansin11]]</dt>
<dd class="note">
'''Arma 3 (1.98.146303):''' This command can not fire bursts consisting of more rounds than the given magazine type holds, even if there are several magazines of the same type available. The fire mission issued by this command ends once the artillery unit has to reload.
<br/><br/>'''Example:'''
<br/>The Mk6 Mortar comes with four "8Rnd_82mm_Mo_shells" magazines, giving it a total of 32 HE shells. However,
<code>_mortar [[doArtilleryFire]] [_somePos, "8Rnd_82mm_Mo_shells", 10];</code>
will only fire 8 rounds instead of 10.
<br/><br/>Similarly,
<code>_mortar [[doArtilleryFire]] [_somePos, "8Rnd_82mm_Mo_shells", 7]; {{cc|First burst}}
[[sleep]] 20; {{cc|Wait until first burst has been fired}}
_mortar [[doArtilleryFire]] [_somePos, "8Rnd_82mm_Mo_shells", 2]; {{cc|Second burst}}</code>
will only fire 8 rounds total instead of 9; the second round of the second burst is never fired because the artillery unit has to reload after the first round of the second burst.
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 16:39, 8 November 2023

Hover & click on the images for description

Description

Description:
Orders an artillery unit to fire a burst on the given position (silently).
Problems:
The unit will fire a burst even if the rounds parameter is 0 or a negative number.
Groups:
Artillery

Syntax

Syntax:
unit doArtilleryFire [position, type, rounds]
Parameters:
unit: Object
position: Array format PositionAGL
type: String - magazine class name from CfgMagazines (case sensitive).
rounds: Number
Return Value:
Nothing

Examples

Example 1:
Mortar doArtilleryFire [[3000, 120, 1000], "8Rnd_82mm_Mo_shells", 3];

Additional Information

See also:
commandArtilleryFire getArtilleryAmmo getArtilleryETA enableEngineArtillery getArtilleryComputerSettings shownArtilleryComputer inRangeOfArtillery fire doFire commandFire canFire fireAtTarget forceWeaponFire commandSuppressiveFire doSuppressiveFire isManualFire

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
ansin11 - c
Posted on Apr 18, 2020 - 14:26 (UTC)

This command can not fire bursts consisting of more rounds than the given magazine type holds, even if there are several magazines of the same type available. The fire mission issued by this command ends once the artillery unit has to reload.

Example:
The Mk6 Mortar comes with four "8Rnd_82mm_Mo_shells" magazines, giving it a total of 32 HE shells. However, _mortar doArtilleryFire [_somePos, "8Rnd_82mm_Mo_shells", 10]; will only fire 8 rounds instead of 10.

Similarly, ...

_mortar doArtilleryFire [_somePos, "8Rnd_82mm_Mo_shells", 7]; // First burst sleep 20; // Wait until first burst has been fired _mortar doArtilleryFire [_somePos, "8Rnd_82mm_Mo_shells", 2]; // Second burst
... will only fire 8 rounds total instead of 9; the second round of the second burst is never fired because the artillery unit has to reload after the first round of the second burst.

Leopard20 - c
Posted on Aug 25, 2022 - 21:05 (UTC)
After using this command, use unitReady to see if the unit is done firing all rounds:
_mortar doArtilleryFire [[3000, 120, 1000], "8Rnd_82mm_Mo_shells", 3]; waitUntil {sleep 1; unitReady _mortar}; // Note: make sure you run this in scheduled environment _mortar sideChat "Rounds fired!";