Category:Actor Values

Actor Value Mechanics

There are six factors that contribute to an Actor Value:

There are three different 'versions' of an Actor Value that play a role in Oblivion:

Calculated Base Value  =  (Base + Calculated Base) * (Calculated Multiplier)
    Maximum Value      =   Calculated Base Value + Max Modifier
    Current Value      =   Maximum Value + Offset Modifier + Damage Modifier

Notes

• These formulas do not apply to Fame,Infamy,Bounty,or Encumbrance. These AVs are calculated differently, and stored differently as well.
• When player stats are displayed in the menu, they are shown as green if the Current value is greater than the Calculated Base value, red if the Current value is less than the CBV, and blue if the two are equal. The exception is the players Health, Magicka, and Fatigue, where the comparison is between the Maximum value and the CBV.
• Since the Offset modifier is not affected by ordinary damage or magic, changes to it cannot be undone by restoration spells or chapel healing, etc.
• The Damage modifier is always negative or zero, but the Offset modifier can be positive, so it can be used to make the Current value greater than the Maximum value. This isn't seen in game simply because nothing ever uses the Offset modifier.
• For (1) 'recoverable' effects from (2) Ability-type spells applied on the (3) player (and only the player), the Base factor is modified instead of the Max factor. This is why benefits from birthsign and certain quest rewards (like the Skeleton Key) can actually alter the players skill mastery level.

Encumbrance

Encumbrance is calculated and displayed differently from other actor values.

• The Base factor is ignored entirely. It is not used in calculation, and cannot be altered by the SetAV command or any magical means. It is, however, still included in the return value of the GetBaseAV command, making this command effectively useless.
• The Calculated Base is the total encumbrance bonus from strength. Unlike most calculated factors, this applies to all actors, not just the player.
• The Maximum Value and Current Value are calculated differently:

Modifier Sum = (Max Modifier + Offset Modifier + Damage Modifier)

if (Modifier Sum < 0) :

Maximum Value = Calculated Base - Modifier Sum
Current Value = Carried Weight

if (Modifier Sum > 0) :

Maximum Value = Calculated Base
Current Value = Carried Weight + Modifier Sum

For this reason, the Current encumbrance of an actor will never be less than their total carried weight, and the Maximum encumbrance will never be less than the value calculated from their strength.

• The GetAV command does not return the Current Value, but rather the sum of carried weight and all modifiers, even if the sum of the modifiers is negative:

 GetAV Return Value = Carried Weight + Modifier Sum

This means that GetAV will return the wrong value if the actor is currently subject to enough effects that reduce encumbrance (e.g. Feather).

List of Actor Values

The following stats can be accessed using the Actor Value commands. The code versions are used with the 'C' versions of various OBSE Actor Functions.

Fame and Infamy

* - Fame and Infamy cannot be used as parameters for GetActorValue, SetActorValue, or ModActorValue. Use GetPCFame (Infamy), SetPCFame (Infamy), and ModPCFame (Infamy) instead. OBSE Actor Functions can accept it as a parameter, however.