setCombatMode

From Bohemia Interactive Community
Revision as of 15:33, 8 November 2023 by Lou Montana (talk | contribs) (Text replacement - "(\|[pr][0-9]+ *= *[^- ]*) *- *I([a-z ])" to "$1 - i$2")
Jump to navigation Jump to search
Hover & click on the images for description

Description

Description:
Sets AI group combat mode (engagement rules). For individual unit's combat mode see setUnitCombatMode. Mode may be one of the following:
  • "BLUE" : Never fire, keep formation
  • "GREEN" : Hold fire, keep formation
  • "WHITE" : Hold fire, engage at will/loose formation
  • "YELLOW" : Fire at will, keep formation
  • "RED" : Fire at will, engage at will/loose formation
See Combat Modes for more information on combat modes.
Groups:
GroupsAI Behaviour

Syntax

Syntax:
group setCombatMode mode
Parameters:
group: Group or Object - if the argument is unit Object, unit's current group is used.
mode: String - See description
Return Value:
Nothing

Examples

Example 1:
_group1 setCombatMode "BLUE";

Additional Information

See also:
Combat Modes Use in Waypoints combatMode behaviour setBehaviour skill setSkill Arma 3 AI Skill setUnitCombatMode unitCombatMode setCombatBehaviour combatBehaviour

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


Posted on 2020-01-01 - 07:35 (UTC)
.kju
  • Combat mode can only be changed via scripting/waypoints - not by player radio commands for an AI group.

  • "Engage at will" means AI can form subgroups and break off to engage known or assigned enemies. These AI will then act largely on their own.
  • As player one can use the "engage at will" radio command to achieve the same/similar behavior. However this will not change the unit's combat mode. Yet one can override the "keep/loose formation" status of combat mode with radio commands.

  • "Never fire" means AI will actually never fire. Whereas under "Hold fire", AI will shoot back if getting fired upon, hostiles get too close, or they get a target explicitly assigned by the (sub)group leader.
  • As player one can override the fire status with radio commands ("Hold fire", "Open fire", "Fire"). However this will not change the unit's combat mode.
  • "Never fire"/combat mode blue cannot be overridden by group leader target assignment. One needs to command "Open fire" or switch to a different combat mode (with "Hold fire") to be able to do so.

  • Applying combat mode blue, clears the attack target commands from AI subgroups. Might be useful in combination with doFollow/commandFollow. Note: It will not effect assignedTargets.