GetNthActiveEffectTimeElapsed

Revision as of 00:54, 27 November 2007 by imported>Haama (→‎Notes: More on how Active Effects stack)

A command for Oblivion Script Extender

Syntax:

(timeElapsed:float) reference.GetNthActiveEffectTimeElapsed whichEffect:long
(timeElapsed:float) reference.GetNthAETime whichEffect:long

Returns the time that the Nth Active Effect has been applied to the reference.

Example

float EffectTimePassed
set EffectTimePassed to (player.GetNthActiveEffectTimeElapsed 0)

If the player currently has two Shield effects, the first in effect for 10 seconds and the second for 90, this will return 10.

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