Returns whether an item is currently equipped


See also Item functions, Inventory functions.

Signature:

isEquipped = IsEquippedItem(itemID) or IsEquippedItem("itemName") or IsEquippedItem("itemLink")

Arguments:

  • itemID - An item's ID (number)
  • itemName - An item's name (string)
  • itemLink - An item's hyperlink, or any string containing the itemString portion of an item link (string)

Returns:

  • isEquipped - 1 if the item is equipped on the player character; otherwise nil (1nil)

Examples:

-- Check to see if your Alliance PvP trinket is equipped
IsEquippedItem("Medallion of the Alliance") then
  print("Your PvP trinket is already equipped.")
else
  print("*** Make sure to equip your PvP trinket ***")
end

-- Check to see if Staff of Infinite Mysteries (itemId 28633) is equipped
if IsEquippedItem(28633) then
  print("Your staff is equipped")
else
  print("Your staff is not equipped")
end