setHitPointDamage: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "\{\{GameCategory\|(arma[0123])\|[ _]?New[ _]Scripting[ _]Commands[ _]List\}\}" to "{{GameCategory|$1|New Scripting Commands}}") |
Lou Montana (talk | contribs) m (Text replacement - "{{Link|:Category:" to "{{Link|Category:") |
||
| (61 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
{{ | {{RV|type=command | ||
| | |game1= tkoh | ||
|version1= 1.00 | |||
| | |game2= arma3 | ||
|version2= 0.50 | |||
|arg= local | |arg= local | ||
|eff= global | |eff= global | ||
|gr1= Object Manipulation | |gr1= Object Manipulation | ||
| | |descr= | ||
{{{!}} class="wikitable float-right align-center-col-2" | |||
! {{Link|Category: Event Handlers|Event Handler}} | |||
! Triggered | |||
{{!}}- | |||
{{!}} {{hl|Hit}} | |||
{{!}} {{Icon|unchecked}} | |||
{{!}}- | |||
{{!}} {{hl|HandleDamage}} | |||
{{!}} {{Icon|unchecked}} | |||
{{!}}- | |||
{{!}} {{hl|Killed}} | |||
{{!}} {{Icon|checked}} | |||
{{!}}- | |||
{{!}} {{hl|MPKilled}} | |||
{{!}} {{Icon|checked}} | |||
{{!}}} | |||
| | Set the current level of damage for a specific Hit Point (specified by its config class). This command has no effect when [[allowDamage]] is set to [[false]]. | ||
{{Feature|informative|See also [[BIS_fnc_setHitPointDamage]] for setting hit with dependency.}} | |||
| | |s1= vehicle [[setHitPointDamage]] [hitPointName, damage, useEffects, killer, instigator, breakRotor] | ||
|p1= vehicle: [[Object]] - vehicle to be damaged | |||
| [[ | |p2= hitPointName: [[String]] - name of the Hit Point class | ||
| | |p3= damage: [[Number]] - level of damage, in range 0..1 | ||
| | |p4= useEffects: [[Boolean]] - (Optional, default [[true]]) [[false]] to skip destruction effects | ||
|p4since= arma3 1.68 | |||
[[ | |||
| [[ | |p5= killer: [[Object]] - (Optional, default [[objNull]]) the entity that caused the damage. If the damage leads to the death of the unit, the killer will be used as the object that caused the kill. <br> | ||
* It can be used to show "killed by player" in debriefing statistics and kill messages in the chat (if death messages are enabled). <br> | |||
* It will alter the killer's [[rating]] as if the killer directly killed the unit. <br> | |||
* It will be listed as <sqf inline>_killer</sqf> parameter in the [[Arma_3:_Event_Handlers#Killed|Killed]] event handler. | |||
|p5since= arma3 2.08 | |||
|p6= instigator: [[Object]] - (Optional, default [[objNull]]) the person that instigated the damage. | |||
* if a tank is a killer, the tank gunner that pulled the trigger is instigator | |||
* it will be listed as <sqf inline>_instigator</sqf> parameter in the [[Arma 3: Event Handlers#Killed|Killed]] event handler. | |||
|p6since= arma3 2.12 | |||
|p7= breakRotor: [[Boolean]] - (Optional, default [[false]]) if the hitpoint is rotor on a helicopter, [[true]] will break the rotor as well as play corresponding sound if 'useEffects' is also [[true]]. | |||
|p7since= arma3 2.18 | |||
|r1= [[Nothing]] | |||
< | |x1= <sqf>vehicle player setHitPointDamage ["hitEngine2", 1.0];</sqf> | ||
< | |||
< | |x2= <sqf> | ||
player setHitPointDamage ["hitHead", 0.5]; | |||
player setHitPointDamage ["hitBody", 0.5]; | |||
player setHitPointDamage ["hitHands", 0.5]; | |||
player setHitPointDamage ["hitLegs", 0.5]; | |||
</sqf> | |||
|seealso= [[getHitPointDamage]] [[getAllHitPointsDamage]] [[setHit]] [[getHit]] [[setDamage]] [[damage]] [[getHitIndex]] [[setHitIndex]] [[forceHitPointsDamageSync]] [[BIS_fnc_setHitPointDamage]] [[getHitPointDamage#Notes|Common TKOH Hit Points]] | |||
}} | |||
{{Note | |||
{{ | |user= Master85 | ||
|timestamp= 20120830135400 | |||
|text= This command is using the Hit Points (defined in the {{hl|HitPoints}} class in the config) while [[setHit]] is using [[Named Selection]]s (defined in the model itself). | |||
}} | |||
Latest revision as of 14:52, 16 October 2024
Description
- Description:
-
Event Handler Triggered Hit 
HandleDamage
Killed 
MPKilled
Set the current level of damage for a specific Hit Point (specified by its config class). This command has no effect when allowDamage is set to false.
- Groups:
- Object Manipulation
Syntax
- Syntax:
- vehicle setHitPointDamage [hitPointName, damage, useEffects, killer, instigator, breakRotor]
- Parameters:
- vehicle: Object - vehicle to be damaged
- hitPointName: String - name of the Hit Point class
- damage: Number - level of damage, in range 0..1
- since
1.68 - useEffects: Boolean - (Optional, default true) false to skip destruction effects
- since 2.08
- killer: Object - (Optional, default objNull) the entity that caused the damage. If the damage leads to the death of the unit, the killer will be used as the object that caused the kill.
- since 2.12
- instigator: Object - (Optional, default objNull) the person that instigated the damage.
- if a tank is a killer, the tank gunner that pulled the trigger is instigator
- it will be listed as _instigator parameter in the Killed event handler.
- since 2.18
- breakRotor: Boolean - (Optional, default false) if the hitpoint is rotor on a helicopter, true will break the rotor as well as play corresponding sound if 'useEffects' is also true.
- Return Value:
- Nothing
Examples
- Example 1:
- Example 2:
Additional Information
- See also:
- getHitPointDamage getAllHitPointsDamage setHit getHit setDamage damage getHitIndex setHitIndex forceHitPointsDamageSync BIS_fnc_setHitPointDamage Common TKOH Hit Points
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 Aug 30, 2012 - 13:54 (UTC)
- This command is using the Hit Points (defined in the HitPoints class in the config) while setHit is using Named Selections (defined in the model itself).