setHit: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "_{10,} " to "")
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...)
Line 1: Line 1:
{{Command|Comments=
{{Command


| arma2 |Game name=
| arma2


|1.00|Game version=
|1.00


|arg= local |Multiplayer Arguments=
|arg= local


|eff= global |Multiplayer Effects=
|eff= global


|gr1= Object Manipulation |GROUP1=
|gr1= Object Manipulation


| Set damage on a part of an object.
| Set damage on a part of an object.
{{Informative | Some part names are in Czech; see [[Translations|translation table]]. }} |DESCRIPTION=
{{Informative | Some part names are in Czech; see [[Translations|translation table]]. }}


| object [[setHit]] [part, damage, useEffects] |SYNTAX=
| object [[setHit]] [part, damage, useEffects]


|p1 = [part, damage, useEffects]: [[Array]] |Parameter1=
|p1 = [part, damage, useEffects]: [[Array]]


|p2= object: [[Object]] - [[local]] object|PARAMETER2=
|p2= object: [[Object]] - [[local]] object


|p3= part: [[String]] - Name of the part ([[Named_Selection|selection]] name) |Parameter3=
|p3= part: [[String]] - Name of the part ([[Named_Selection|selection]] name)


|p4= damage: [[Number]] - Damage value ranging 0..1, 0 being fully functional, 1 being destroyed |Parameter4=
|p4= damage: [[Number]] - Damage value ranging 0..1, 0 being fully functional, 1 being destroyed


|p5 = {{GVI|arma3|1.67}} useEffects: [[Boolean]] - (Optional, default [[true]]) [[false]] to skip destruction effects |Parameter5=
|p5 = {{GVI|arma3|1.67}} useEffects: [[Boolean]] - (Optional, default [[true]]) [[false]] to skip destruction effects


| [[Nothing]] |RETURNVALUE=
| [[Nothing]]


|x1= <code>[[vehicle]] [[player]] [[setHit]] ["motor", 1];</code> |EXAMPLE1=
|x1= <code>[[vehicle]] [[player]] [[setHit]] ["motor", 1];</code>


|x2= <code>[[vehicle]] [[player]] [[setHit]] ["mala vrtule", 0.95];</code> |EXAMPLE2=
|x2= <code>[[vehicle]] [[player]] [[setHit]] ["mala vrtule", 0.95];</code>


|x3= <code>[[if]] ([[local]] _heli) [[then]] {
|x3= <code>[[if]] ([[local]] _heli) [[then]] {
Line 36: Line 36:
} [[else]] {
} [[else]] {
[[hint]] ("Vehicle " + [[str]] _heli + " must be local to this machine to do that!");
[[hint]] ("Vehicle " + [[str]] _heli + " must be local to this machine to do that!");
};</code> |EXAMPLE3=
};</code>


| [[getHit]], [[getHitPointDamage]], [[setHitPointDamage]], [[damage]], [[setDamage]], [[setFuel]], [[setAmmo]], [[getHitIndex]], [[setHitIndex]] |SEEALSO=
| [[getHit]], [[getHitPointDamage]], [[setHitPointDamage]], [[damage]], [[setDamage]], [[setFuel]], [[setAmmo]], [[getHitIndex]], [[setHitIndex]]
}}
}}



Revision as of 12:09, 18 January 2021

Hover & click on the images for description

Description

Description:
Set damage on a part of an object.
Some part names are in Czech; see translation table.
Groups:
Object Manipulation

Syntax

Syntax:
object setHit [part, damage, useEffects]
Parameters:
[part, damage, useEffects]: Array
object: Object - local object
part: String - Name of the part (selection name)
damage: Number - Damage value ranging 0..1, 0 being fully functional, 1 being destroyed
Arma 3 logo black.png1.67 useEffects: Boolean - (Optional, default true) false to skip destruction effects
Return Value:
Nothing

Examples

Example 1:
vehicle player setHit ["motor", 1];
Example 2:
vehicle player setHit ["mala vrtule", 0.95];
Example 3:
if (local _heli) then { _heli setHit ["velka vrtule", 0]; } else { hint ("Vehicle " + str _heli + " must be local to this machine to do that!"); };

Additional Information

See also:
getHitgetHitPointDamagesetHitPointDamagedamagesetDamagesetFuelsetAmmogetHitIndexsetHitIndex

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

Deadfast
Damaging specific parts of the vehicle will not update its overall damage value (as of v1.03): player setHit ["hands", 0.9]; hint str (damage player); // will return 0
denisko.redisko
Direct use of the names of sections of the model is likely a bad practice, and will not work on some addons. So instead: _MH60S setHit ["elektronika", _hit]; should be used: _MH60S setHit [getText (configFile >> "cfgVehicles" >> "MH60S" >> "HitPoints" >> "HitAvionics" >> "name"), _hit];

Bottom Section

Posted on September 11, 2018 - 19:37 (UTC)
HazJ
You can use getHit if you are using 1.64 EOL version.