Difference between revisions of "GetNthActiveEffectMagnitude"

Revision as of 00:53, 27 November 2007

Syntax:

(magnitude:long)  reference.GetNthActiveEffectMagnitude whichEffect:long
(magnitude:long)  reference.GetNthAEMagnitude whichEffect:long

Returns the magnitude of the Nth Active Effect on the reference.

Example

short EffectMag
set EffectMag to (player.GetNthActiveEffectMagnitude 0)

If the player currently has two Shield effects, no other effects, the first at 10 magnitude and the second at 90, this will return 10.

This returns the magnitude applied to the NPC, but not the original from the spell.
- For scripted effects (and for example), if you set the magnitude of a scripted effect to a non-zero number, this will still return 0. Presumably, this is because scripted effects aren't meant to have non-zero magnitudes, and no magnitude is applied to the NPC when it hits.
- Resistances: This may or may not include resistances.
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.

@@ Line 17: / Line 17: @@
 **Resistances: This may or may not include resistances.
 *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.
-**Untested
+**If the Magic Item has 2 of the same effect, they will be counted separately.
-**#Do effects from the same source stack into one? That is, if a potion has 2 '''Shield''' effects, will there be 2 Active Effects, each with their own magnitude?
+**If the effect is from the same Magic Item (i.e., 2 instances of DrinkAle), it will still count as 2 separate Active Effects.
-**#Will the same spell stack? That is, if you cast a '''Shield''' spell on an NPC twice, will there be 2 Active Effects or 1? (If spells don't work that way, potions can be stacked multiple times on the player by applying it as a poison.)
+***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==