Magic effect scripts

From the Oblivion ConstructionSet Wiki
Revision as of 14:05, 8 October 2008 by imported>DragoonWraith (→‎Notes: GameMode == ScriptEffectUpdate ''within a scripted spell'')
Jump to navigation Jump to search

Magic Effect scripts are special scripts that can be used to create Scripted Magic Effects. They are created using the normal script editing window, but must be marked as Magic Effect scripts in order to be used in this way. Also note that the scripted effects will only run while under Game Mode.

These scripts do not use normal begin/end blocks, since they only run while the spell effect is active on a target. They use three special block types and one special function.


Magic Effect block types:



Magic Effect functions:

In all other ways, Magic Effect scripts act like reference scripts, and can use all normal script functions inside the Magic Effect blocks.

Notes

  • Scripted spells will run on corpses, containers, doors, and furniture, but will simply run through the entire script once, regardless of the duration of the spell. All three blocktypes, ScriptEffectStart, ScriptEffectUpdate, and ScriptEffectFinish will run.
  • Scripted spells behave unpredictably when running on an actor outside of the currently loaded cell. Some confirmed issues are as follows:
    • Variables in the script become uninitialized;
    • ScriptEffectFinish block may fail to run;
    • For scripted abilities, a new instance of the script is created each time the player enters the cell with the affected actor.

    Other bizarre results have yet to be confirmed or explained. A workaround is to add a scripted item to the actor's inventory.

  • Magic effect scripts are not necessarily limited to the three blocktypes above. MenuMode, for example, will work, and GameMode is identical to ScriptEffectUpdate from within a scripted spell.

See Also