forceWeaponFire: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (Examples and code behind cleanup)
Line 11: Line 11:
____________________________________________________________________________________________
____________________________________________________________________________________________


| The unit will be forced to fire weapon from the given muzzle. The weapon will not fire if firemode passed as parameter is not supported by the given muzzle. The muzzle could belong to a vehicle weapon and unit in this case will be the unit operating this weapon. Doesnt't seem to work for units in FFV positions. See also: [[BIS_fnc_fire]]|= Description
| The unit will be forced to fire weapon from the given muzzle. The weapon will not fire if firemode passed as parameter is not supported by the given muzzle. The muzzle could belong to a vehicle weapon and unit in this case will be the unit operating this weapon. Doesnt't seem to work for units in FFV positions. Works on [[player]]. See also: [[BIS_fnc_fire]] |= Description
____________________________________________________________________________________________
____________________________________________________________________________________________


| unit '''forceWeaponFire''' [muzzle, firemode] |= Syntax
| unit [[forceWeaponFire]] [muzzle, firemode] |= Syntax


|p1= unit: [[Object]] - unit alone or in vehicle |= PARAMETER1
|p1= unit: [[Object]] - unit alone or in vehicle |= Parameter 1


|p2= [muzzle, firemode]: [[Array]]  |= PARAMETER2
|p2= muzzle: [[String]]  |= Parameter 2


|p3= muzzle: [[String]] |= PARAMETER3
|p3= firemode: [[String]] - Common options are "Single", "Burst", "FullAuto". For the full list of a weapon firemodes:


|p4= firemode: [[String]] - Common options are "Single", "Burst", "FullAuto". For the full list of a weapon firemodes:
<code>[[hint]] [[str]] ([[getArray]] ([[configFile]] >> "CfgWeapons" >> [[currentWeapon]] [[player]] >> "modes"));</code> If ''modes[]'' param in config for the weapon says ''{"this"}'', then the same classname as for the weapon param ([[currentWeapon]] [[player]]) should be used as firemode param. |= Parameter 3


<code>[[hint]] [[str]] ([[getArray]] ([[configFile]] >> "CfgWeapons" >> [[currentWeapon]] [[player]] >> "modes"));</code> If ''modes[]'' param in config for the weapon says ''{"this"}'', then the same classname as for the weapon param should be used as firemode param. |= PARAMETER4
| [[Nothing]] |= Return value


| [[Nothing]] |= RETURNVALUE
|x1= <code>_unit [[forceWeaponFire]] ["arifle_MX_F", "Single"];
 
_unit [[forceWeaponFire]] ["hgun_ACPC2_F", "hgun_ACPC2_F"];
 
_unit [[forceWeaponFire]] ["HandGrenadeMuzzle","HandGrenadeMuzzle"];
|x1= <code>soldierOne [[forceWeaponFire]] ["arifle_MX_F", "Single"];</code>|= EXAMPLE1
|x2= <code>[[player]] [[forceWeaponFire]] ["hgun_ACPC2_F", "hgun_ACPC2_F"];</code>|= EXAMPLE2
|x3= <code>_unit [[forceWeaponFire]] ["HandGrenadeMuzzle","HandGrenadeMuzzle"];
_unit [[forceWeaponFire]] ["MiniGrenadeMuzzle","MiniGrenadeMuzzle"];
_unit [[forceWeaponFire]] ["MiniGrenadeMuzzle","MiniGrenadeMuzzle"];
_unit [[forceWeaponFire]] ["HandGrenade_Stone","HandGrenade_Stone"];
_unit [[forceWeaponFire]] ["HandGrenade_Stone","HandGrenade_Stone"];
Line 37: Line 34:
_unit [[forceWeaponFire]] ["ChemlightGreenMuzzle","ChemlightGreenMuzzle"];
_unit [[forceWeaponFire]] ["ChemlightGreenMuzzle","ChemlightGreenMuzzle"];
_unit [[forceWeaponFire]] ["IRGrenade","IRGrenade"];
_unit [[forceWeaponFire]] ["IRGrenade","IRGrenade"];
_unit [[forceWeaponFire]] ["Laserdesignator","Laserdesignator"];</code>|= EXAMPLE3
_unit [[forceWeaponFire]] ["Laserdesignator","Laserdesignator"];</code>|= Example 1
|x4= <code>[[gunner]] blackfoot [[forceWeaponFire]] ["gatling_20mm", "close"];</code>|= EXAMPLE4
 
|x2= <code>[[gunner]] blackfoot [[forceWeaponFire]] ["gatling_20mm", "close"];</code>|= Example 2
____________________________________________________________________________________________
____________________________________________________________________________________________


| [[currentWeapon]], [[currentWeaponMode]], [[setWeaponReloadingTime]], [[selectWeapon]], [[fire]], [[doFire]], [[commandFire]], [[canFire]], [[fireAtTarget]], [[commandArtilleryFire]], [[commandSuppressiveFire]], [[doArtilleryFire]], [[doSuppressiveFire]], [[isManualFire]], [[BIS_fnc_fire]]|= SEEALSO
| [[currentWeapon]], [[currentWeaponMode]], [[setWeaponReloadingTime]], [[selectWeapon]], [[fire]], [[doFire]], [[commandFire]], [[canFire]], [[fireAtTarget]], [[commandArtilleryFire]], [[commandSuppressiveFire]], [[doArtilleryFire]], [[doSuppressiveFire]], [[isManualFire]], [[BIS_fnc_fire]]|= See also
 
|  |= MPBEHAVIOUR
____________________________________________________________________________________________
____________________________________________________________________________________________
}}
}}
Line 50: Line 46:
<dl class='command_description'>
<dl class='command_description'>
<!-- Note Section BEGIN -->
<!-- Note Section BEGIN -->
<dd class="notedate">Posted on August 25, 2013
<dd class="notedate">Posted on August 25, 2013
<dt class="note">'''[[User:Killzone_Kid|Killzone_Kid]]'''
<dt class="note">[[User:Killzone_Kid|Killzone_Kid]]
<dd class="note">Here is a neat workaround trick for firemode change from a script:
<dd class="note">Here is a neat workaround trick for firemode change from a script:
<code>_weapon = [[currentWeapon]] [[player]];
<code>_weapon = [[currentWeapon]] [[player]];
Line 61: Line 58:
<dt class="note">[[User:ffur2007slx2_5|ffur2007slx2_5]]
<dt class="note">[[User:ffur2007slx2_5|ffur2007slx2_5]]
<dd class="note">(A3 1.16) [[forceWeaponFire]] is no longer only limited to units, but can remote aircrafts weapon firing as well. Passed source unit should be the correct one who controls the weapon, if passed mode is "this", use the weapon name instead:
<dd class="note">(A3 1.16) [[forceWeaponFire]] is no longer only limited to units, but can remote aircrafts weapon firing as well. Passed source unit should be the correct one who controls the weapon, if passed mode is "this", use the weapon name instead:
<code>
<code>_weapon = ([[weapons]] _veh) [[select]] 3;
_weapon = ([[weapons]] _veh) [[select]] 3;
_mode = ([[getArray]] ([[configFile]] >> "cfgweapons" >> _weapon >> "modes")) [[select]] 0;
_mode = ([[getArray]] ([[configFile]] >> "cfgweapons" >> _weapon >> "modes")) [[select]] 0;
[[if]] (_mode == "this") [[then]] {_mode = _weapon;};
[[if]] (_mode == "this") [[then]] {_mode = _weapon;};
Line 71: Line 67:


<dd class="notedate">Posted on September 02, 2014
<dd class="notedate">Posted on September 02, 2014
<dt class="note">'''[[User:Benargee|Benargee]]'''
<dt class="note">[[User:Benargee|Benargee]]
<dd class="note">
<dd class="note">
Similar to Killzone Kid's note, This fires the units current weapon in its current firemode.
Similar to Killzone Kid's note, This fires the units current weapon in its current firemode.
<code>_unit [[forceWeaponFire]] [ [[weaponState]] _unit [[select]] 1, [[weaponState]] _unit [[select]] 2];</code>
<code>_unit [[forceWeaponFire]] <nowiki>[</nowiki>[[weaponState]] _unit [[select]] 1, [[weaponState]] _unit [[select]] 2];</code>
<!-- Note Section END -->
</dl>


<h3 style='display:none'>Bottom Section</h3>
[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on January 3, 2015 - 14:55 (UTC)</dd>
<dd class="notedate">Posted on January 3, 2015 - 14:55 (UTC)</dd>
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
Line 91: Line 78:
[[fire]] command can also be used to fire vehicle weapon, like smoke launcher for example: <code>[[vehicle]] [[player]] [[fire]] "SmokeLauncher";</code> And if this doesn't work, it is possible to force fire via action <code>tank [[action]] ["UseWeapon", tank, [[commander]] tank, 0];</code>
[[fire]] command can also be used to fire vehicle weapon, like smoke launcher for example: <code>[[vehicle]] [[player]] [[fire]] "SmokeLauncher";</code> And if this doesn't work, it is possible to force fire via action <code>tank [[action]] ["UseWeapon", tank, [[commander]] tank, 0];</code>
</dd>
</dd>
<!-- Note Section END -->
</dl>
</dl>
<!-- DISCONTINUE Notes -->
 
<h3 style='display:none'>Bottom Section</h3>
[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Revision as of 12:24, 29 March 2018

Arma 3 logo black.png0.50
LALocalGEGlobal
Hover & click on the images for description

Description

Description:
The unit will be forced to fire weapon from the given muzzle. The weapon will not fire if firemode passed as parameter is not supported by the given muzzle. The muzzle could belong to a vehicle weapon and unit in this case will be the unit operating this weapon. Doesnt't seem to work for units in FFV positions. Works on player. See also: BIS_fnc_fire
Groups:
Uncategorised

Syntax

Syntax:
unit forceWeaponFire [muzzle, firemode]
Parameters:
unit: Object - unit alone or in vehicle
muzzle: String
firemode: String - Common options are "Single", "Burst", "FullAuto". For the full list of a weapon firemodes: hint str (getArray (configFile >> "CfgWeapons" >> currentWeapon player >> "modes")); If modes[] param in config for the weapon says {"this"}, then the same classname as for the weapon param (currentWeapon player) should be used as firemode param.
Return Value:
Nothing

Examples

Example 1:
_unit forceWeaponFire ["arifle_MX_F", "Single"]; _unit forceWeaponFire ["hgun_ACPC2_F", "hgun_ACPC2_F"]; _unit forceWeaponFire ["HandGrenadeMuzzle","HandGrenadeMuzzle"]; _unit forceWeaponFire ["MiniGrenadeMuzzle","MiniGrenadeMuzzle"]; _unit forceWeaponFire ["HandGrenade_Stone","HandGrenade_Stone"]; _unit forceWeaponFire ["SmokeShellMuzzle","SmokeShellMuzzle"]; _unit forceWeaponFire ["ChemlightGreenMuzzle","ChemlightGreenMuzzle"]; _unit forceWeaponFire ["IRGrenade","IRGrenade"]; _unit forceWeaponFire ["Laserdesignator","Laserdesignator"];
Example 2:
gunner blackfoot forceWeaponFire ["gatling_20mm", "close"];

Additional Information

See also:
currentWeaponcurrentWeaponModesetWeaponReloadingTimeselectWeaponfiredoFirecommandFirecanFirefireAtTargetcommandArtilleryFirecommandSuppressiveFiredoArtilleryFiredoSuppressiveFireisManualFireBIS_fnc_fire

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

Notes

Posted on August 25, 2013
Killzone_Kid
Here is a neat workaround trick for firemode change from a script: _weapon = currentWeapon player; _ammo = player ammo _weapon; player setAmmo [_weapon, 0]; player forceWeaponFire [_weapon, "FullAuto"]; player setAmmo [_weapon, _ammo];
Posted on April 14, 2014
ffur2007slx2_5
(A3 1.16) forceWeaponFire is no longer only limited to units, but can remote aircrafts weapon firing as well. Passed source unit should be the correct one who controls the weapon, if passed mode is "this", use the weapon name instead: _weapon = (weapons _veh) select 3; _mode = (getArray (configFile >> "cfgweapons" >> _weapon >> "modes")) select 0; if (_mode == "this") then {_mode = _weapon;}; (driver _veh) forceWeaponFire [_weapon, _mode]; //Force a CAS fire a rocket. Currently this command is not available for land vehicle remote fire.
Posted on September 02, 2014
Benargee
Similar to Killzone Kid's note, This fires the units current weapon in its current firemode. _unit forceWeaponFire [weaponState _unit select 1, weaponState _unit select 2];
Posted on January 3, 2015 - 14:55 (UTC)
Killzone Kid
fireAtTarget command can be used to force fire gunner weapon in vehicles. A gunner must be present. _veh fireAtTarget [objNull]; Will fire one shot even if player is gunner. fire command can also be used to fire vehicle weapon, like smoke launcher for example: vehicle player fire "SmokeLauncher"; And if this doesn't work, it is possible to force fire via action tank action ["UseWeapon", tank, commander tank, 0];

Bottom Section

Retrieved from "https://community.bistudio.com/wiki?title=forceWeaponFire&oldid=106365"