Form Script

Native base script for every form in the game.

Definition

ScriptName Form

Properties

None

Global Functions

None

Member Functions

int Function GetFormID()

• Returns this form's form ID.

int Function GetGoldValue()

• Returns this form's value in gold.

bool Function HasKeyword(Keyword akKeyword)

• Returns if this form has the specified Keyword attached.

Function PlayerKnows()

• Is the "Known" flag set on the form?

Function RegisterForAnimationEvent(ObjectReference akSender, string asEventName)

• Registers this form to receive the specified animation event from the specified object.

Function RegisterForLOS(Actor akViewer, ObjectReference akTarget)

• Registers this form to receive gain and lost LOS events between the viewer and the target.

Function RegisterForSingleLOSGain(Actor akViewer, ObjectReference akTarget)

• Registers this form to receive a single LOS gain event when the viewer sees the target.

Function RegisterForSingleLOSLost(Actor akViewer, ObjectReference akTarget)

• Registers this form to receive a single LOS lost event when the viewer loses sight of the target.

Function RegisterForSingleUpdate(float afInterval)

• Registers this form to receive a single update event in the specified time.

Function RegisterForSingleUpdateGameTime(float afInterval)

• Registers this form to receive a single update event in the specified number of game hours.

Function RegisterForSleep()

• Registers this form to receive sleep events for when the player goes to sleep or wakes up.

Function RegisterForTrackedStatsEvent()

• Registers this form to receive tracked stats events for when tracked stats are updated.

Function RegisterForUpdate(float afInterval)

• Registers this form to receive update events with the specified interval, or changes the update interval.

Function RegisterForUpdateGameTime(float afInterval)

• Registers this form to receive update events with the specified interval in game time hours, or changes the update interval.

Function StartObjectProfiling()

• Starts profiling all scripts attached to this form.

Function StopObjectProfiling()

• Stops profiling all scripts attached to this form.

Function UnregisterForAnimationEvent(ObjectReference akSender, string asEventName)

• Unregisters this from from receiving the specified animation event from the specified object.

Function UnregisterForLOS(Actor akViewer, ObjectReference akTarget)

• Unregisters this form from any LOS events between the viewer and target.

Function UnregisterForSleep()

• Unregisters this form from sleep events.

Function UnregisterForTrackedStatsEvent()

• Unregisters this form from tracked stats events.

Function UnregisterForUpdate()

• Unregisters this form from update events.

Function UnregisterForUpdateGameTime()

• Unregisters this form from game time update events.

SKSE Member Functions

int Function GetType()

• Returns this form's form typecode.

string Function GetName()

• Returns this form's full name.

Function SetName(string name)

• Sets this form's full name.

float Function GetWeight()

• Returns this form's weight.

Function SetWeight(float weight)

• Sets this form's weight.

Function SetGoldValue(int value)

• Sets this form's base gold value.

int Function GetNumKeywords()

• Returns the number of keywords on this form.

Keyword Function GetNthKeyword(int index)

• Returns the keyword specified by index on this form.

bool Function HasKeywordString(string s)

• Returns whether this form has a keyword with the specified string.

Function RegisterForKey(int keyCode)

• Registers the given DXScanCode for OnKeyDown and OnKeyUp events.

Function UnregisterForKey(int keyCode)

• Unregisters the given DXScanCode for OnKeyDown and OnKeyUp events.

Function UnregisterForAllKeys()

• Unregisters all registered DXScanCodes.

Function RegisterForControl(string control)

• Registers the given control for OnControlDown and OnControlUp events.

Function UnregisterForControl(string control)

• Unregisters the given control for OnControlDown and OnControlUp events.

Function UnregisterForAllControls()

• Unregisters all registered controls.

Function RegisterForMenu(string menuName)

• Registers for OnMenuOpen and OnMenuClose events for the given menu.

Function UnregisterForMenu(string menuName)

• Unregisters for OnMenuOpen and OnMenuClose events for the given menu.

Function UnregisterForAllMenus()

• Unregisters all registered menus.

Function RegisterForModEvent(string eventName, string callbackName)

• Registers a custom event callback for given event name.

Function SendModEvent(string eventName, string strArg = "", float numArg = 0.0)

• Sends a custom event with given generic parameters.

Function UnregisterForModEvent(string eventName)

• Unregisters a custom event callback for given event name.

Function UnregisterForAllModEvents()

• Unregisters all registered custom events.

Form Function TempClone()

• Returns a temporary clone of this form

Function RegisterForCameraState()

• Registers for OnPlayerCameraState events.

Function UnregisterForCameraState()

• Unregisters for OnPlayerCameraState events.

Function RegisterForCrosshairRef()

• Registers for OnCrosshairRefChange events.

Function UnregisterForCrosshairRef()

• Unregisters for OnCrosshairRefChange events.

Events

Event OnAnimationEvent(ObjectReference akSource, string asEventName)

• Received when one of animation events we are listening for is recieved.

Event 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.

Event OnGainLOS(Actor akViewer, ObjectReference akTarget)

• Received when the viewer goes from not seeing the target to seeing the target - if this form is registered.

Event OnLostLOS(Actor akViewer, ObjectReference akTarget)

• Received when the viewer goes from seeing the target to not seeing the target - if this form is registered.

Event OnSleepStart(float afSleepStartTime, float afDesiredSleepEndTime)

• Received when the player goes to sleep.

Event OnSleepStop(bool abInterrupted)

• Received when the player wakes up or is interrupted in sleep.

Event OnTrackedStatsEvent(string asStat, int aiStatValue)

• Received when tracked stats are updated.

Event OnUpdate()

• Received at periodic intervals, if the form is registered.

Event OnUpdateGameTime()

• Received at periodic intervals of game time, if the form is registered.

SKSE Events

Event OnKeyDown(int keyCode)

• Received when key(s) registered via RegisterForKey are pressed.

Event OnKeyUp(int keyCode, float holdTime)

• Received when key(s) registered via RegisterForKey are released.

Event OnControlDown(string control)

• Received when control(s) registered via RegisterForControl are pressed.

Event OnControlUp(string control, float holdTime)

• Received when control(s) registered via RegisterForControl are released.

Event OnMenuOpen(string menuName)

• Received when menu(s) registered via RegisterForMenu are opened.

Event OnMenuClose(string menuName)

• Received when menu(s) registered via RegisterForMenu are closed.

Event OnPlayerCameraState(int oldState, int newState)

• Received when (player camera state changes?) when registered via RegisterForCameraState

Event OnCrosshairRefChange(ObjectReference ref)

• Received when player crosshair changes when registered via RegisterForCrosshairRef (Note: ref is none for no target)(Note:Crosshair uses activate pick)