Difference between revisions of "SetActorValue"

Latest revision as of 10:55, 6 February 2017

< [[::Category:Functions|Category:Functions]]

Link to TES4 Construction Set Wiki: SetActorValue.

A function included in the GECK version 1.1.0.36.

SetActorValue sets the stat's base value to the new value.

See Stats List for a list of stats that can be accessed using SetActorValue.

Actor.SetActorValue StatName:actorValue Value:int

Or:

Actor.SetAV StatName:actorValue Value:int

Player.SetActorValue Health 3
SetActorValue Strength 6

For the player, this will not modify base health. Base health is determined by (Endurance * fPCBaseHealthMult). For example, a level 2 player with 40 Endurance will have 80 base health (40 * 2 = 80) and 4 more health (from the Endurance level bonus). If you use player.SetAv Health 100 the player will have 180 total health - 80 from base health, and 100 for the rest.

@@ Line 11: / Line 11: @@
    {{FunctionArgument
     |Name = StatName
-    |Type = string
+    |Type = actorValue
    }}{{FunctionArgument
     |Name = Value
     |Type = int
    }}
-  |example = Player.SetActorValue "Health" 3
+  |example = Player.SetActorValue Health 3
+ SetActorValue Strength 6
 }}
@@ Line 23: / Line 24: @@
 == Notes ==
-* Although called on a reference, this function actually changes the value on the base actor (thus the base value on all references of that base actor). Note also that ModActorValue modifies the stat value only on the reference, and so is usually preferable.
 * For the player, this will not modify base health. Base health is determined by (Endurance * fPCBaseHealthMult). For example, a level 2 player with 40 Endurance will have 80 base health (40 * 2 = 80) and 4 more health (from the Endurance level bonus). If you use player.SetAv Health 100 the player will have 180 total health - 80 from base health, and 100 for the rest.