Skip to content

INSTANCE_ENTERED ​

Fired when a player enters an instance.

Payload ​

lua
{
  instance = string,               -- "Karazhan"
  instanceId = number,             -- Map ID
  difficulty = Enums.Difficulty,   -- .Normal or .Heroic
  raidSize = number,               -- Group size
  timestamp = number               -- Entry time
}

Usage ​

This event is used for:

  • Tracking instance visits
  • Initializing dungeon state
  • Instance exploration achievements

Example ​

Instance Visit Counter ​

lua
{
  id = 300,
  name = "Frequent Flyer",
  description = "Enter 100 Heroic instances",
  points = 20,
  category = 5,
  icon = 136168,
  cadence = Enums.Cadence.AllTime,
  trigger = {
    event = "INSTANCE_ENTERED",
    conditions = {
      difficulty = Enums.Difficulty.Heroic
    }
  },
  progress = {
    type = "count",
    required = 100
  }
}