Bridge Events

Bridge Events transform raw WoW API events into achievement-focused signals with structured payloads.

Event Categories

Category	Events	Purpose
Dungeon	5	Boss kills, clears, mechanics
PVP	7	Kills, battlegrounds, arenas
Professions	5	Crafting, gathering, skill-ups
Quests	2	Quest completion, reputation
Items	4	Badges, keys, gear
World	4	Exploration, gold, leveling
Special	1	Weekly resets

Registering Event Callbacks

local Private = select(2, ...)

Private.EventBridge:RegisterEvent("DUNGEON_BOSS_KILLED", function(payload)
  print("Killed: " .. payload.bossName)
  print("Duration: " .. payload.duration .. " seconds")
end)

Using Events in Achievements

Events are referenced in the trigger field. Payload values are numbers/enums, but conditions can use functions to evaluate them:

local Enums = Private.Enums

Private.AchievementUtils:RegisterAchievements({
  {
    id = 1,
    name = "Shadow Labs",
    description = "Defeat Murmur in Shadow Labyrinth",
    points = 5,
    category = 1,
    icon = 136200,
    cadence = Enums.Cadence.AllTime,
    trigger = {
      event = "DUNGEON_BOSS_KILLED",
      conditions = {
        bossName = "Murmur",
        difficulty = Enums.Difficulty.Normal
      }
    }
  }
})

All Events

Dungeon

• DUNGEON_BOSS_KILLED — Boss defeated
• DUNGEON_CLEARED — All bosses killed
• DUNGEON_ENCOUNTER_START — Boss pull initiated
• DUNGEON_MECHANIC_FAILED — Player failed mechanic
• INSTANCE_ENTERED — Entered instance

PVP

• PVP_KILL — Honorable kill earned
• PVP_KILLING_BLOW — Final blow on enemy
• BATTLEGROUND_MATCH_END — BG match completed
• ARENA_MATCH_END — Arena match completed
• ARENA_RATING_MILESTONE — Rating threshold reached
• PVP_OBJECTIVE_CAPTURED — Flag/base captured
• PVP_TOKEN_EARNED — PVP token looted

Professions

• ITEM_CRAFTED — Item created
• RESOURCE_GATHERED — Node harvested
• SKILL_UP — Skill level increased
• ITEM_DISENCHANTED — Item disenchanted
• FISH_CAUGHT — Fish caught

Quests

• QUEST_COMPLETED — Quest turned in
• REPUTATION_GAINED — Rep increased

Items

• BADGE_EARNED — Badge of Justice looted
• KEY_OBTAINED — Dungeon key acquired
• EPIC_GEAR_EQUIPPED — Epic item equipped
• LOOT_ROLL_WON — Won a loot roll

World

• ZONE_EXPLORED — New zone discovered
• GOLD_MILESTONE — Gold threshold reached
• LEVEL_UP — Character leveled
• CREATURE_KILLED — Monster killed

Special

• WEEKLY_RESET — Server reset occurred