Events

Frame Events are messages sent by the WoW client to UI code (via script handlers), mostly in reaction to things occurring in the game world. For a general tutorial on setting up event handling in your addon, see Handling events and the method.

Event Trace

• The Event Trace window for debugging events can be opened via the slash command.

Example

• Shows when a chat channel message appears and when you start/stop moving.

• : achievementID, alreadyEarned
• : achievementID
• : criteriaID
• : achievementID, description
• : guid
• : achievementID
• : achievementID, added
• : achievementID, criteriaID, elapsed, duration

• : slot, isInRange, checksRange
• : slot

• : addOnName, containsBindings
• : closingClient
• : addOnName

• : lfgDungeonID
• : battleMasterListID
• : questID, uiMapID
• : lfgDungeonID
• : newAdventureNotice

• : followerTypeID
• : questID

• : raceID

• : info

• : numRefundedPowers, refundedTier, bagOrSlotIndex, slotIndex
• : newTier, bagOrSlotIndex, slotIndex
• : newItem

• : auctionID
• : auctionID
• : auctionID
• : addedBrowseResults
• : purchasedItemDeliveryDelay, cancelledItemDeliveryDelay
• : auctionID
• : itemKey
• : auctionID
• : commodityName, commodityQuantity
• : error
• : notification, text, auctionID
• : notification
• : numRepetitions
• : createdCount, totalToCreate
• : bidID
• : updatedUnitPrice, updatedTotalPrice
• : itemID, quantity
• : itemID
• : itemID
• : itemID
• : itemID
• : itemID
• : itemKey
• : itemKey, newAuctionID
• : auctionID, bidderName

• : isHeartEquipped
• : azeriteEmpoweredItemLocation

• : slot, essenceID
• : slot, essenceID
• : essenceID, newRank
• : milestoneID
• : essenceID

• : enabled
• : azeriteItemLocation, oldExperienceAmount, newExperienceAmount
• : azeriteItemLocation, oldPowerLevel, newPowerLevel, unlockedEmpoweredItemsInfo, azeriteItemID

• : slot
• : slot
• : slot

• : success

• : owner, petIndex, abilityID
• : owner, petIndex, auraInstanceID
• : owner, petIndex, auraInstanceID
• : owner, petIndex, auraInstanceID
• : owner, petIndex
• : owner
• : owner, petIndex, healthChange
• : owner, petIndex, newLevel
• : owner, petIndex, healthChange
• : abilityIndex
• : owner
• : roundNumber
• : roundNumber
• : owner, petIndex, stateValue
• : fullName
• : owner, petIndex, xpChange

• : notificationType, dbId

• : marketID, resultCode
• : marketID, itemID
• : marketID, itemID

• : errorCode

• : pending
• : title, hour, minute
• : isCopy
• : calendarType
• : errorReason
• : errorReason, count
• : errorReason, playerName
• : hasCompleteList

• : keystoneID
• : mapID
• : mapID

• : prefix, text, channel, senderID
• : whisperTarget, status
• : languageId, canSpeakLanguage
• : displayIndex, count
• : displayIndex
• : channelID, name
• : chatChannelID, name
• : channelID
• : displayIndex, count
• : CHAT_MSG
• : CHAT_MSG
• : prefix, text, channel, sender, target, zoneChannelID, localID, name, instanceID
• : prefix, text, channel, sender, target, zoneChannelID, localID, name, instanceID
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : channelName
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : CHAT_MSG
• : isServiceAvailable
• : isInitialMessage
• : text, playerName, displayTime, enableBossEmoteWarningSound
• : text, playerName, displayTime, enableBossEmoteWarningSound
• : text, playerName, displayTime, enableBossEmoteWarningSound
• : mapname, timeLeft, locked, extended
• : name, r, g, b
• : name, colorNameByClass

• : canBeCancelled, forcedAspectRatio
• : movieID

• : configID

• : showHighlights

• : sceneType

• : clubType
• : clubId
• : action, error, clubType
• : invitation
• : invitationId
• : clubId
• : clubId, memberId
• : clubId, memberId, presence
• : clubId, memberId
• : clubId, memberId, roleId
• : clubId, memberId
• : clubId, streamId, messageId
• : clubId, streamId, downloadedRange, contiguousRange
• : clubId, streamId, messageId
• : clubId
• : clubName, clubRemovedReason
• : clubId, roleId
• : clubId, streamId
• : clubId, streamId
• : clubId, streamId
• : clubId, streamId
• : clubId, streamId
• : clubId
• : clubId, ticketInfo
• : ticket
• : clubId
• : clubId
• : clubId, streamId, lastReadTime

• : clubFinderGUIDs
• : type, clubFinderGUIDs
• : applicant
• : type
• : type, clubFinderGUID
• : clubId
• : clubInfo
• : type
• : clubFinderGUIDs
• : type
• : type

• : combatTextType

• : fov
• : nameToOverride, overrideName
• : teamName
• : swapped

• : message
• : message, colorType
• : eventName, value
• : message
• : showConsole

• : bagID
• : bagID
• : slot
• : bagID
• : slot
• : slot
• : expandBagBar
• : bagOrSlotIndex, slotIndex
• : bagOrSlotIndex, slotIndex
• : bagOrSlotIndex, slotIndex
• : useCombinedBags

• : isEnabled
• : type, id, isTracked
• : type, id
• : targetType, targetID

• : state, result, name, contributionID
• : contributionID, isPending, result
• : contributionID

• : callings

• : previewInfo

• : newRenownLevel, oldRenownLevel

• : covenantID

• : result, orderID
• : orderID
• : orderTypeString, itemNameString, playerNameString, tipAmount, quantityCrafted
• : result, orderID
• : result
• : result
• : result, orderID
• : result, orderID
• : customerName, orderID
• : orderType, numOrders

• : currencyType, quantity, quantityChange, quantityGainSource, quantityLostSource

• : isDefault, newCursorType, oldCursorType, oldCursorVirtualID
• : anchorType

• : hasFreeRepop
• : isGossipTriggered
• : inviter

• : playerName
• : playerName

• : layoutInfo, reconcileLayouts

• : encounterID, encounterName
• : encounterID, encounterName, difficultyID, groupSize, success
• : encounterID, encounterName, difficultyID, groupSize

• : difficultyID
• : itemID

• : result, setID

• : link

• : type, show

• : name
• : blockType
• : senderID
• : suppressNotification
• : id
• : result, suppressNotification
• : friendId, isCompanionApp
• : friendId, isCompanionApp
• : friendIndex
• : accountID
• : listSize
• : accountID
• : name

• : name, info
• : invitedByGUID
• : hasTicket, numTickets, ticketStatus, caseIndex, waitTimeMinutes, waitMessage

• : isActive
• : powerLevel

• : followerTypeID
• : buildingName, garrisonType
• : garrisonPlotInstanceID, garrisonBuildingID
• : categoryID
• : garrisonPlotInstanceID, newPlacement
• : garrPlotInstanceID, garrBuildingID
• : garrisonBuildingID, garrPlotInstanceID
• : followerDbID, followerName, followerClassName, followerLevel, followerQuality, isUpgraded, textureKit, followerTypeID
• : garrFollowerTypeID, followerDbID, followerDurability
• : followerID
• : followerTypeID
• : followerTypeID
• : followerDbID
• : garrFollowerTypeID, followerDbID, xpChange, oldFollowerXp, oldFollowerLevel, oldFollowerQuality
• : garrisonMissonBonusAbilityID
• : missionID, success
• : missionID, canComplete, success, bonusRollSuccess, followerDeaths, autoCombatResult
• : followerTypeID, missionID
• : garrFollowerTypeID
• : followerTypeID
• : missionID, followerDbID
• : garrFollowerTypeID, missionID
• : success
• : success
• : success
• : followerTypeID, missionID
• : success, recallPortalLastUsedTime
• : success
• : followerTypeID
• : followerTypeID
• : garrTypeID, specID
• : garrTypeID
• : garrTypeID, doAlert
• : eventType, eventID
• : garrisonTypeID, garrisonTalentTreeID
• : garrTypeID, garrisonTalentTreeID, garrTalentID
• : garrTypeID
• : garrisonUpgradeable
• : success, shipmentCount, maxShipments, ownedShipments, plotInstanceID
• : charShipmentContainerID
• : shipmentStarted, hasAttachedFollower

• : info

• : spellID
• : spellID

• : gossipID, text, cost
• : gossipID
• : uiTextureKit

• : guildBankTab
• : guildBankTab

• : challengeType, currentCount, maxCount, goldAwarded
• : inviter, guildName, guildAchievementPoints, oldGuildName, isNewGuild, tabardInfo
• : motdText
• : inGuildParty
• : flagSet
• : canRequestRosterUpdate
• : unitTarget
• : success

• : pendingHeirloomUpgradeSpellcast
• : itemID, updateReason, hideUntilLearned

• : timeRemaining
• : objectiveID
• : objectiveID, objectiveProgress
• : objectiveID, objectiveProgress

• : amount, gainedByPlayer, factionIndex, gainedBy, gainedFrom

• : fixupVersion
• : itemName, qualityID, bonding, questWarn
• : reason
• : itemID, success
• : previousHyperlink, newHyperlink
• : itemGUID
• : itemID
• : itemID, success
• : itemLink
• : existingStr, replacementStr
• : existing, replacement
• : existing, replacement

• : itemLocation

• : delay

• : key, down

• : mapID, winner
• : reason, subReason1, subReason2
• : name, lfgDungeonsID, typeID
• : dungeonID
• : name
• : name
• : isRequeue
• : name, isTank, isHealer, isDamage
• : isRequeue
• : mapID, winner

• : listingName, automaticDelistTimeRemaining
• : created
• : newPendingEntry, newPendingEntryWithData
• : applicantID
• : searchResultID, newStatus, oldStatus, groupName
• : searchResultID, groupName
• : reason
• : searchResultID

• : powerID
• : isUpgrade
• : powerID

• : itemLink
• : typeIdentifier, itemLink, quantity, specID, sex, personalLootToast, currencyID, isSecondaryResult, corrupted
• : rollID
• : rollID, rollType
• : rollID, rollType, confirmReason
• : encounterID, itemID, itemLink, quantity, itemName, fileName
• : itemID, quantity
• : bagSlot, iconFileID
• : lootSlot
• : itemTooltip, lootHandle
• : itemLink, rollQuantity, rollType, roll, upgraded
• : autoLoot, isFromItem
• : autoloot
• : lootHandle
• : lootSlot
• : lootSlot
• : rollID, roll, isWinning
• : typeIdentifier, itemLink, quantity
• : questID, currencyId, quantity
• : questID, itemLink, quantity
• : typeIdentifier, itemLink, quantity, specID, sex, personalLootToast, toastMethod, lessAwesome, upgraded, corrupted
• : itemLink
• : itemLink, quantity, specID, sex, baseQuality, personalLootToast, lessAwesome
• : typeIdentifier, itemLink, quantity, specID, sex, personalLootToast, lessAwesome
• : typeIdentifier, itemLink, quantity, specID, sex, personalLootToast, lessAwesome
• : rollID, rollTime, lootHandle

• : encounterID
• : encounterID, lootListID
• : encounterID

• : campaignID, textEntries

• : unitTarget, effectIndex
• : victim, effectIndex
• : victim
• : unitTarget

• : chatLine

• : mailIndex
• : itemID
• : attachSlot, itemLink
• : itemID

• : majorFactionID, newRenownLevel, oldRenownLevel
• : majorFactionID

• : uiMapID

• : itemID

• : unitTarget, y, x

• : success
• : mountID

• : mapChallengeModeID, completionMilliseconds, level

• : namePlateFrame
• : unitToken
• : unitToken
• : namePlateFrame
• : unitToken
• : unitToken

• : region

• : change
• : tierIndex
• : slot
• : inspecteeGUID
• : equipmentSlot, hasCurrent
• : skillLineID, isTool

• : gameAccountID, questSessionActive, tank, healer, dps
• : category, partyGUID
• : category, partyGUID
• : category, partyGUID
• : targetName, willConvertToRaid, questSessionActive
• : targetName, targetGUID, willConvertToRaid, questSessionActive
• : name, isTank, isHealer, isDamage, isNativeRealm, allowMultipleRoles, inviterGUID, questSessionActive
• : unitTarget
• : unitTarget
• : initiatorName, readyCheckTimeLeft
• : unitTarget, isReady
• : preempted
• : targetName, partyLevelLink, questSessionActive, tank, healer, dps
• : changedName, fromName, oldRole, newRole
• : fromName
• : name, resultGUID

• : mapID, won

• : trackedPerksActivities
• : info
• : perksActivityID

• : vendorItemID
• : value
• : oldValue, newValue
• : vendorItemID
• : vendorItemID
• : vendorItemID
• : vendorItemID
• : vendorItemID

• : delay
• : name, declinedName1, declinedName2, declinedName3, declinedName4, declinedName5

• : name, battlePetGUID
• : companionType
• : battlePetGUID
• : slotIndex, battlePetGUID
• : battlePetGUID
• : battlePetGUID
• : battlePetGUID
• : trapLevel

• : region, uiTextureKit, isWorldPoint
• : region
• : region, state
• : region

• : type
• : type

• : skillLineID, tradeSkillID

• : unitToken, updateReason
• : isArena, battleMasterListID
• : isHigherLevel
• : offender, numBlackMarksOnOffender, numPlayersIHaveReported
• : reward
• : winner, duration
• : readyCheckInfo
• : readyCheckInfo
• : wargameBattlegrounds, ratedBattlegrounds, ratedArenas, ratedSoloShuffle
• : battleFieldIndex
• : warModeEnabled
• : opposingPartyMemberName, battlegroundName, timeoutSeconds, tournamentRules

• : questId
• : questId
• : questID, success
• : questStartItemID
• : questID, specificTreeID, description, numFulfilled, numRequired
• : questID, wasReplayQuest
• : questID, xpReward, moneyReward
• : questID, added
• : questID
• : requestRequired
• : questID

• : name, questTitle

• : enabled
• : guid, response
• : result, guid

• : info
• : enabled
• : enabled
• : systemInfo

• : success, reportType

• : numFindsCompleted, totalFinds, researchBranchID
• : numFindsCompleted, totalFinds, researchBranchID, successfulFind
• : researchBranchID
• : name

• : isTainted, function
• : isTainted, function
• : function
• : function

• : level, type
• : bonusObjectiveID
• : questID, xp, money
• : show
• : criteriaID
• : newStep

• : index

• : warnType, warningText

• : groupGUID, numAddedItems

• : disabled
• : disabled

• : soulbindID
• : conduitID
• : collectionData
• : nodeID, data
• : nodeID, data
• : nodeID
• : nodeID
• : nodeID
• : nodeID, conduitID

• : soundHandle

• : curr, prev
• : cost, respecType
• : isPet
• : isPetTalents

• : spellID, success

• : spellID
• : spellID
• : spellID
• : spellID, overlayFileDataID, locationName, scale, r, g, b

• : cancelledCast
• : spellID, skillInfoIndex, isGuildPerkSpell
• : clampedNewQueueWindowMs
• : totemSlot
• : flyoutID, spellID, isLearned
• : spellID, slot, page
• : spellID
• : unit, target, castGUID, spellID

• : info

• : errorMessage
• : button
• : button
• : result
• : isInitialLogin, isReloadingUi
• : streamingStatus
• : string, r, g, b
• : totalTimePlayed, timePlayedThisLevel
• : errorType, message
• : errorType, message
• : errorType, message

• : system

• : hyperlink
• : dataInstanceID

• : itemID
• : itemID, isNew, hasFanfare

• : playerAccepted, targetAccepted
• : tradeSlotIndex
• : canBecomeBoundForTrade
• : itemLink, tradeSlotIndex
• : name
• : tradeSlotIndex

• : recipeID, recipeLevel, baseRecipeID
• : recipeID, skillLineID, expansionSkillLineID
• : recipeID, tracked
• : recipeSpellID
• : itemID
• : data
• : data
• : itemGUID
• : isScrapping

• : configID
• : condID
• : configInfo
• : configID
• : configID
• : nodeID
• : ID, info
• : nodeEntryID
• : treeID
• : treeID
• : treeID

• : itemModifiedAppearanceID
• : itemModifiedAppearanceID
• : collectionIndex, modID, itemAppearanceID, reason
• : itemModifiedAppearanceID
• : searchType, collectionType
• : itemModifiedAppearanceID, collectable
• : transmogLocation
• : transmogLocation, action

• : spellID, tutorialGlobalStringTag
• : tutorialIndex, forceShow

• : widgetInfo

• : unitTarget, updateInfo

• : unitTarget, vehicleUIIndicatorID
• : unitTarget
• : unitTarget, showVehicleFrame, isControlSeat, vehicleUIIndicatorID, vehicleGUID, mayChooseExit, hasPitch
• : unitTarget, showVehicleFrame, isControlSeat, vehicleUIIndicatorID, vehicleGUID, mayChooseExit, hasPitch
• : unitTarget
• : unitTarget
• : shouldShow
• : shouldShow

• : vignetteGUID, onMinimap

• : isSpeaking, energy
• : channelID
• : channelID
• : channelID, channelDisplayName
• : status, channelID, channelType, clubId, streamId
• : memberID, channelID, isActive
• : memberID, channelID
• : memberID, channelID, speakingEnergy
• : memberID, channelID
• : memberID, channelID, isMutedForAll
• : memberID, channelID, isMutedForMe
• : memberID, channelID
• : memberID, channelID, isSilenced
• : memberID, channelID, isSpeaking
• : memberID, channelID, message, language
• : memberID, channelID, volume
• : channelID, isMuted
• : channelID, pushToTalkSetting
• : channelID
• : channelID, isTranscribing
• : channelID, isTransmitting
• : channelID, volume
• : communicationMode
• : isDeafened
• : platformCode, statusCode
• : status
• : status
• : isMuted
• : channelType, clubId, streamId, pendingJoin
• : isPressed
• : isSilenced
• : status, utteranceID, destination
• : numConsumers, utteranceID, destination
• : numConsumers, utteranceID, durationMS, destination
• : status, utteranceID

• : slot, link
• : slot

• : timerType, timeRemaining, totalTime
• : timerType
• : timerID
• : timerID

• : entitlementType, textureID, name, payloadID, showFancyToast
• : entitlementType, textureID, name, payloadID, showFancyToast, rafVersion

• : result
• : result
• : result
• : result
• : choiceType
• : result, choiceType
• : result

• : type

• : unitTarget
• : unitTarget, spellID
• : name
• : areaName
• : summonReason, skippingStartExperience
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : timerName, paused
• : timerName, value, maxValue, scale, paused, timerLabel
• : timerName
• : success
• : guid
• : guid
• : canGlide
• : unitTarget
• : unitTarget
• : oldLevel, newLevel, real
• : level, healthDelta, powerDelta, numNewTalents, numNewPvpTalentSlots, strengthDelta, agilityDelta, staminaDelta, intellectDelta
• : unitTarget
• : unitTarget
• : oldTarget, newTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : points
• : unitTarget
• : runeIndex, added
• : runeIndex
• : spellID, effectValue, message, duration, currencyTypesID, currencyCost, currentDifficulty
• : spellID, effectValue
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget, event, flagText, amount, schoolMask
• : unitTarget, isConnected
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget, isInDistance
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget, isInRange
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget, powerType
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget, powerType
• : unitTarget
• : unitTarget, powerType
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget, castGUID, spellID
• : unitTarget, castGUID, spellID
• : unitTarget, castGUID, spellID
• : unitTarget, castGUID, spellID
• : unitTarget, castGUID, spellID
• : unitTarget, castGUID, spellID, complete
• : unitTarget, castGUID, spellID
• : unitTarget, castGUID, spellID
• : unitTarget, castGUID, spellID
• : unitTarget, castGUID, spellID
• : unitTarget
• : unitTarget
• : unitTarget, castGUID, spellID
• : unitTarget, castGUID, spellID
• : unitTarget, castGUID, spellID
• : unitTarget, castGUID, spellID
• : unitTarget, castGUID, spellID
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : unitTarget
• : normalizedPitch, radians

Not all events are documented in Blizzard API Documentation