Background for Skyrim SE
Member of the Actor script
eventOnCombatStateChanged(ActorakTarget, intaeCombatState)

Description

Wiki Description

Event called when this actor's combat state changes.

Documentation Comment

Event that is triggered when this actor's combat state against the target changes
State is as follows:
0 - not in combat
1 - in combat
2 - searching


Caveats

CK Wiki - Notes

  • This event will not work to detect when the player changes combat states. It can only detect combat state changes for other actors.
  • Bleeding out fires this event with CombatState = 0
  • Combat state changes can only be detected by an Actor that is on the ground in contact with a navmesh. State changes cannot be detected on dragons while still in flight.

Parameters

  1. ActorakTarget

    CK Wiki Description

    The Actor that this actor is targeting. May be None if this actor is leaving combat.

  2. intaeCombatState

    CK Wiki Description

    The combat state we just entered, which will be one of the following:* 0:Not in combat

    • 1:In combat
    • 2:Searching

Examples

Event OnCombatStateChanged(Actor akTarget, int aeCombatState)
  if (akTarget == Game.GetPlayer())
    if (aeCombatState == 0)
      Debug.Trace("We have left combat with the player!")
    elseif (aeCombatState == 1)
      Debug.Trace("We have entered combat with the player!")
    elseif (aeCombatState == 2)
      Debug.Trace("We are searching for the player...")
    endIf
  endIf
endEvent

Auto-Generated Example

Scriptname MyCoolScript extends Actor

event OnCombatStateChanged(Actor akTarget, int aeCombatState)
    Debug.trace("Event received - OnCombatStateChanged: akTarget = " + akTarget + " aeCombatState = " + aeCombatState)
endEvent

Related Pages


Additional References

View this event’s page on the Skyrim Creation Kit Wiki

Some data provided by the Skyrim Creation Kit Wiki. Licensed under the Creative Commons Attribution-ShareAlike license.