fireAtTarget: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<!-- Note Section [A-Z]+ --> " to "")
m (Text replacement - "↵↵</sqf>" to " </sqf>")
 
(62 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma2oa
|game1= arma2oa
|version1= 1.50


|1.51
|game2= tkoh
|version2= 1.00
 
|game3= arma3
|version3= 0.50


|gr1= Unit Control
|gr1= Unit Control
Line 9: Line 14:
|gr2= Weapons
|gr2= Weapons


| Remotely forces a unit to fire the given weapon. See also: [[BIS_fnc_fire]]
|descr= Remotely forces a unit to fire the given weapon. See also [[BIS_fnc_fire]].


| sourceVehicle '''fireAtTarget''' [targetVehicle, weaponMuzzleName]
|s1= sourceVehicle [[fireAtTarget]] [targetVehicle, weaponMuzzleName]


|p1= sourceVehicle: [[Object]] - source vehicle to fire from
|p1= sourceVehicle: [[Object]] - source vehicle to fire from
|p2= [targetVehicle, weaponMuzzleName]: [[Array]]
|p3= targetVehicle: [[Object]] - target vehicle to fire at
|p4= weaponMuzzleName (Optional): [[String]] - weapon muzzle classname, optional parameter


| [[Boolean]] - [[true]] if fired, [[false]] if not
|p2= targetVehicle: [[Object]] - target vehicle to fire at
 
 
|x1= <code>_handle = this [[fireAtTarget]] [groundtarget1,"HellfireLauncher"];</code>
|p3= weaponMuzzleName: [[String]] - (Optional) weapon muzzle classname, optional parameter
|x2= <code>_handle = Igla_AA_pod_TK_EP1 [[fireAtTarget]] [_helicopter,[[currentWeapon]] Igla_AA_pod_TK_EP1];</code>
 
|x3= <code>_handle = Igla_AA_pod_TK_EP1 [[fireAtTarget]] [helicopter];</code>
|r1= [[Boolean]] - [[true]] if fired, [[false]] if not
 
|x1= <sqf>_handle = this fireAtTarget [groundtarget1, "HellfireLauncher"];</sqf>
 
|x2= <sqf>_handle = Igla_AA_pod_TK_EP1 fireAtTarget [_helicopter, currentWeapon Igla_AA_pod_TK_EP1];</sqf>
 
|x3= <sqf>_handle = Igla_AA_pod_TK_EP1 fireAtTarget [helicopter];</sqf>
 
|seealso= [[fire]] [[doFire]] [[commandFire]] [[canFire]] [[forceWeaponFire]] [[commandArtilleryFire]] [[commandSuppressiveFire]] [[doArtilleryFire]] [[doSuppressiveFire]] [[isManualFire]] [[aimedAtTarget]] [[BIS_fnc_fire]]
}}


|seealso= [[fire]], [[doFire]], [[commandFire]], [[canFire]], [[forceWeaponFire]], [[commandArtilleryFire]], [[commandSuppressiveFire]], [[doArtilleryFire]], [[doSuppressiveFire]], [[isManualFire]], [[aimedAtTarget]], [[BIS_fnc_fire]]
{{Note
|user= Dwarden
|timestamp= 20100916081700
|text= Most likely only for missiles and for interaction with player only.
}}
}}


<dl class="command_description">
{{Note
<dd class="notedate">Posted on Sep 16, 2010 - 08:17</dd>
|user= ffur2007slx2_5
<dt class="note">[[User:Dwarden|Dwarden]]<dd class="note">
|timestamp= 20140408165000
Most likely only for missiles and for interaction with player only.
|text= ({{arma3}} 1.14) Source vehicle is only limited to manned vehicle while any other types won’t be able to active [[fireAtTarget]] handle, e.g.
<dd class="notedate">Posted on Apr 8, 2014 - 16:50</dd>
<sqf>
<dt class="note">[[User:ffur2007slx2_5|ffur2007slx2_5]]<dd class="note">
_handle = _infantryUnit fireAtTarget [_infantryTarget, weapons _infantryUnit select 0];
(A3 1.14) Source vehicle is only limited to manned vehicle while any other types won’t be able to active [[fireAtTarget]] handle, e.g.
// false & no bullet shoot
<code>_handle = _InfantryUnit [[fireAtTarget]] [_Infnatrytarget,([[weapons]] _Infantryunit [[select]] 0)];  
</sqf>
//false & no bullet shoot
</code>
Target has no limitation and can be any object:
Target has no limitation and can be any object:
<code>_handle = ([[vehicle]] _veh) [[fireAtTarget]] [ObjNull,([[weapons]] ([[vehicle]] _veh) [[select]] 0)];  
<sqf>
//true & a bullet shoot
_handle = (vehicle _veh) fireAtTarget [objNull, weapons (vehicle _veh) select 0];
</code>
// true & a bullet shoot
</sqf>
Handle returns false if weapon class name is inaccurate, e.g.
Handle returns false if weapon class name is inaccurate, e.g.
<code>_Handle = ([[vehicle]] _veh) [[fireAtTarget]] [ObjNull,”UnknownWeapon”];
<sqf>
//false & no bullet shoot.
_handle = (vehicle _veh) fireAtTarget [ObjNull, "UnknownWeapon"];
</code>
// false & no bullet shoot
</sqf>
Handle still returns true even though the vehicle is unavailable to shoot any bullet:
Handle still returns true even though the vehicle is unavailable to shoot any bullet:
<code>_weapon = [[weapons]] ([[vehicle]] _veh) [[select]] 0;
<sqf>
([[vehicle]] _veh) [[setAmmo]] [_weapon,0];
_weapon = weapons (vehicle _veh) select 0;
_Handle = ([[vehicle]] _veh) [[fireAtTarget]] [ObjNull,_weapon];
(vehicle _veh) setAmmo [_weapon, 0];
//true & no bullet shoot
_handle = (vehicle _veh) fireAtTarget [objNull, _weapon];
</code>
// true & no bullet shoot
=== difference ===
</sqf>
{| class="wikitable sortable"
 
=== Difference ===
 
{{{!}} class="wikitable sortable"


! command
! command
Line 60: Line 77:
! Workaround templets
! Workaround templets


|-
{{!}}-
| [[fire]]
{{!}} [[fire]]
| Either Unit or manned vehicle
{{!}} Either unit or manned vehicle
| N/A
{{!}} {{n/a}}
| Fired aiming at air for infantry rifle
{{!}} Fired aiming at air for infantry rifle
| Together with [[selectWeapon]],
{{!}} Together with [[selectWeapon]],
suggested to work with "throw","put" weapon type
suggested to work with "throw","put" weapon type
for infantry, or vehicle entity indeed.
for infantry, or vehicle entity indeed.


|-
{{!}}-
| [[fireAtTarget]]
{{!}} [[fireAtTarget]]
| Manned vehicle only
{{!}} Manned vehicle only
| Any object
{{!}} Any object
| Normal shoot, won’t aim at target automatically
{{!}} Normal shoot, won’t aim at target automatically
| _veh [[doWatch]] _target;
{{!}}
[[waitUntil]] {_veh [[aimedAtTarget]] [_target] > 0};
<sqf>
_veh [[fireAtTarget]] [_target];
_veh doWatch _target;
waitUntil { _veh aimedAtTarget [_target] > 0 };
_veh fireAtTarget [_target];
</sqf>


|-
{{!}}-
| [[forceWeaponFire]]
{{!}} [[forceWeaponFire]]
| Either Unit or manned aircraft (weapon operator)
{{!}} Either unit or manned aircraft (weapon operator)
| N/A
{{!}} {{n/a}}
| Normal shoot, can change fire mode
{{!}} Normal shoot, can change fire mode
| //E.g. unit won't shoot until he is facing the target.
{{!}}
  _unit [[doWatch]] _tar;
<sqf>
  [[waitUntil]] {
// e.g. unit won't shoot until he is facing the target
    _dir = [[direction]] _unit;
_unit doWatch _tar;
    _relative = [_unit,_tar] [[call]] [[BIS_fnc_relativeDirTo]];
waitUntil {
    [[if]] (_dir == _relative) [[exitWith]] {
_dir = direction _unit;
      _unit [[forceWeaponFire]] [<nowiki/>[[currentWeapon]] _unit,"single"];
_relative = [_unit,_tar] call BIS_fnc_relativeDirTo;
    };
if (_dir == _relative) exitWith {
    [[false]]
_unit forceWeaponFire [currentWeapon _unit, "single"];
  };
};
false
};
</sqf>
{{!}}-
{{!}} [[doFire]]
{{!}} Unit only
{{!}} Either unit or vehicle
{{!}} automatic aiming and shooting
{{!}} No special example.


|-
{{!}}-
| [[doFire]]
{{!}} [[commandFire]]
| Unit only
{{!}} Unit only
| Either unit or vehicle
{{!}} Either unit or vehicle
| automatic aiming and shooting
{{!}} automatic aiming and shooting
| No special example.
{{!}} No special example.


|-
{{!}}-
| [[commandFire]]
{{!}} [[Arma 3: Actions#USEWEAPON{{!}}action ["UseWeapon"]]]
| Unit only
{{!}} Either unit or manned vehicle  
| Either unit or vehicle
{{!}} {{n/a}}
| automatic aiming and shooting
{{!}} unexpected behavior
| No special example.
{{!}} {{n/a}}


|-
{{!}}}
| [[ArmA:_Actions#USEWEAPON|action ["UseWeapon"]]]
|game= arma3
| Either unit or manned vehicle
|version= 1.14
| N/A
}}
| unexpected behavior
| N/A
 
|}
</dl>
 
 
[[Category:Arma 2: Operation Arrowhead: New Scripting Commands|{{uc:{{PAGENAME}}}}]]
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 19:48, 3 September 2024

Hover & click on the images for description

Description

Description:
Remotely forces a unit to fire the given weapon. See also BIS_fnc_fire.
Groups:
Unit ControlWeapons

Syntax

Syntax:
sourceVehicle fireAtTarget [targetVehicle, weaponMuzzleName]
Parameters:
sourceVehicle: Object - source vehicle to fire from
targetVehicle: Object - target vehicle to fire at
weaponMuzzleName: String - (Optional) weapon muzzle classname, optional parameter
Return Value:
Boolean - true if fired, false if not

Examples

Example 1:
_handle = this fireAtTarget [groundtarget1, "HellfireLauncher"];
Example 2:
_handle = Igla_AA_pod_TK_EP1 fireAtTarget [_helicopter, currentWeapon Igla_AA_pod_TK_EP1];
Example 3:
_handle = Igla_AA_pod_TK_EP1 fireAtTarget [helicopter];

Additional Information

See also:
fire doFire commandFire canFire forceWeaponFire commandArtilleryFire commandSuppressiveFire doArtilleryFire doSuppressiveFire isManualFire aimedAtTarget BIS_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
Dwarden - c
Posted on Sep 16, 2010 - 08:17 (UTC)
Most likely only for missiles and for interaction with player only.
ffur2007slx2_5 - c
Posted on Apr 08, 2014 - 16:50 (UTC)

(Arma 3 1.14) Source vehicle is only limited to manned vehicle while any other types won’t be able to active fireAtTarget handle, e.g.

_handle = _infantryUnit fireAtTarget [_infantryTarget, weapons _infantryUnit select 0]; // false & no bullet shoot
Target has no limitation and can be any object:
_handle = (vehicle _veh) fireAtTarget [objNull, weapons (vehicle _veh) select 0]; // true & a bullet shoot
Handle returns false if weapon class name is inaccurate, e.g.
_handle = (vehicle _veh) fireAtTarget [ObjNull, "UnknownWeapon"]; // false & no bullet shoot
Handle still returns true even though the vehicle is unavailable to shoot any bullet:
_weapon = weapons (vehicle _veh) select 0; (vehicle _veh) setAmmo [_weapon, 0]; _handle = (vehicle _veh) fireAtTarget [objNull, _weapon]; // true & no bullet shoot

Difference

command Source Target Behavior Workaround templets
fire Either unit or manned vehicle N/A Fired aiming at air for infantry rifle Together with selectWeapon,

suggested to work with "throw","put" weapon type for infantry, or vehicle entity indeed.

fireAtTarget Manned vehicle only Any object Normal shoot, won’t aim at target automatically

_veh doWatch _target; waitUntil { _veh aimedAtTarget [_target] > 0 }; _veh fireAtTarget [_target];

forceWeaponFire Either unit or manned aircraft (weapon operator) N/A Normal shoot, can change fire mode

// e.g. unit won't shoot until he is facing the target _unit doWatch _tar; waitUntil { _dir = direction _unit; _relative = [_unit,_tar] call BIS_fnc_relativeDirTo; if (_dir == _relative) exitWith { _unit forceWeaponFire [currentWeapon _unit, "single"]; }; false };

doFire Unit only Either unit or vehicle automatic aiming and shooting No special example.
commandFire Unit only Either unit or vehicle automatic aiming and shooting No special example.
action ["UseWeapon"] Either unit or manned vehicle N/A unexpected behavior N/A