LibItemUpgradeInfo-1.0

LibItemUpgradeInfo-1.0 provides information about item upgrades applied to items.

Functions

:GetUpgradeID(itemString)

Arguments

itemString

String – An itemLink or itemString denoting the item

Returns

upgradeID

Number – The upgrade ID (possibly 0), or nil if the input is invalid or does not contain upgrade info

:GetCurrentUpgrade(id)

Returns the current upgrade level of the item, e.g. 1 for a 1/2 item.

Arguments

id

Number – The upgrade ID of the item (obtained via GetUpgradeID())

Returns

upgradeLevel

Number – The current upgrade level of the item, or nil if the item cannot be upgraded

:GetMaximumUpgrade(id)

Returns the maximum upgrade level of the item, e.g. 2 for a 1/2 item.

Arguments

id

Number – The upgrade ID of the item (obtained via GetUpgradeID())

Returns

upgradeLevel

Number – The maximum upgrade level of the item, or nil if the item cannot be upgraded

:GetItemLevelUpgrade(id)

Returns the item level increase that this upgrade is worth, e.g. 4 for a 1/2 item or 8 for a 2/2 item.

Arguments

id

Number – The upgrade ID of the item (obtained via GetUpgradeID())

Returns

ilvlDelta

Number – The item level increase of the item, or 0 if the item cannot be or has not been upgraded

:GetItemUpgradeInfo(itemString)

Returns the current upgrade level, maximum upgrade level, and item level increase for an item.

Arguments

itemString

String – An itemLink or itemString denoting the item

Returns

nil if the item is invalid or cannot be upgraded, otherwise:

curUpgradeLevel

Number – The current upgrade level of the item

maxUpgradeLevel

Number – The maximum upgrade level of the item

lvlDelta

Number – The item level increase of the item

:GetHeirloomTrueLevel(itemString)

Returns the true item level for an heirloom.

Arguments

itemString

String – An itemLink or itemString denoting the item

Returns

ilvl

Number – The true item level of the item, or nil if the input is invalid

isTrue

Boolean – true if the returned item level is the "true" item level of an heirloom, or false if the item was not an heirloom or some error occurred while scanning the tooltip.

:GetUpgradedItemLevel(itemString)

Returns the true item level of the item, including upgrades and heirlooms.

Arguments

itemString

String – An itemLink or itemString denoting the item

Returns

ilvl

Number – The true item level of the item, or nil if the input is invalid

:IsBop(itemString)

Checks if an item is Bind On Pikcup.

Arguments

itemString

String – An itemLink or itemString denoting the item

Returns

flag

Boolean – True if item is Bind on Pickup

:IsBoe(itemString)

Checks if an item is Bind On Equip.

Arguments

itemString

String – An itemLink or itemString denoting the item

Returns

flag

Boolean – True if item is Bind on Equip

Example

local ItemUpgradeInfo = LibStub("LibItemUpgradeInfo-1.0")
local item = GetInventoryItemLink("player", 1)
local upgrade, max, delta = ItemUpgradeInfo:GetItemUpgradeInfo(item)
if upgrade then
	local ilvl = ItemUpgradeInfo:GetUpgradedItemLevel(item)
	DEFAULT_CHAT_FRAME:AddMessage(("%s %d/%d (+%d -> %d)"):format(item, upgrade, max, delta, ilvl))
else
	DEFAULT_CHAT_FRAME:AddMessage(item .. " cannot be upgraded")
end

Same code using the GetItemUpgradeInfo() convenience function:

local ItemUpgradeInfo = LibStub("LibItemUpgradeInfo-1.0")
local item = GetInventoryItemLink("player", 1)
local upgrade, max, delta = ItemUpgradeInfo:GetItemUpgradeInfo(item)
if upgrade then
	local ilvl = ItemUpgradeInfo:GetUpgradedItemLevel(item)
	DEFAULT_CHAT_FRAME:AddMessage(("%s %d/%d (+%d -> %d)"):format(item, upgrade, max, delta, ilvl))
else
	DEFAULT_CHAT_FRAME:AddMessage(item .. " cannot be upgraded")
end