Difference between revisions of "setCombatBehaviour"

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\|seealso= *\[\[([^ ]+)\]\], \[\[([^ ]+)\]\]" to "|seealso= $1 $2")
m
 
(9 intermediate revisions by 4 users not shown)
Line 8: Line 8:
 
|eff= global
 
|eff= global
  
|gr1= Object Manipulation
+
|gr1= AI Behaviour
 +
 
 
|gr2= Groups
 
|gr2= Groups
  
|descr= Sets an individual unit behaviour (main syntax) or a whole group behaviour (alternative syntax). To retrieve unit or group behaviour see [[combatBehaviour]]. The behaviour is one of:  
+
|descr= Sets an individual unit entity behaviour (main syntax) or a group entity behaviour (alternative syntax). The group in this case is a [[Group]] entity and not a simple collection of units. To retrieve unit or group behaviour see [[combatBehaviour]]. The behaviour is one of:  
 
* "CARELESS"
 
* "CARELESS"
 
* "SAFE"
 
* "SAFE"
Line 17: Line 18:
 
* "COMBAT"
 
* "COMBAT"
 
* "STEALTH"
 
* "STEALTH"
{{Feature | Informative | See [[AI Behaviour]] for details of the effect of this command on AI units. Group behaviour usually is "CARELESS" or "SAFE"}}
+
{{Feature|informative|See [[AI Behaviour]] for details of the effect of this command on AI units. Group behaviour usually is "CARELESS" or "SAFE"}}
 +
 
 +
<spoiler text="Comparison of Behaviour commands">
 +
{| class="wikitable" style="text-align: center"
 +
! Command
 +
! Applies To
 +
|-
 +
| [[setBehaviour]]
 +
| '''Every unit''' in the group, but '''not the group''' itself
 +
|-
 +
| [[setBehaviourStrong]]
 +
| '''Every unit''' in the group, and the '''group''' itself
 +
|-
 +
| [[setCombatBehaviour]]
 +
| If argument is [[Object]], only that '''unit''', and if argument is [[Group]], the '''group''' itself (not its units)
 +
|}
 +
</spoiler>
  
 
|s1= unit [[setCombatBehaviour]] behaviour
 
|s1= unit [[setCombatBehaviour]] behaviour
Line 35: Line 52:
 
|r2= [[Nothing]]
 
|r2= [[Nothing]]
  
|x1= <code>unit1 [[setCombatBehaviour]] "SAFE";</code>
+
|x1= <sqf>unit1 setCombatBehaviour "SAFE";</sqf>
  
|x2= <code>group1 [[setCombatBehaviour]] "CARELESS";</code>
+
|x2= <sqf>group1 setCombatBehaviour "CARELESS";</sqf>
  
|seealso= [[AIBehaviour]] [[combatBehaviour]] [[behaviour]] [[setBehaviour]] [[setBehaviourStrong]] [[setWaypointBehaviour]], [[combatMode]], [[setCombatMode]], [[skill]], [[setSkill]]
+
|seealso= [[AIBehaviour]] [[combatBehaviour]] [[behaviour]] [[setBehaviour]] [[setBehaviourStrong]] [[setWaypointBehaviour]] [[combatMode]] [[setCombatMode]] [[skill]] [[setSkill]]
 
}}
 
}}

Latest revision as of 12:02, 22 May 2022

Hover & click on the images for description

Description

Description:
Sets an individual unit entity behaviour (main syntax) or a group entity behaviour (alternative syntax). The group in this case is a Group entity and not a simple collection of units. To retrieve unit or group behaviour see combatBehaviour. The behaviour is one of:
  • "CARELESS"
  • "SAFE"
  • "AWARE"
  • "COMBAT"
  • "STEALTH"
See AI Behaviour for details of the effect of this command on AI units. Group behaviour usually is "CARELESS" or "SAFE"

Comparison of Behaviour commands

Groups:
AI BehaviourGroups

Syntax

Syntax:
unit setCombatBehaviour behaviour
Parameters:
unit: Object - AI unit
behaviour: String - see description
Return Value:
Nothing

Alternative Syntax

Syntax:
group setCombatBehaviour behaviour
Parameters:
group: Group - AI group
behaviour: String - see description
Return Value:
Nothing

Examples

Example 1:
unit1 setCombatBehaviour "SAFE";
Example 2:
group1 setCombatBehaviour "CARELESS";

Additional Information

See also:
AIBehaviour combatBehaviour behaviour setBehaviour setBehaviourStrong setWaypointBehaviour combatMode setCombatMode skill setSkill

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