Editing SetOnHealthDamageEventHandler

{{Function
 |origin = JIP
 |summary = Sets/removes the specified '''UDF Script''' as a handler that will be invoked in the event the specified '''Actor''' takes Health damage.

When invoked, the script is passed with the '''Actor''' as the calling reference ("<i>this</i>"), and two arguments: the amount of damage taken and, if the damage resulted from being hit by another actor, the reference of that actor, otherwise (if the damage resulted from falling, for example) 0.
 |name = SetOnHealthDamageEventHandler
 |arguments = 
  {{FunctionArgument
   |Name = handlerScript
   |Type = ref
  }}{{FunctionArgument
   |Name = setORremove
   |Type = 1/0
  }}{{FunctionArgument
   |Name = actor
   |Type = ref
  }}
 |example = <pre>SetOnHealthDamageEventHandler OnHealthDamageUDF 1 SomeActor</pre>
'''Sets''' the <i>OnHealthDamageUDF</i> script as a handler to be invoked when '''SomeActor''' takes Health damage.
<pre>SetOnHealthDamageEventHandler OnHealthDamageUDF 0 SomeActor</pre>
'''Removes''' the <i>OnHealthDamageUDF</i> script as a handler of the above.
}}
==Handler Script==
A skeleton handler script for this event:
<pre>scn&#09;OnHealthDamageUDF

float&#09;fDamageAmount
ref&#09;rSourceRef
ref&#09;rActorRef

begin Function {fDamageAmount, rSourceRef}

&#09;set rActorRef to this

&#09;(code)

end</pre>
==See Also==
*[[SetOnCrippledLimbEventHandler]]
[[Category:Functions_(JIP)]]
[[Category:Actor Functions (JIP)]]
[[Category:Event Handlers (JIP)]]