USERAPI EquipItemByLink

This page documents a user-defined function that you can copy and paste into your addon. Replace PREFIX with your addon or lib prefix to avoid conflicts between different versions of these functions.

← User defined functions

Reference  e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

→ Snippets

Equips the first matching item found in the player's bags (including the bank and bank bags).

Checks the bank first, then carry-ons, then bank bags.

local function EquipItemByLink(link)
  for bag=BANK_CONTAINER, NUM_BAG_SLOTS+NUM_BANKBAGSLOTS do
    for slot=1,GetContainerNumSlots(bag) do
      local item = GetContainerItemLink(bag, slot)
      if item and item == link then
        if CursorHasItem() or CursorHasMoney() or CursorHasSpell() then ClearCursor() end
        PickupContainerItem(bag, slot)
        AutoEquipCursorItem()
        return true
      end
    end
  end
end