setUnitTrait: Difference between revisions

Latest revision as of 17:34, 8 October 2024

Hover & click on the images for description

Description

Description:

Enables or disables a trait or alters a trait of the given unit. Unit traits consist of unit abilities, which are Booleans and modifiers, which are Numbers. Custom trait can only be a bool.

Abilities:

Boolean engineer - Ability to partially repair vehicles with toolkit, equivalent to engineer = 1; in CfgVehicles
Boolean explosiveSpecialist - Ability to defuse mines with toolkit, equivalent to canDeactivateMines = 1; in CfgVehicles
Boolean medic - Ability to treat self and others with medikit, equivalent to attendant = 1; in CfgVehicles
Boolean UAVHacker - Ability to hack enemy and friendly drones, equivalent to uavHacker = 1; in CfgVehicles

Modifiers:

Number audibleCoef - A lower value means the unit is harder to hear
Number camouflageCoef - A lower value means the unit is harder to spot
Number loadCoef - Equipment weight multiplier affecting fatigue and stamina

Groups:

Object Manipulation

Syntax

Syntax:: unit setUnitTrait [skillName, value, isCustom]
Parameters:: unit: Object - the unit whose trait should be set
: skillName: String - name of the skill
: value: Boolean or Number - value (see above)
: isCustom: Boolean - (Optional) Must be set to true in case of custom
Return Value:: Nothing

Examples

Example 1:: player setUnitTrait ["Medic", true];

Additional Information

See also:: getUnitTrait getAllUnitTraits

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 2016-04-27 - 18:12 (UTC)
R3vo: The higher the value for the loadCoef the less stamina a unit has. Negative values will dramatically increase the stamina actually to a point where it extends the stamina bar.

: Posted on 2017-10-20 - 05:49 (UTC)
Midnight: explosiveSpecialist trait can defuse mines (i.e. satchel charges), whilst the engineer trait alone cannot.

@@ Line 1: / Line 1: @@
 {{RV|type=command
-|arma3
-|1.58
+|game1= arma3
+|version1= 1.58
 |arg= local
 |eff= global
@@ Line 7: / Line 9: @@
 |gr1= Object Manipulation
-| Enables or disables a trait or alters a trait of the given unit. Custom trait can only be a [[Bool|bool]].<br><br>
+|descr= Enables or disables a trait or alters a trait of the given unit. Unit traits consist of unit abilities, which are [[Boolean]]s and modifiers, which are [[Number]]s. Custom trait can only be a [[Boolean|bool]].<br><br>
-Default traits are:
+Abilities:
-*[[Number]] '''audibleCoef''' - A lower value means the unit is harder to hear
+* [[Boolean]] '''engineer''' - Ability to partially repair vehicles with toolkit, equivalent to {{hl|c= engineer = 1;}} in [[CfgVehicles_Config_Reference|CfgVehicles]]
-*[[Number]] '''camouflageCoef''' - A lower value means the unit is harder to spot
+* [[Boolean]] '''explosiveSpecialist''' - Ability to defuse mines with toolkit, equivalent to {{hl|c= canDeactivateMines = 1;}} in CfgVehicles
-*[[Number]] '''loadCoef''' - Equipment weight multiplier affecting fatigue and stamina
+* [[Boolean]] '''medic''' - Ability to treat self and others with medikit, equivalent to {{hl|c= attendant = 1;}} in CfgVehicles
-*[[Boolean]] '''engineer''' - Ability to partially repair vehicles with toolkit, equivalent to <tt>engineer <nowiki>=</nowiki> 1;</tt> in [[CfgVehicles_Config_Reference|CfgVehicles]]
+* [[Boolean]] '''UAVHacker''' - Ability to hack enemy and friendly drones, equivalent to {{hl|c= uavHacker = 1;}} in CfgVehicles
-*[[Boolean]] '''explosiveSpecialist''' - Ability to defuse mines with toolkit, equivalent to <tt>canDeactivateMines <nowiki>=</nowiki> 1;</tt> in CfgVehicles
+Modifiers:
-*[[Boolean]] '''medic''' - Ability to treat self and others with medikit, equivalent to <tt>attendant <nowiki>=</nowiki> 1;</tt> in CfgVehicles
+* [[Number]] '''audibleCoef''' - A lower value means the unit is harder to hear
-*[[Boolean]] '''UAVHacker''' - Ability to hack drones, equivalent to <tt>uavHacker <nowiki>=</nowiki> 1;</tt> in CfgVehicles
+* [[Number]] '''camouflageCoef''' - A lower value means the unit is harder to spot
+* [[Number]] '''loadCoef''' - Equipment weight multiplier affecting fatigue and stamina
+|s1= unit [[setUnitTrait]] [skillName, value, isCustom]
+|p1= unit: [[Object]] - the unit whose trait should be set
+|p2= skillName: [[String]] - name of the skill
+|p3= value: [[Boolean]] or [[Number]] - value (see above)
-|unit [[setUnitTrait]] [skillName, value, isCustom]
+|p4= isCustom: [[Boolean]] - (Optional) Must be set to [[true]] in case of custom
-|p1= unit: [[Object]] - The unit whose trait should be set
-|p2= skillName: [[String]] - Name of the skill
+|r1= [[Nothing]]
-|p3= value: [[Boolean]] or [[Number]] - Value (see above)
-|p4= isCustom (optional): [[Boolean]] - Must be set to [[true]] in case of custom|= Param 4
+|x1= <sqf>player setUnitTrait ["Medic", true];</sqf>
-| Nothing
-|x1= <code>[[player]] [[setUnitTrait]] ["Medic",[[true]]];</code>
+|seealso= [[getUnitTrait]] [[getAllUnitTraits]]
-| [[getUnitTrait]] [[getAllUnitTraits]]
-|
 }}
@@ Line 31: / Line 40: @@
 <dt></dt>
-<dd class="notedate">Posted on April 27, 2016 - 18:12 (UTC)</dd>
+<dd class="notedate">Posted on 2016-04-27 - 18:12 (UTC)</dd>
 <dt class="note">[[User:R3vo|R3vo]]</dt>
 <dd class="note">
@@ Line 38: / Line 47: @@
 <dt><dt>
-<dd class="notedate">Posted on October 20, 2017 - 05:49 (UTC)</dd>
+<dd class="notedate">Posted on 2017-10-20 - 05:49 (UTC)</dd>
 <dt class="note">[[User:Midnight|Midnight]]</dt>
 <dd class="note">
 explosiveSpecialist trait can defuse mines (i.e. satchel charges), whilst the engineer trait alone cannot.
 </dd>
 </dl>