Difference between revisions of "OnReset - ObjectReference"

From the CreationKit Wiki
Jump to navigation Jump to search
imported>HawkFest
imported>Arthmoor
(Corrected the contradictory information regarding Quests and Aliases since OnReset is NOT a member of either of these.)
Line 2: Line 2:
[[Category:Papyrus]]
[[Category:Papyrus]]
[[Category:Events]]
[[Category:Events]]
'''Member of:''' [[ObjectReference Script]], [[Alias Script]], and [[Quest Script]]
'''Member of:''' [[ObjectReference Script]]


Event called when the object is reset.
Event called when the object is reset.
Line 23: Line 23:
== Notes ==
== Notes ==
* Your script's data has already been reset by the time you receive this event (and your [[OnInit]] has been run), so if you need to retain any information between Resets, you need to store the information somewhere else.
* Your script's data has already been reset by the time you receive this event (and your [[OnInit]] has been run), so if you need to retain any information between Resets, you need to store the information somewhere else.
* Quests and their aliases receive this event when the quest is started up.
* Aliases receive this event since it targets the ObjectReference a ReferenceAlias points to.
** This event is '''NOT''' received by quests and aliases.
***Conclusion : this event is received by quests and aliases, but is not received by quests and aliases (meaning this part of the doc must be rewritten).
* Any event registrations that have been done before the object was reset (and before OnInit would have been called) will have been cleared.
* Any event registrations that have been done before the object was reset (and before OnInit would have been called) will have been cleared.
* This event does not block other events, functions, or properties from running (unlike OnInit).
* This event does not block other events, functions, or properties from running (unlike OnInit).
Line 31: Line 29:


== See Also ==
== See Also ==
*[[Alias Script]]
*[[Quest Script]]
*[[ObjectReference Script]]
*[[ObjectReference Script]]

Revision as of 18:12, 7 December 2013

Member of: ObjectReference Script

Event called when the object is reset.

Syntax

Event OnReset()

Parameters

None.

Examples

Event OnReset()
  Debug.Trace("This object was reset")
endEvent

Notes

  • Your script's data has already been reset by the time you receive this event (and your OnInit has been run), so if you need to retain any information between Resets, you need to store the information somewhere else.
  • Aliases receive this event since it targets the ObjectReference a ReferenceAlias points to.
  • Any event registrations that have been done before the object was reset (and before OnInit would have been called) will have been cleared.
  • This event does not block other events, functions, or properties from running (unlike OnInit).
  • Created refs never reset (i.e. refs placed via PlaceAtMe)

See Also