setBehaviour: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " *\| *([Cc]omments|COMMENTS|Game|[Gg]ame [Nn]ame( +[0-9])?|Game [Vv]ersion( +[0-9])?|Game Version \(number surrounded by NO SPACES\)|Arguments in MP|MP[Aa]rg|Multiplayer Arguments( \("local" or "global"\))?|Effects|Execution|Effects...)
m (Text replacement - "{{Feature | Important | " to "{{Feature|important|")
 
(39 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Command
{{RV|type=command


| ofp
|game1= ofp
|version1= 1.00


|1.00
|game2= ofpe
|version2= 1.00
 
|game3= arma1
|version3= 1.00
 
|game4= arma2
|version4= 1.00
 
|game5= arma2oa
|version5= 1.50
 
|game6= tkoh
|version6= 1.00
 
|game7= arma3
|version7= 0.50


|arg= local
|arg= local
Line 11: Line 28:
|gr1= Groups
|gr1= Groups


| Sets group behaviour mode. If a unit is given as argument, behaviour is set for the unit's group. Behaviour is one of:  
|gr2= AI Behaviour
 
|descr= Sets individual unit behaviour '''on every unit in a group'''.
{{Feature|important|This command doesn't set AI [[Group]] behaviour, see [[setCombatBehaviour]] or [[setBehaviourStrong]] for this.}}
{{Feature|informative|See [[AI Behaviour]] for details of the effect of this command on AI units.}}
<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= groupOrUnit [[setBehaviour]] behaviour
 
|p1= groupOrUnit : [[Group]] or [[Object]] - unit or a [[group]]
 
|p2= behaviour: [[String]] - can be one of:
* "CARELESS"
* "CARELESS"
* "SAFE"
* "SAFE"
* "AWARE"
* "AWARE"
* "COMBAT"
* "COMBAT"
* "STEALTH".
* "STEALTH"
{{Informative | See [[AI Behaviour]] for details of the effect of this command on AI units.}}


| groupName [[setBehaviour]] behaviour
|r1= [[Nothing]]


|p1= groupName: [[Group]] or [[Object]] - unit from the group
|x1= <sqf>_group1 setBehaviour "SAFE";</sqf>


|p2= behaviour: [[String]]
|seealso= [[setCombatBehaviour]] [[combatBehaviour]] [[AIBehaviour]] [[behaviour]] [[setBehaviourStrong]] [[setWaypointBehaviour]] [[combatMode]] [[setCombatMode]] [[skill]] [[setSkill]] [[Arma 3: AI Skill]]
}}


| [[Nothing]]
{{Note
 
|user= SNKMAN
|x1= <code>_group1 [[setBehaviour]] "SAFE";</code>
|timestamp= 20090103155700
|text= Warning! Since {{arma1}} v.1.14 the command setBehaviour "COMBAT" does not work correctly any longer.
Units ( Groups ) which are using this behaviour and then get a move order will not move to the given position.
}}


| [[Mission_Editor:_Waypoints#Behaviour|behaviour description]], [[AIBehaviour]], [[behaviour]],[[setBehaviourStrong]] [[setWaypointBehaviour]], [[combatMode]], [[setCombatMode]], [[skill]], [[setSkill]], [[Arma 3 AI Skill]]
{{Note
|user= MadRussian
|timestamp= 20100214081900
|text=  Although setBehaviour can be called on an individual unit, the entire group will be affected.
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= MulleDK13
<!-- Note Section BEGIN -->
|timestamp= 20101122191800
 
|text= If setting a behaviour on an individual unit is required, it can be achieved by creating a temporary group, use joinSilent to make the individual unit belong to that group, then change his behaviour, use joinSilent into the original group, then delete the temporary group.
 
}}
<dd class="notedate">
<dt class="note">[[User:=\SNKMAN/=|=\SNKMAN/=]]
<dd class="note">Warning! Since ArmA v.1.14 the command setBehaviour "COMBAT" do not work correctly any loger.
Units ( Groups ) which are using this behaviour and then get a move order, will not move to the given position.
 
 
<dd class="notedate">
<dt class="note">[[User:MadRussian|MadRussian]]
<dd class="note">Although setBehaviour can be called on an individual unit, the entire group will be affected.
 
 
<dd class="notedate">
<dt class="note">[[User:MulleDK13|MulleDK13]]
<dd class="note">If setting a behaviour on an individual unit is required, it can be achieved by creating a temporary group, use joinSilent to make the individual unit belong to that group, then change his behaviour, use joinSilent into the original group, then delete the temporary group.
 
<!-- Note Section END -->
</dl>
 
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.46|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
{{GameCategory|arma1|Scripting Commands}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}

Latest revision as of 21:46, 16 May 2024

Hover & click on the images for description

Description

Description:
Sets individual unit behaviour on every unit in a group.
This command doesn't set AI Group behaviour, see setCombatBehaviour or setBehaviourStrong for this.
See AI Behaviour for details of the effect of this command on AI units.
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)
Groups:
GroupsAI Behaviour

Syntax

Syntax:
groupOrUnit setBehaviour behaviour
Parameters:
groupOrUnit : Group or Object - unit or a group
behaviour: String - can be one of:
  • "CARELESS"
  • "SAFE"
  • "AWARE"
  • "COMBAT"
  • "STEALTH"
Return Value:
Nothing

Examples

Example 1:
_group1 setBehaviour "SAFE";

Additional Information

See also:
setCombatBehaviour combatBehaviour AIBehaviour behaviour setBehaviourStrong setWaypointBehaviour combatMode setCombatMode skill setSkill Arma 3: AI Skill

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
SNKMAN - c
Posted on Jan 03, 2009 - 15:57 (UTC)
Warning! Since Armed Assault v.1.14 the command setBehaviour "COMBAT" does not work correctly any longer. Units ( Groups ) which are using this behaviour and then get a move order will not move to the given position.
MadRussian - c
Posted on Feb 14, 2010 - 08:19 (UTC)
Although setBehaviour can be called on an individual unit, the entire group will be affected.
MulleDK13 - c
Posted on Nov 22, 2010 - 19:18 (UTC)
If setting a behaviour on an individual unit is required, it can be achieved by creating a temporary group, use joinSilent to make the individual unit belong to that group, then change his behaviour, use joinSilent into the original group, then delete the temporary group.