Difference between revisions of "SetNthEffectItemMagnitude"

586 bytes added ,  08:32, 14 May 2010
imported>WereWolf
(Added obse link)
imported>Candlemaster
 
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
A command for [[:Category:Oblivion Script Extender|Oblivion Script Extender]]
A command for [[:Category:Oblivion Script Extender|Oblivion Script Extender]]
SetNthEffectItemMagnitude - sets the magnitude of the specified effect item


'''Syntax:'''
'''Syntax:'''
Line 7: Line 5:


  (nothing) SetNthEIMagnitude nuMagnitude:long magicItem:ref whichEffect:short
  (nothing) SetNthEIMagnitude nuMagnitude:long magicItem:ref whichEffect:short
Sets the magnitude of the specified effect item.


==Notes==
==Notes==
Line 12: Line 12:
* You can set the magnitude of a spell to a negative number. The spell will have the opposite effect. For example, if you set a '''Damage Health''' spell to -10 (Duration 1), and cast it on the player, the player will gain 10 health. Unlike the above, a fraction will be rounded up (i.e., -2.6 will be -2).
* You can set the magnitude of a spell to a negative number. The spell will have the opposite effect. For example, if you set a '''Damage Health''' spell to -10 (Duration 1), and cast it on the player, the player will gain 10 health. Unlike the above, a fraction will be rounded up (i.e., -2.6 will be -2).
** Only '''Damage Health''' has been tested so far, so results may vary.
** Only '''Damage Health''' has been tested so far, so results may vary.
**Frost Damage is confirmed to heal when set to a reversed magnitude, but note that an unmodified Frost Damage magnitude returns a negative number from [[GetNthEffectItemMagnitude]], so setting it to a negative value will still deal damage.  To make a Frost Damage effect heal, you must set it to a <b>positive</b> magnitude.  This is believed to be true for Fire Damage and Shock Damage as well (untested).
* You can set the magnitude of any magic item, even if it normally doesn't have a magnitude and it's grayed out in the CS. This magnitude won't do anything or even appear in-game, but you can retrieve it with [[GetNthEffectItemMagnitude]], making it a good way to store integer data.
* You can set the magnitude of any magic item, even if it normally doesn't have a magnitude and it's grayed out in the CS. This magnitude won't do anything or even appear in-game, but you can retrieve it with [[GetNthEffectItemMagnitude]], making it a good way to store integer data.
* (Unconfirmed, but likely) Using this function on a non-cloned spell (any spells from Oblivion.esm or mods) will change the magnitude of the spell, but only until the player re-loads their game. The most likely explanation is that Oblivion retrieves the spell's data from the mod/Oblivion.esm when loading, while cloned spells' data come from the save file itself.
* (Unconfirmed, but likely) Using this function on a non-cloned spell (any spells from Oblivion.esm or mods) will change the magnitude of the spell, but only until the player re-loads their game. The most likely explanation is that Oblivion retrieves the spell's data from the mod/Oblivion.esm when loading, while cloned spells' data come from the save file itself.
* (At least for some effects) If the altered spell is already on an actor, it will take a frame or two for the new magnitude to take effect on that actor.


==See Also==
==See Also==
Line 23: Line 25:
[[Category:Magic Functions]]
[[Category:Magic Functions]]
[[Category:Magic Functions (OBSE)]]
[[Category:Magic Functions (OBSE)]]
[[Category:Magic Functions - Effect Item (OBSE)]]
Anonymous user