Difference between revisions of "Alias Script"
Jump to navigation
Jump to search
imported>Bot Owned |
imported>Bug64 m (Clarified getName() and added some more links) |
||
(4 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
Native base script for every alias in the game. Don't confuse this for [[ReferenceAlias Script]] which you are more likely to use. | Native base script for every alias in the game. Don't confuse this for [[ReferenceAlias Script]] which you are more likely to use. | ||
Line 16: | Line 13: | ||
== Member Functions == | == Member Functions == | ||
''' | :'''Quest [[GetOwningQuest - Alias|GetOwningQuest]]()''' | ||
*Registers this alias to receive the specified animation event from the specified object. | :*Returns the [[Quest Script|Quest]] that owns this alias. | ||
:'''[[RegisterForAnimationEvent - Form|RegisterForAnimationEvent]](ObjectReference ''akSender'', String ''asEventName'')''' | |||
:*Registers this alias to receive the specified animation event from the specified object. | |||
:'''[[RegisterForLOS - Form|RegisterForLOS]](Actor ''akViewer'', ObjectReference ''akTarget'')''' | |||
:*Registers this alias to receive gain and lost LOS events between the viewer and the target. | |||
''' | :'''[[RegisterForSingleLOSGain - Form|RegisterForSingleLOSGain]](Actor ''akViewer'', ObjectReference ''akTarget'')''' | ||
*Registers this alias to receive gain | :*Registers this alias to receive a single LOS gain event when the viewer sees the target. | ||
''' | :'''[[RegisterForSingleLOSLost - Form|RegisterForSingleLOSLost]](Actor ''akViewer'', ObjectReference ''akTarget'')''' | ||
*Registers this alias to receive a single LOS | :*Registers this alias to receive a single LOS lost event when the viewer loses sight of the target. | ||
''' | :'''[[RegisterForSingleUpdate - Form|RegisterForSingleUpdate]](Float ''afInterval'')''' | ||
*Registers this alias to receive a single | :*Registers this alias to receive a single update event in the specified time. | ||
''' | :'''[[RegisterForSingleUpdateGameTime - Form|RegisterForSingleUpdateGameTime]](Float ''afInterval'')''' | ||
*Registers this alias to receive a single update event in the specified | :*Registers this alias to receive a single update event in the specified number of game hours. | ||
''' | :'''[[RegisterForSleep - Form|RegisterForSleep]]()''' | ||
*Registers this alias to receive | :*Registers this alias to receive sleep events for when the player goes to sleep or wakes up. | ||
''' | :'''[[RegisterForTrackedStatsEvent - Form|RegisterForTrackedStatsEvent]]()''' | ||
*Registers this alias to receive | :*Registers this alias to receive tracked stats events for when tracked stats are updated. | ||
''' | :'''[[RegisterForUpdate - Form|RegisterForUpdate]](Float ''afInterval'')''' | ||
*Registers this alias to receive | :*Registers this alias to receive update events with the specified interval, or changes the update interval. | ||
''' | :'''[[RegisterForUpdateGameTime - Form|RegisterForUpdateGameTime]](Float ''afInterval'')''' | ||
*Registers this alias to receive update events with the specified interval, or changes the update interval. | :*Registers this alias to receive update events with the specified interval in game time hours, or changes the update interval. | ||
''' | :'''[[StartObjectProfiling - Form|StartObjectProfiling]]()''' | ||
* | :*Starts profiling all scripts attached to this alias. | ||
''' | :'''[[StopObjectProfiling - Form|StopObjectProfiling]]()''' | ||
* | :*Stops profiling all scripts attached to this alias. | ||
''' | :'''[[UnregisterForAnimationEvent - Form|UnregisterForAnimationEvent]](ObjectReference ''akSender'', String ''asEventName'')''' | ||
* | :*Unregisters this alias from receiving the specified animation event from the specified object. | ||
''' | :'''[[UnregisterForLOS - Form|UnregisterForLOS]](Actor ''akViewer'', ObjectReference ''akTarget'')''' | ||
*Unregisters this alias from | :*Unregisters this alias from any LOS events between the viewer and target. | ||
''' | :'''[[UnregisterForSleep - Form|UnregisterForSleep]]()''' | ||
*Unregisters this alias from | :*Unregisters this alias from sleep events. | ||
''' | :'''[[UnregisterForTrackedStatsEvent - Form|UnregisterForTrackedStatsEvent]]()''' | ||
*Unregisters this alias from | :*Unregisters this alias from tracked stats events. | ||
''' | :'''[[UnregisterForUpdate - Form|UnregisterForUpdate]]()''' | ||
*Unregisters this alias from | :*Unregisters this alias from update events. | ||
''' | :'''[[UnregisterForUpdateGameTime - Form|UnregisterForUpdateGameTime]]()''' | ||
*Unregisters this alias from update events. | :*Unregisters this alias from game time update events. | ||
== SKSE Member Functions == | == SKSE Member Functions == | ||
'''Int | :'''String [[GetName - Alias|GetName]]()''' | ||
* Returns the ID of the alias. | :* Returns the unique name of the alias (not its display name). Used by calls to [[GetAliasByName - Quest|GetAliasByName]]. | ||
:'''Int [[GetID - Alias|GetID]]()''' | |||
:* Returns the ID of the alias. Used by calls to [[GetNthAlias - Quest|GetNthAlias]] and [[GetAlias - Quest|GetAlias]] | |||
:'''[[RegisterForNiNodeUpdate]]()''' | |||
:*Registers the script for when a QueueNiNodeUpdate is called | |||
:'''[[UnregisterForNiNodeUpdate]]()''' | |||
:*Unregisters the script for when a QueueNiNodeUpdate is called | |||
== Events == | == Events == | ||
''' | :'''[[OnAnimationEvent - Form|OnAnimationEvent]](ObjectReference ''akSource'', String ''asEventName'')''' | ||
*Received when one of | :*Received when one of animation events we are listening for is received. | ||
''' | :'''[[OnAnimationEventUnregistered - Form|OnAnimationEventUnregistered]](ObjectReference ''akSource'', String ''asEventName'')''' | ||
*Received when the | :*Received when one of the animation events we are listening for has been automatically unregistered by the game due to the target animation graph unloading. | ||
''' | :'''[[OnGainLOS - Form|OnGainLOS]](Actor ''akViewer'', ObjectReference ''akTarget'')''' | ||
*Received when the viewer goes from seeing the target to | :*Received when the viewer goes from not seeing the target to seeing the target - if this alias is registered. | ||
''' | :'''[[OnLostLOS - Form|OnLostLOS]](Actor ''akViewer'', ObjectReference ''akTarget'')''' | ||
* | :*Received when the viewer goes from seeing the target to not seeing the target - if this alias is registered. | ||
''' | :'''[[OnReset - ObjectReference|OnReset]]()''' | ||
* | :*Event received when this object is reset ]](usually when the quest the alias is attached to starts up). | ||
''' | :'''[[OnSleepStart - Form|OnSleepStart]](Float ''afSleepStartTime'', Float ''afDesiredSleepEndTime'')''' | ||
*Received when the player | :*Received when the player goes to sleep. | ||
''' | :'''[[OnSleepStop - Form|OnSleepStop]](Bool ''abInterrupted'')''' | ||
*Received when | :*Received when the player wakes up or is interrupted in sleep. | ||
''' | :'''[[OnTrackedStatsEvent - Form|OnTrackedStatsEvent]](String ''asStat'', Int ''aiStatValue'')''' | ||
*Received | :*Received when tracked stats are updated. | ||
''' | :'''[[OnUpdate - Form|OnUpdate]]()''' | ||
*Received at periodic intervals of game time, if the alias is registered. | :*Received at periodic intervals, if the alias is registered. | ||
:'''[[OnUpdateGameTime - Form|OnUpdateGameTime]]()''' | |||
:*Received at periodic intervals of game time, if the alias is registered. | |||
== SKSE Events == | |||
'''[[OnNiNodeUpdate]](ObjectReference ''akActor'')''' | |||
==Notes== | ==Notes== | ||
*This object is often confused with [[ReferenceAlias Script]]. You probably mean to be using that. | :*This object is often confused with [[ReferenceAlias Script]]. You probably mean to be using that. | ||
[[Category:Scripting]] | |||
[[Category:Papyrus]] | |||
[[Category:Script Objects]] |
Latest revision as of 09:41, 20 July 2015
Native base script for every alias in the game. Don't confuse this for ReferenceAlias Script which you are more likely to use.
Definition[edit | edit source]
ScriptName Alias
Properties[edit | edit source]
None
Global Functions[edit | edit source]
None
Member Functions[edit | edit source]
- Quest GetOwningQuest()
- Returns the Quest that owns this alias.
- RegisterForAnimationEvent(ObjectReference akSender, String asEventName)
- Registers this alias to receive the specified animation event from the specified object.
- RegisterForLOS(Actor akViewer, ObjectReference akTarget)
- Registers this alias to receive gain and lost LOS events between the viewer and the target.
- RegisterForSingleLOSGain(Actor akViewer, ObjectReference akTarget)
- Registers this alias to receive a single LOS gain event when the viewer sees the target.
- RegisterForSingleLOSLost(Actor akViewer, ObjectReference akTarget)
- Registers this alias to receive a single LOS lost event when the viewer loses sight of the target.
- RegisterForSingleUpdate(Float afInterval)
- Registers this alias to receive a single update event in the specified time.
- RegisterForSingleUpdateGameTime(Float afInterval)
- Registers this alias to receive a single update event in the specified number of game hours.
- RegisterForSleep()
- Registers this alias to receive sleep events for when the player goes to sleep or wakes up.
- RegisterForTrackedStatsEvent()
- Registers this alias to receive tracked stats events for when tracked stats are updated.
- RegisterForUpdate(Float afInterval)
- Registers this alias to receive update events with the specified interval, or changes the update interval.
- RegisterForUpdateGameTime(Float afInterval)
- Registers this alias to receive update events with the specified interval in game time hours, or changes the update interval.
- StartObjectProfiling()
- Starts profiling all scripts attached to this alias.
- StopObjectProfiling()
- Stops profiling all scripts attached to this alias.
- UnregisterForAnimationEvent(ObjectReference akSender, String asEventName)
- Unregisters this alias from receiving the specified animation event from the specified object.
- UnregisterForLOS(Actor akViewer, ObjectReference akTarget)
- Unregisters this alias from any LOS events between the viewer and target.
- UnregisterForSleep()
- Unregisters this alias from sleep events.
- UnregisterForTrackedStatsEvent()
- Unregisters this alias from tracked stats events.
- UnregisterForUpdate()
- Unregisters this alias from update events.
- UnregisterForUpdateGameTime()
- Unregisters this alias from game time update events.
SKSE Member Functions[edit | edit source]
- String GetName()
- Returns the unique name of the alias (not its display name). Used by calls to GetAliasByName.
- Int GetID()
- Returns the ID of the alias. Used by calls to GetNthAlias and GetAlias
- RegisterForNiNodeUpdate()
- Registers the script for when a QueueNiNodeUpdate is called
- UnregisterForNiNodeUpdate()
- Unregisters the script for when a QueueNiNodeUpdate is called
Events[edit | edit source]
- OnAnimationEvent(ObjectReference akSource, String asEventName)
- Received when one of animation events we are listening for is received.
- OnAnimationEventUnregistered(ObjectReference akSource, String asEventName)
- Received when one of the animation events we are listening for has been automatically unregistered by the game due to the target animation graph unloading.
- OnGainLOS(Actor akViewer, ObjectReference akTarget)
- Received when the viewer goes from not seeing the target to seeing the target - if this alias is registered.
- OnLostLOS(Actor akViewer, ObjectReference akTarget)
- Received when the viewer goes from seeing the target to not seeing the target - if this alias is registered.
- OnReset()
- Event received when this object is reset ]](usually when the quest the alias is attached to starts up).
- OnSleepStart(Float afSleepStartTime, Float afDesiredSleepEndTime)
- Received when the player goes to sleep.
- OnSleepStop(Bool abInterrupted)
- Received when the player wakes up or is interrupted in sleep.
- OnTrackedStatsEvent(String asStat, Int aiStatValue)
- Received when tracked stats are updated.
- OnUpdate()
- Received at periodic intervals, if the alias is registered.
- OnUpdateGameTime()
- Received at periodic intervals of game time, if the alias is registered.
SKSE Events[edit | edit source]
OnNiNodeUpdate(ObjectReference akActor)
Notes[edit | edit source]
- This object is often confused with ReferenceAlias Script. You probably mean to be using that.