OnUpdate - Form

Member of: ActiveMagicEffect Script, Alias Script, and Form Script

Event called periodically if the active magic effect/alias/form is registered for update events. This event will not be sent if the game is in menu mode.

Syntax

Event OnUpdate()

Parameters

None

Example

Function SomeFunction()                
  registerForUpdate(5) ; Before we can use onUpdate() we must register.
EndFunction
	
Event OnUpdate() ; because of how we registered, this event occurs every five seconds		
  If myQuest.getStage() == 10
    UnregisterForUpdate()  ; when we're done with it, make sure to unregister
    Debug.Trace("Got what we needed, so stop polling!")
  EndIf
EndEvent

Notes

• Aliases and quests will automatically unregister for this event when the quest stops. Active magic effects will automatically unregister when they are removed.
• This event is not relayed to any aliases or magic effects attached to the form.
• This event is relayed to other scripts attached to the same object. eg. On a quest form with 2 main quest scripts and a fragment script, an update event registered by one will be received by all three.
• Be careful with the use of this event. Because it uses real-time, it can start piling up on itself if the OnUpdate doesn't finish before the time is up. To avoid this, try using a longer time at registration, or do a 'single update chain' which looks like the following:

Function StartChain()
  RegisterForSingleUpdate(1) ; Give us a single update in one second
endFunction

Event OnUpdate()
  bool bkeepUpdating = true
  ; Do stuff here, and update the bkeepUpdating variable depending on whether you want another update or not
  if bkeepUpdating
    RegisterForSingleUpdate(1)
  endIf
endEvent

This prevents multiple update events from stacking up on top of each other and slowing Papyrus down. If multiple update events do stack up on top of one another, this will also increase save file size. If enough instances of the event are stacked up in this way, it can cause significant increases in the size of any save file created.

See Also

• ActiveMagicEffect Script
• Alias Script
• Form Script
• RegisterForUpdate - Form
• RegisterForSingleUpdate - Form
• UnregisterForUpdate - Form