setDamage: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (formatting)
(28 intermediate revisions by 15 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{Command|Comments=
____________________________________________________________________________________________
____________________________________________________________________________________________


| ofp |= Game name
| ofp |Game name=


|1.5|= Game version
|1.5|Game version=
 
|eff= global|Multiplayer Effects=
 
|arg= global|Multiplayer Arguments=
____________________________________________________________________________________________
____________________________________________________________________________________________


| Damage / repair object. Damages or repairs the object. Damage 0 means fully functional, damage 1 means completely destroyed / dead. This function is identical to [[setDammage]]. It was introduced to fix a spelling error in original function name. |= Description
| Sets an object's damage value in the range 0..1, 0 meaning fully functional and 1 completely destroyed / dead.<br>
The alternative syntax allows to switch off destruction effects.<br><br>
Identical to [[setDammage]], typo aside. |DESCRIPTION=
____________________________________________________________________________________________
____________________________________________________________________________________________


| object '''setDamage''' damage |= Syntax
| object [[setDamage]] damage |SYNTAX=


|p1= object: [[Object]] |= Parameter 1
|p1= object: [[Object]] |PARAMETER1=


|p2= damage: [[Number]] |= Parameter 2
|p2= damage: [[Number]] |PARAMETER2=


| [[Nothing]] |= Return value
| [[Nothing]] |RETURNVALUE=
____________________________________________________________________________________________
 
|s2= object [[setDamage]] [damage, useEffects] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(''Since Arma 3 v1.67'')|SYNTAX2=
 
|p21= object: [[Object]] |PARAMETER21=
 
|p22= [damage, useEffects]: [[Array]] |PARAMETER22=
 
|p23= damage: [[Number]] |PARAMETER23=
 
|p24= useEffects: [[Boolean]] - [[false]] to skip destruction effects. Default: [[true]] |PARAMETER24=
 
|r2= [[Nothing]] |RETURNVALUE2=
____________________________________________________________________________________________
____________________________________________________________________________________________
   
   
|x1= <pre>soldier1 setDamage 1</pre> |= Example 1
|x1= <code>_soldier1 [[setDamage]] 1;</code> |EXAMPLE1=
____________________________________________________________________________________________


| [[setDammage]], [[damage]], [[getDammage]] |= See also
|x2= <code>_house1 [[setDamage]] [1, [[false]]];</code> |EXAMPLE2=
___________________________________________________________________________________________


| [[setDammage]], [[setVehicleArmor]], [[damage]], [[getDammage]], [[setHit]], [[getHit]], [[getHitIndex]], [[setHitIndex]], [[getHitPointDamage]], [[setHitPointDamage]] |SEEALSO=
}}
}}


Line 30: Line 50:
<!-- Note Section BEGIN -->
<!-- Note Section BEGIN -->


<dd class="notedate">
 
<dt class="note">[[User:Ceeeb|Ceeeb]]
<dd class="notedate"></dd>
<dt class="note">'''[[User:Ceeeb|Ceeeb]]'''</dt>
<dd class="note">In '''OFP''', setting a unit's damage to a negative value will set it's health to full, but impair their aim.
<dd class="note">In '''OFP''', setting a unit's damage to a negative value will set it's health to full, but impair their aim.
In '''ArmA''', setting a unit's damage to a negative value will increase it's hitpoints. Note the unit may still be killed by receiving above a certain amount of damage to specific component (eg, headshot will still kill a soldier).</dd>


<!-- Note Section END -->
<!-- Note Section END -->
Line 42: Line 58:


<h3 style="display:none">Bottom Section</h3>
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands|SETDAMAGE]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.96|SETDAMAGE]]
[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA|SETDAMAGE]]
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Object_Manipulation|{{uc:{{PAGENAME}}}}]]
[[Category:Notes: Improper Formatting|{{uc:{{PAGENAME}}}}]]
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on May 29, 2015 - 11:23 (UTC)</dd>
<dt class="note">[[User:KamikazeXeX|KamikazeXeX]]</dt>
<dd class="note">
Using this possible overrides individual hit damages such as [[setHitPointDamage]] ["HitHead", _value]; if you're having issues try setting hitdamage ''after'' setdamage.
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Revision as of 00:08, 5 September 2019

Logo A0.png1.5
GAGlobalGEGlobal
Hover & click on the images for description

Description

Description:
Sets an object's damage value in the range 0..1, 0 meaning fully functional and 1 completely destroyed / dead.
The alternative syntax allows to switch off destruction effects.

Identical to setDammage, typo aside.
Groups:
Uncategorised

Syntax

Syntax:
object setDamage damage
Parameters:
object: Object
damage: Number
Return Value:
Nothing

Alternative Syntax

Syntax:
object setDamage [damage, useEffects]        (Since Arma 3 v1.67)
Parameters:
object: Object
[damage, useEffects]: Array
damage: Number
useEffects: Boolean - false to skip destruction effects. Default: true
Return Value:
Nothing

Examples

Example 1:
_soldier1 setDamage 1;
Example 2:
_house1 setDamage [1, false];

Additional Information

See also:
setDammagesetVehicleArmordamagegetDammagesetHitgetHitgetHitIndexsetHitIndexgetHitPointDamagesetHitPointDamage

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

Notes

Ceeeb
In OFP, setting a unit's damage to a negative value will set it's health to full, but impair their aim.

Bottom Section

Posted on May 29, 2015 - 11:23 (UTC)
KamikazeXeX
Using this possible overrides individual hit damages such as setHitPointDamage ["HitHead", _value]; if you're having issues try setting hitdamage after setdamage.
Retrieved from "https://community.bistudio.com/wiki?title=setDamage&oldid=136897"