GetActiveEffectCount

A command for Oblivion Script Extender

Syntax:

(count:long) reference.GetActiveEffectCount

Returns the number of Active Effects on the reference.

Example

short NumEffects
set NumEffects to player.GetActiveEffectCount

If the player currently has 1 potion with Shield and Restore Health, another potion with Restore Health, and a spell with Shield and Drain Health this will return 5 (2 Shields, 2 Restore Healths, and 1 Drain Health).

Notes

• Active Effects from different sources are counted as unique Active Effects, even if they are the same. For example, a Shield effect from a potion, a Shield effect from another potion, and a Shield effect from a spell, each one will return their own magnitude.
  • If the Magic Item has 2 of the same effect, they will be counted separately.
  • If the effect is from the same Magic Item (i.e., 2 instances of DrinkAle), it will still count as 2 separate Active Effects.
    • The only exception is scripted effects with the same script. Generally, only the first one's data (Magic Item Index, Caster, etc.) will be used.

See Also

• Magic Effects List
• GetNthActiveEffectCode
• GetNthActiveEffectMagnitude
• GetNthActiveEffectDuration
• GetNthActiveEffectTimeElapsed
• GetNthActiveEffectCaster
• GetNthActiveEffectData
• GetNthActiveEffectMagicItem
• GetNthActiveEffectMagicItemIndex