setMissileTarget: Difference between revisions

From Bohemia Interactive Community
No edit summary
m (Some wiki formatting)
 
(40 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Command|=
{{RV|type=command
____________________________________________________________________________________________


| arma3 |Game=
|game1= arma3
|version1= 1.92


|1.92|Game Version =(number surrounded by NO SPACES)
|gr1= Object Manipulation


|arg= |Multiplayer Arguments =("local" or "global")
|gr2= Weapons


|eff= |Multiplayer Effects =("local" or "global")
|descr= Sets a guided missile target. Does not work for all types of missiles. If the target is dead, it is ignored. The target has to be inside the missile's configured targeting cone for the command to work.


|exec= |Multiplayer Execution =("server" or empty)
|s1= munition [[setMissileTarget]] target
____________________________________________________________________________________________


| Sets a guided missile's target. |Description=
|p1= munition: [[Object]] - missile
____________________________________________________________________________________________


| munition setMissileTarget target |Syntax=
|p2= target: [[Object]] - valid missile target or [[objNull]] to cancel targeting


|p1= munition: [[Object]]
|r1= [[Boolean]] - [[true]] if successful


|p2= target: [[Object]]
|s2= munition [[setMissileTarget]] [target, force]
|s2since= arma3 2.18


| [[Boolean]] - true if succeeded to set |Return Value=
|p21= munition: [[Object]] - missile
____________________________________________________________________________________________


|x1= <code>missile1 [[setMissileTarget]] tgt</code> |Example 1=
|p22= target: [[Object]] - valid missile target or [[objNull]] to cancel targeting
____________________________________________________________________________________________
|p23= force: [[Boolean]] - [[true]] to force target (for example to target countermeasure flare object)
|r2= [[Boolean]] - [[true]] if successful


|mp= - |Multiplayer Behaviour=
|x1= <sqf>missile1 setMissileTarget tank1;</sqf>


| [[missileTargetPos]] [[setMissileTargetPos]] [[missileTarget]] |See Also=
|x2= <sqf>
}}
private _missile = createVehicle ["Missile_AGM_01_F", player modelToWorld [0,0,50], [], 0, "CAN_COLLIDE"];
_missile setDir getDir player;
private _target = createVehicle ["O_APC_Wheeled_02_rcws_v2_F", player modelToWorld [0,300,0], [], 0, "CAN_COLLIDE"];
_target setVehicleTiPars [1, 1, 1];
[_missile, _target] spawn {
params ["_missile", "_target"];
sleep 0.1;
_missile setMissileTarget _target;
};
</sqf>


<dl class="command_description">
|x3= <sqf>_missile setMissileTarget objNull; // cancels targeting</sqf>
<!-- BEGIN Note Section -->
<!-- For example:
<dd class="notedate">Posted on Month Day, Year - Time (UTC)</dd>
<dt class="note">'''[[User:User Name|User Name]]'''</dt>
<dd class="note">This is an example note. It is true and verifiable, and contains a little code snippet.
<code>[[if]] ([[_this]] == anExample) [[then]] { [[hint]] "Leave it here for others to read"; };</code></dd>
-->
<!-- END Note Section -->
</dl>


<h3 style="display:none">Bottom Section</h3>
|x4= <sqf>_missile setMissileTarget [flare1, true];</sqf>
<!-- Appropriate categories go here -->


[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
|seealso= [[missileTargetPos]] [[setMissileTargetPos]] [[missileTarget]] [[missileState]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
}}

Latest revision as of 00:04, 23 May 2025

Hover & click on the images for description

Description

Description:
Sets a guided missile target. Does not work for all types of missiles. If the target is dead, it is ignored. The target has to be inside the missile's configured targeting cone for the command to work.
Groups:
Object ManipulationWeapons

Syntax

Syntax:
munition setMissileTarget target
Parameters:
munition: Object - missile
target: Object - valid missile target or objNull to cancel targeting
Return Value:
Boolean - true if successful

Alternative Syntax

Syntax:
munition setMissileTarget [target, force]
Parameters:
munition: Object - missile
target: Object - valid missile target or objNull to cancel targeting
force: Boolean - true to force target (for example to target countermeasure flare object)
Return Value:
Boolean - true if successful

Examples

Example 1:
missile1 setMissileTarget tank1;
Example 2:
private _missile = createVehicle ["Missile_AGM_01_F", player modelToWorld [0,0,50], [], 0, "CAN_COLLIDE"]; _missile setDir getDir player; private _target = createVehicle ["O_APC_Wheeled_02_rcws_v2_F", player modelToWorld [0,300,0], [], 0, "CAN_COLLIDE"]; _target setVehicleTiPars [1, 1, 1]; [_missile, _target] spawn { params ["_missile", "_target"]; sleep 0.1; _missile setMissileTarget _target; };
Example 3:
_missile setMissileTarget objNull; // cancels targeting
Example 4:
_missile setMissileTarget [flare1, true];

Additional Information

See also:
missileTargetPos setMissileTargetPos missileTarget missileState

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