Difference between revisions of "ModActorValue - Actor"

From the CreationKit Wiki
Jump to navigation Jump to search
imported>Thingy Person
imported>Egocarib
 
Line 34: Line 34:
== Notes ==
== Notes ==
*This function modifies the current value as opposed to the base value.
*This function modifies the current value as opposed to the base value.
*ModActorValue() with a negative number is equivalent to DamageActorValue() (not always true, see talk)
*ModActorValue is distinct from DamageActorValue because it adjusts the maximum value for the AV, while DamageActorValue or RestoreActorValue only adjust the current value. For example, if an actor has 100 Health, ModActorValue by -10 will lower the health total to 90/90, whereas DamageActorValue by 10 will result in 90/100 Health.
*ModActorValue() with a positive number is equivalent to RestoreActorValue() except that RestoreActorValue will not set the current value higher than the base value.


== See Also ==
== See Also ==

Latest revision as of 07:11, 12 April 2014

Member of: Actor Script

Modifies the specified actor value on the actor.

Syntax[edit | edit source]

Function ModActorValue(string asValueName, float afAmount) native
Function ModAV(string asValueName, float afAmount)
  ModActorValue(asValueName, afAmount)
EndFunction

Parameters[edit | edit source]

  • asValueName: The name of the actor value to modify. Actor Value List
  • afAmount: How much to modify the value by.

Return Value[edit | edit source]

None.

Examples[edit | edit source]

; Modify the player's current health actor value by 10
Game.GetPlayer().ModActorValue("health", 10.0)


; Modify Jake's current health actor value by -5.0
Actor Jake= Jake_Alias.GetReference() as Actor
Jake.ModAV("Health", -5.0)

Notes[edit | edit source]

  • This function modifies the current value as opposed to the base value.
  • ModActorValue is distinct from DamageActorValue because it adjusts the maximum value for the AV, while DamageActorValue or RestoreActorValue only adjust the current value. For example, if an actor has 100 Health, ModActorValue by -10 will lower the health total to 90/90, whereas DamageActorValue by 10 will result in 90/100 Health.

See Also[edit | edit source]