StatLogicLib

API Documentation

:BuildGemmedTooltip(item , red , yellow , blue , meta)

<font size="3">Arguments</font>

item

number or string or table – tooltip or itemId or "itemString" or "itemName" or "itemLink"

red

number or string – gemID to replace a red socket

yellow

number or string – gemID to replace a yellow socket

blue

number or string – gemID to replace a blue socket

meta

number or string – gemID to replace a meta socket

<font size="3">Notes</font>

• Returns a modified link with all empty sockets replaced with the specified gems, sockets already gemmed will remain.
• item:

tooltip

table – The tooltip showing the item

itemId

number – The numeric ID of the item. ie. 12345

"itemString"

string – The full item ID in string format, e.g. "item:12345:0:0:0:0:0:0:0".

Also supports partial itemStrings, by filling up any missing ":x" value with ":0", e.g. "item:12345:0:0:0"

"itemName"

string – The Name of the Item, ex: "Hearthstone"

The item must have been equiped, in your bags or in your bank once in this session for this to work.

"itemLink"

string – The itemLink, when Shift-Clicking items.

<font size="3">Returns</font>

link

string – modified item link

<font size="3">Example</font>

local link = StatLogic:BuildGemmedTooltip(28619, 3119, 3119, 3119, 3119)
StatLogic:SetTip("item:28619")
StatLogic:SetTip(StatLogic:BuildGemmedTooltip(28619, 3119, 3119, 3119, 3119))

string or number

:GetAPFromAgi(agi [, class])

<font size="3">Arguments</font>

agi

number – Agility

class

string or number – ClassID or "ClassName". Default: PlayerClass
See :GetClassIdOrName(class) for valid class values.

<font size="3">Notes</font>

• Calculates the attack power from agility for given class.

<font size="3">Returns</font>

ap

number – Attack power

statid

string – "AP"

<font size="3">Example</font>

local ap = StatLogic:GetAPFromAgi(1) -- GetAPPerAgi
local ap = StatLogic:GetAPFromAgi(10)
local ap = StatLogic:GetAPFromAgi(10, "WARRIOR")

string or number

:GetAPFromStr(str [, class])

<font size="3">Arguments</font>

str

number – Strength

class

string or number – ClassID or "ClassName". Default: PlayerClass
See :GetClassIdOrName(class) for valid class values.

<font size="3">Returns</font>

ap

number – Attack power

statid

string – "AP"

Examples:
local ap = StatLogic:GetAPFromStr(1) — GetAPPerStr
local ap = StatLogic:GetAPFromStr(10)
local ap = StatLogic:GetAPFromStr(10, "WARRIOR")

string or number

:GetAPPerAgi([class])

<font size="3">Arguments</font>

class

string or number – ClassID or "ClassName". Default: PlayerClass
See :GetClassIdOrName(class) for valid class values.

<font size="3">Notes</font>

• Gets the attack power per agility for given class.
• Player level does not effect attack power per agility.
• Will check for Cat Form.

<font size="3">Returns</font>

ap

number – Attack power per agility

statid

string – "AP"

<font size="3">Example</font>

local apPerAgi = StatLogic:GetAPPerAgi()
local apPerAgi = StatLogic:GetAPPerAgi("ROGUE")

string or number

:GetAPPerStr([class])

<font size="3">Arguments</font>

class

string or number – ClassID or "ClassName". Default: PlayerClass
See :GetClassIdOrName(class) for valid class values.

<font size="3">Notes</font>

• Returns the attack power per strength for given class.
• Player level does not effect attack power per strength.

<font size="3">Returns</font>

ap

number – Attack power per strength

statid

string – "AP"

<font size="3">Example</font>

local ap = StatLogic:GetAPPerStr()
local ap = StatLogic:GetAPPerStr("WARRIOR")

string or number

:GetAvoidanceAfterDR("avoidanceType" , avoidanceBeforeDR [, class])

<font size="3">Arguments</font>

"avoidanceType"

string – "DODGE", "PARRY", "MELEE_HIT_AVOID"(NYI)

avoidanceBeforeDR

number – amount of avoidance before diminishing returns in percentages.

class

string or number – ClassID or "ClassName". Default: PlayerClass
See :GetClassIdOrName(class) for valid class values.

<font size="3">Notes</font>

• Avoidance DR formula and k, C_p, C_d constants derived by Whitetooth (hotdogee [at] gmail [dot] com)
• avoidanceBeforeDR is the part that is affected by diminishing returns.
• See :GetClassIdOrName(class) for valid class values.
• Calculates the avoidance after diminishing returns, this includes:
  1. Dodge from Dodge Rating, Defense, Agility.
  2. Parry from Parry Rating, Defense.
  3. Chance to be missed from Defense.
• The DR formula: 1/x' = 1/c+k/x
  • x' is the diminished stat before converting to IEEE754.
  • x is the stat before diminishing returns.
  • c is the cap of the stat, and changes with class.
  • k is is a value that changes with class.
• Formula details:
  1. DR for Dodge, Parry, Missed are calculated separately.
  2. Base avoidances are not affected by DR, (ex: Dodge from base Agility)
  3. Death Knight's Parry from base Strength is affected by DR, base for parry is 5%.
  4. Direct avoidance gains from talents and spells(ex: Evasion) are not affected by DR.
  5. Indirect avoidance gains from talents and spells(ex: +Agility from Kings) are affected by DR
  6. c and k values depend on class but does not change with level.

	k	C_p	1/C_p	C_d	1/C_d
Warrior	0.9560	47.003525	0.021275	88.129021	0.011347
Paladin	0.9560	47.003525	0.021275	88.129021	0.011347
Hunter	0.9880	145.560408	0.006870	145.560408	0.006870
Rogue	0.9880	145.560408	0.006870	145.560408	0.006870
Priest	0.9530	0	0	150.375940	0.006650
Deathknight	0.9560	47.003525	0.021275	88.129021	0.011347
Shaman	0.9880	145.560408	0.006870	145.560408	0.006870
Mage	0.9530	0	0	150.375940	0.006650
Warlock	0.9530	0	0	150.375940	0.006650
Druid	0.9720	0	0	116.890707	0.008555

<font size="3">Returns</font>

avoidanceAfterDR

number – avoidance after diminishing returns in percentages.

<font size="3">Example</font>

local modParry, drFreeParry = StatLogic:GetParryChanceBeforeDR()
local modParryAfterDR = StatLogic:GetAvoidanceAfterDR("PARRY", modParry)
local parry = modParryAfterDR + drFreeParry
local modParryAfterDR = StatLogic:GetAvoidanceAfterDR("PARRY", modParry, "WARRIOR")
local parry = modParryAfterDR + drFreeParry

:GetAvoidanceGainAfterDR("avoidanceType" , gainBeforeDR)

<font size="3">Arguments</font>

"avoidanceType"

string – "DODGE", "PARRY", "MELEE_HIT_AVOID"(NYI)

gainBeforeDR

number – Avoidance gain before diminishing returns in percentages.

<font size="3">Notes</font>

• Calculates the avoidance gain after diminishing returns with player's current stats.

<font size="3">Returns</font>

gainAfterDR

number – Avoidance gain after diminishing returns in percentages.

<font size="3">Example</font>

-- How much dodge will I gain with +30 Agi after DR?
local gainAfterDR = StatLogic:GetAvoidanceGainAfterDR("DODGE", 30*StatLogic:GetDodgePerAgi())
-- How much dodge will I gain with +20 Parry Rating after DR?
local gainAfterDR = StatLogic:GetAvoidanceGainAfterDR("PARRY", StatLogic:GetEffectFromRating(20, CR_PARRY))

string or number

:GetBaseDodge([class])

<font size="3">Arguments</font>

class

string or number – ClassID or "ClassName". Default: PlayerClass
See :GetClassIdOrName(class) for valid class values.

<font size="3">Notes</font>

• BaseDodge values derived by Whitetooth (hotdogee [at] gmail [dot] com)
• Gets the base dodge percentage for given class.
• Base dodge is the amount of dodge you have with 0 Agility, independent of level.

<font size="3">Returns</font>

dodge

number – Base dodge in percentages

statid

string – "DODGE"

<font size="3">Example</font>

local baseDodge = StatLogic:GetBaseDodge()
local baseDodge = StatLogic:GetBaseDodge("WARRIOR")

string or number

:GetBlockValueFromStr(str [, class])

<font size="3">Arguments</font>

str

number – Strength

class

string or number – ClassID or "ClassName". Default: PlayerClass
See :GetClassIdOrName(class) for valid class values.

<font size="3">Notes</font>

• Calculates the block value from strength for given class.
• Player level does not effect block value per strength.

<font size="3">Returns</font>

blockValue

number – Block value

statid

string – "BLOCK_VALUE"

<font size="3">Example</font>

local bv = StatLogic:GetBlockValueFromStr(1) -- GetBlockValuePerStr
local bv = StatLogic:GetBlockValueFromStr(10)
local bv = StatLogic:GetBlockValueFromStr(10, "WARRIOR")

string or number

:GetBlockValuePerStr([class])

<font size="3">Arguments</font>

class

string or number – ClassID or "ClassName". Default: PlayerClass
See :GetClassIdOrName(class) for valid class values.

<font size="3">Notes</font>

• Gets the block value per strength for given class.
• Player level does not effect block value per strength.

<font size="3">Returns</font>

blockValue

number – Block value per strength

statid

string – "BLOCK_VALUE"

<font size="3">Example</font>

local blockPerStr = StatLogic:GetBlockValuePerStr()
local blockPerStr = StatLogic:GetBlockValuePerStr("WARRIOR")

:GetClassIdOrName(class)

<font size="3">Arguments</font>

class

number or string – ClassID or "ClassName"

<font size="3">Notes</font>

• Converts ClassID to and from "ClassName"
• class:

ClassID	"ClassName"
1	"WARRIOR"
2	"PALADIN"
3	"HUNTER"
4	"ROGUE"
5	"PRIEST"
6	"DEATHKNIGHT"
7	"SHAMAN"
8	"MAGE"
9	"WARLOCK"
10	"DRUID"

<font size="3">Returns</font>
None
<font size="3">Example</font>

StatLogic:GetClassIdOrName("WARRIOR") -- 1
StatLogic:GetClassIdOrName(10) -- "DRUID"

string or number
number

:GetCritFromAgi(agi [, class] [, level])

<font size="3">Arguments</font>

agi

number – Agility

class

string or number – ClassID or "ClassName". Default: PlayerClass
See :GetClassIdOrName(class) for valid class values.

level

number – Level used in calculations. Default: player's level

<font size="3">Notes</font>

• CritPerAgi values reverse engineered by Whitetooth (hotdogee [at] gmail [dot] com)
• Calculates the melee/ranged crit chance from agility for given class and level.

<font size="3">Returns</font>

crit

number – Melee/ranged crit percentage

statid

string – "MELEE_CRIT"

<font size="3">Example</font>

local crit = StatLogic:GetCritFromAgi(1) -- GetCritPerAgi
local crit = StatLogic:GetCritFromAgi(10)
local crit = StatLogic:GetCritFromAgi(10, "WARRIOR")
local crit = StatLogic:GetCritFromAgi(10, nil, 70)
local crit = StatLogic:GetCritFromAgi(10, "WARRIOR", 70)

:GetDiff(item , diff1 , diff2 , ignoreEnchant , ignoreGem , red , yellow , blue , meta)

<font size="3">Arguments</font>

item

number or string or table – tooltip or itemId or "itemString" or "itemName" or "itemLink"

diff1

table – Stat difference of item and equipped item 1 are writen to this table if provided

diff2

table – Stat difference of item and equipped item 2 are writen to this table if provided

ignoreEnchant

boolean – Ignore enchants when calculating stat diffrences

ignoreGem

boolean – Ignore gems when calculating stat diffrences

red

number or string – gemID to replace a red socket

yellow

number or string – gemID to replace a yellow socket

blue

number or string – gemID to replace a blue socket

meta

number or string – gemID to replace a meta socket

<font size="3">Notes</font>

• Calculates the stat diffrence from the specified item and your currently equipped items.
• item:

tooltip

table – The tooltip showing the item

itemId

number – The numeric ID of the item. ie. 12345

"itemString"

string – The full item ID in string format, e.g. "item:12345:0:0:0:0:0:0:0".

Also supports partial itemStrings, by filling up any missing ":x" value with ":0", e.g. "item:12345:0:0:0"

"itemName"

string – The Name of the Item, ex: "Hearthstone"

The item must have been equiped, in your bags or in your bank once in this session for this to work.

"itemLink"

string – The itemLink, when Shift-Clicking items.

<font size="3">Returns</font>

diff1

table – The table with stat diff values for item 1

{

["STAT_ID1"] = value,

["STAT_ID2"] = value,

}

diff2

table – The table with stat diff values for item 2

{

["STAT_ID1"] = value,

["STAT_ID2"] = value,

}

<font size="3">Example</font>

StatLogic:GetDiff(21417, {}) -- Ring of Unspoken Names
StatLogic:GetDiff(21452) -- Staff of the Ruins

:GetDiffID(item , ignoreEnchant , ignoreGem , red , yellow , blue , meta)

<font size="3">Arguments</font>

item

number or string or table – tooltip or itemId or "itemString" or "itemName" or "itemLink"

ignoreEnchant

boolean – Ignore enchants when calculating the id if true

ignoreGem

boolean – Ignore gems when calculating the id if true

red

number or string – gemID to replace a red socket

yellow

number or string – gemID to replace a yellow socket

blue

number or string – gemID to replace a blue socket

meta

number or string – gemID to replace a meta socket

<font size="3">Notes</font>

• Returns a unique identification string of the diff calculation, the identification string is made up of links concatenated together, can be used for cache indexing
• item:

tooltip

table – The tooltip showing the item

itemId

number – The numeric ID of the item. ie. 12345

"itemString"

string – The full item ID in string format, e.g. "item:12345:0:0:0:0:0:0:0".

Also supports partial itemStrings, by filling up any missing ":x" value with ":0", e.g. "item:12345:0:0:0"

"itemName"

string – The Name of the Item, ex: "Hearthstone"

The item must have been equiped, in your bags or in your bank once in this session for this to work.

"itemLink"

string – The itemLink, when Shift-Clicking items.

<font size="3">Returns</font>

id

string – a unique identification string of the diff calculation, for use as cache key

link

string – link of main item

linkDiff1

string – link of compare item 1

linkDiff2

string – link of compare item 2

<font size="3">Example</font>

StatLogic:GetDiffID(21417) -- Ring of Unspoken Names
StatLogic:GetDiffID("item:18832:2564:0:0:0:0:0:0", true, true) -- Brutality Blade with +15 agi enchant
http://www.wowwiki.com/EnchantId

:GetDodgeChanceBeforeDR()

<font size="3">Notes</font>

• Calculates your current Dodge% before diminishing returns.
• Dodge% = modDodge + drFreeDodge
• drFreeDodge includes:
  • Base dodge
  • Dodge from base agility
  • Dodge modifier from base defense
  • Dodge modifers from talents or spells
• modDodge includes
  • Dodge from dodge rating
  • Dodge from additional defense
  • Dodge from additional dodge

<font size="3">Returns</font>

modDodge

number – The part that is affected by diminishing returns.

drFreeDodge

number – The part that isn't affected by diminishing returns.

<font size="3">Example</font>

local modDodge, drFreeDodge = StatLogic:GetDodgeChanceBeforeDR()

:GetDodgeFromAgi(agi)

<font size="3">Arguments</font>

agi

number – Agility

<font size="3">Notes</font>

• Calculates the dodge chance from agility for your current class and level.
• Only works for your currect class and current level, does not support class and level args.

<font size="3">Returns</font>

dodge

number – Dodge percentage

statid

string – "DODGE"

<font size="3">Example</font>

local dodge = StatLogic:GetDodgeFromAgi(1) -- GetDodgePerAgi
local dodge = StatLogic:GetDodgeFromAgi(10)

:GetDodgePerAgi()

<font size="3">Notes</font>

• Formula by Whitetooth (hotdogee [at] gmail [dot] com)
• Calculates the dodge percentage per agility for your current class and level.
• Only works for your currect class and current level, does not support class and level args.
• Calculations got a bit more complicated with the introduction of the avoidance DR in WotLK, these are the values we know or can be calculated easily:
  • D'=Total Dodge% after DR
  • D_r=Dodge from Defense and Dodge Rating before DR
  • D_b=Dodge unaffected by DR (BaseDodge + Dodge from talent/buffs + Lower then normal defense correction)
  • A=Total Agility
  • A_b=Base Agility (This is what you have with no gear on)
  • A_g=Total Agility – Base Agility
  • Let d be the Dodge/Agi value we are going to calculate.

  1     1     k 
 --- = --- + --- 
  x'    c     x 

 x'=D'-D_b-A_b*d 
 x=A_g*d+D_r 

 1/(D'-D_b-A_b*d)=1/C_d+k/(A_g*d+D_r)=(A_g*d+D_r+C_d*k)/(C_d*A_g*d+C_d*D_r) 

 C_d*A_g*d+C_d*D_r=[(D'-D_b)-A_b*d]*[Ag*d+(D_r+C_d*k)] 

 After rearranging the terms, we get an equation of type a*d^2+b*d+c where 
 a=-A_g*A_b 
 b=A_g(D'-D_b)-A_b(D_r+C_d*k)-C_dA_g 
 c=(D'-D_b)(D_r+C_d*k)-C_d*D_r 

• • Dodge/Agi=(-b-(b^2-4ac)^0.5)/(2a)

<font size="3">Returns</font>

dodge

number – Dodge percentage per agility

statid

string – "DODGE"

<font size="3">Example</font>

local dodge, statid = StatLogic:GetDodgePerAgi()

string
number

:GetEffectFromDefense([defense] [, attackerLevel])

<font size="3">Arguments</font>

defense

string – Total defense value. Default: player's armor value

attackerLevel

number – Attacker level. Default: player's level

<font size="3">Notes</font>

• Calculates the effective avoidance% from defense (before diminishing returns) for given attacker level

<font size="3">Returns</font>

effect

number – 0.04% per effective defense.

<font size="3">Example</font>

local effect = StatLogic:GetEffectFromDefense(415, 83) -- 0

number

:GetEffectFromRating(rating , id [, level])

<font size="3">Arguments</font>

rating

number – Rating value

id

number – Rating ID as defined in PaperDollFrame.lua

level

number – Level used in calculations. Default: player's level

<font size="3">Notes</font>

• Combat Rating formula and constants derived by Whitetooth (hotdogee [at] gmail [dot] com)
• Calculates the stat effects from ratings for any level.
• id: Rating ID as definded in PaperDollFrame.lua

CR_WEAPON_SKILL = 1

CR_DEFENSE_SKILL = 2

CR_DODGE = 3

CR_PARRY = 4

CR_BLOCK = 5

CR_HIT_MELEE = 6

CR_HIT_RANGED = 7

CR_HIT_SPELL = 8

CR_CRIT_MELEE = 9

CR_CRIT_RANGED = 10

CR_CRIT_SPELL = 11

CR_HIT_TAKEN_MELEE = 12

CR_HIT_TAKEN_RANGED = 13

CR_HIT_TAKEN_SPELL = 14

CR_CRIT_TAKEN_MELEE = 15

CR_CRIT_TAKEN_RANGED = 16

CR_CRIT_TAKEN_SPELL = 17

CR_HASTE_MELEE = 18

CR_HASTE_RANGED = 19

CR_HASTE_SPELL = 20

CR_WEAPON_SKILL_MAINHAND = 21

CR_WEAPON_SKILL_OFFHAND = 22

CR_WEAPON_SKILL_RANGED = 23

CR_EXPERTISE = 24

CR_ARMOR_PENETRATION = 25

• The Combat Rating formula:
  • Percentage = Rating / RatingBase / H
    • Level 1 to 10: H = 2/52
    • Level 10 to 60: H = (level-8)/52
    • Level 60 to 70: H = 82/(262-3*level)
    • Level 70 to 80: H = (82/52)*(131/63)^((level-70)/10)

RatingID	RatingBase
CR_WEAPON_SKILL	2.5
CR_DEFENSE_SKILL	1.5
CR_DODGE	12
CR_PARRY	15
CR_BLOCK	5
CR_HIT_MELEE	10
CR_HIT_RANGED	10
CR_HIT_SPELL	8
CR_CRIT_MELEE	14
CR_CRIT_RANGED	14
CR_CRIT_SPELL	14
CR_HIT_TAKEN_MELEE	10
CR_HIT_TAKEN_RANGED	10
CR_HIT_TAKEN_SPELL	8
CR_CRIT_TAKEN_MELEE	25
CR_CRIT_TAKEN_RANGED	25
CR_CRIT_TAKEN_SPELL	25
CR_HASTE_MELEE	10
CR_HASTE_RANGED	10
CR_HASTE_SPELL	10
CR_WEAPON_SKILL_MAINHAND	2.5
CR_WEAPON_SKILL_OFFHAND	2.5
CR_WEAPON_SKILL_RANGED	2.5
CR_EXPERTISE	2.5
CR_ARMOR_PENETRATION	4.69512176513672

• Parry Rating, Defense Rating, Block Rating and Resilience: Low-level players will now convert these ratings into their corresponding defensive stats at the same rate as level 34 players.

<font size="3">Returns</font>

effect

number – Effect value

effect name

string – Stat ID of converted effect, ex: "DODGE", "PARRY"

<font size="3">Example</font>

StatLogic:GetEffectFromRating(10, CR_DODGE)
StatLogic:GetEffectFromRating(10, CR_DODGE, 70)

:GetGemID(item)

<font size="3">Arguments</font>

item

number or string or table – tooltip or itemId or "itemString" or "itemName" or "itemLink"

<font size="3">Notes</font>

• Returns the gemID and gemText of a gem for use in links
• item:

tooltip

table – The tooltip showing the item

itemId

number – The numeric ID of the item. ie. 12345

"itemString"

string – The full item ID in string format, e.g. "item:12345:0:0:0:0:0:0:0".

Also supports partial itemStrings, by filling up any missing ":x" value with ":0", e.g. "item:12345:0:0:0"

"itemName"

string – The Name of the Item, ex: "Hearthstone"

The item must have been equiped, in your bags or in your bank once in this session for this to work.

"itemLink"

string – The itemLink, when Shift-Clicking items.

<font size="3">Returns</font>

gemID

number – The gemID of this gem

gemText

string – The text shown in the tooltip when socketed in an item

<font size="3">Example</font>

local gemID, gemText = StatLogic:GetGemID(28363)

string or number

:GetHealthRegenFromSpi(spi [, class])

<font size="3">Arguments</font>

spi

number – Spirit

class

string or number – ClassID or "ClassName". Default: PlayerClass
See :GetClassIdOrName(class) for valid class values.

<font size="3">Notes</font>

• HealthRegenPerSpi values derived by Whitetooth (hotdogee [at] gmail [dot] com)
• Calculates the health regen per 5 seconds when out of combat from spirit for given class.
• Player level does not effect health regen per spirit.

<font size="3">Returns</font>

hp5oc

number – Health regen per 5 seconds when out of combat

statid

string – "HEALTH_REG_OUT_OF_COMBAT"

<font size="3">Example</font>

local hp5oc = StatLogic:GetHealthRegenFromSpi(1) -- GetHealthRegenPerSpi
local hp5oc = StatLogic:GetHealthRegenFromSpi(10)
local hp5oc = StatLogic:GetHealthRegenFromSpi(10, "MAGE")

number
number

:GetNormalManaRegenFromSpi(spi [, int] [, level])

<font size="3">Arguments</font>

spi

number – Spirit

int

number – Intellect. Default: player's intellect

level

number – Level used in calculations. Default: player's level

<font size="3">Notes</font>

• Formula and BASE_REGEN values derived by Whitetooth (hotdogee [at] gmail [dot] com)
• Calculates the mana regen per 5 seconds from spirit when out of 5 second rule for given intellect and level.
• Player class is no longer a parameter
• ManaRegen(SPI, INT, LEVEL) = (0.001+SPI*BASE_REGEN[LEVEL]*(INT^0.5))*5

<font size="3">Returns</font>

mp5o5sr

number – Mana regen per 5 seconds when out of 5 second rule

statid

string – "MANA_REG_NOT_CASTING"

<font size="3">Example</font>

	local mp5o5sr = StatLogic:GetNormalManaRegenFromSpi(1) -- GetNormalManaRegenPerSpi
	local mp5o5sr = StatLogic:GetNormalManaRegenFromSpi(10, 15)
	local mp5o5sr = StatLogic:GetNormalManaRegenFromSpi(10, 15, 70)
}

:GetParryChanceBeforeDR()

<font size="3">Notes</font>

• Calculates your current Parry% before diminishing returns.
• Parry% = modParry + drFreeParry
• drFreeParry includes:
  • Base parry
  • Parry from base agility
  • Parry modifier from base defense
  • Parry modifers from talents or spells
• modParry includes
  • Parry from parry rating
  • Parry from additional defense
  • Parry from additional parry

<font size="3">Returns</font>

modParry

number – The part that is affected by diminishing returns.

drFreeParry

number – The part that isn't affected by diminishing returns.

<font size="3">Example</font>

local modParry, drFreeParry = StatLogic:GetParryChanceBeforeDR()

string or number

:GetRAPFromAgi(agi [, class])

<font size="3">Arguments</font>

agi

number – Agility

class

string or number – ClassID or "ClassName". Default: PlayerClass
See :GetClassIdOrName(class) for valid class values.

<font size="3">Notes</font>

• Calculates the ranged attack power from agility for given class.

<font size="3">Returns</font>

rap

number – Ranged attack power

statid

string – "RANGED_AP"

<font size="3">Example</font>

local rap = StatLogic:GetRAPFromAgi(1) -- GetRAPPerAgi
local rap = StatLogic:GetRAPFromAgi(10)
local rap = StatLogic:GetRAPFromAgi(10, "WARRIOR")

string or number

:GetRAPPerAgi([class])

<font size="3">Arguments</font>

class

string or number – ClassID or "ClassName". Default: PlayerClass
See :GetClassIdOrName(class) for valid class values.

<font size="3">Notes</font>

• Gets the ranged attack power per agility for given class.
• Player level does not effect ranged attack power per agility.

<font size="3">Returns</font>

rap

number – Ranged attack power per agility

statid

string – "RANGED_AP"

<font size="3">Example</font>

local rapPerAgi = StatLogic:GetRAPPerAgi()
local rapPerAgi = StatLogic:GetRAPPerAgi("HUNTER")

:GetRatingIdOrStatId(rating)

<font size="3">Arguments</font>

rating

number or string – RatingID or "StatID"

<font size="3">Notes</font>

• Converts RatingID to and from "StatID"
• rating:

RatingID

number – As defined in PaperDollFrame.lua of Blizzard default ui

"StatID"

string – The the key values of the DisplayLocale table in StatLogic

RatingID	"StatID"
CR_WEAPON_SKILL	"WEAPON_RATING"
CR_DEFENSE_SKILL	"DEFENSE_RATING"
CR_DODGE	"DODGE_RATING"
CR_PARRY	"PARRY_RATING"
CR_BLOCK	"BLOCK_RATING"
CR_HIT_MELEE	"MELEE_HIT_RATING"
CR_HIT_RANGED	"RANGED_HIT_RATING"
CR_HIT_SPELL	"SPELL_HIT_RATING"
CR_CRIT_MELEE	"MELEE_CRIT_RATING"
CR_CRIT_RANGED	"RANGED_CRIT_RATING"
CR_CRIT_SPELL	"SPELL_CRIT_RATING"
CR_HIT_TAKEN_MELEE	"MELEE_HIT_AVOID_RATING"
CR_HIT_TAKEN_RANGED	"RANGED_HIT_AVOID_RATING"
CR_HIT_TAKEN_SPELL	"SPELL_HIT_AVOID_RATING"
CR_CRIT_TAKEN_MELEE	"MELEE_CRIT_AVOID_RATING"
CR_CRIT_TAKEN_RANGED	"RANGED_CRIT_AVOID_RATING"
CR_CRIT_TAKEN_SPELL	"SPELL_CRIT_AVOID_RATING"
CR_HASTE_MELEE	"MELEE_HASTE_RATING"
CR_HASTE_RANGED	"RANGED_HASTE_RATING"
CR_HASTE_SPELL	"SPELL_HASTE_RATING"
CR_WEAPON_SKILL_MAINHAND	"MAINHAND_WEAPON_RATING"
CR_WEAPON_SKILL_OFFHAND	"OFFHAND_WEAPON_RATING"
CR_WEAPON_SKILL_RANGED	"RANGED_WEAPON_RATING"
CR_EXPERTISE	"EXPERTISE_RATING"
CR_ARMOR_PENETRATION	"ARMOR_PENETRATION_RATING"

<font size="3">Returns</font>
None
<font size="3">Example</font>

StatLogic:GetRatingIdOrStatId("CR_WEAPON_SKILL") -- 1
StatLogic:GetRatingIdOrStatId("DEFENSE_RATING") -- 2
StatLogic:GetRatingIdOrStatId("DODGE_RATING") -- 3
StatLogic:GetRatingIdOrStatId(CR_PARRY) -- "PARRY_RATING"

string
number

:GetReductionFromArmor([armor] [, attackerLevel])

<font size="3">Arguments</font>

armor

string – Armor value. Default: player's armor value

attackerLevel

number – Attacker level. Default: player's level

<font size="3">Notes</font>

• Calculates the damage reduction from armor for given attacker level.

<font size="3">Returns</font>

damageRecudtion

number – Damage reduction value from 0 to 1. (not percentage)

<font size="3">Example</font>

local damageRecudtion = StatLogic:GetReductionFromArmor(35000, 80) -- 0.69676006569452

string or number
number

:GetSpellCritFromInt(int [, class] [, level])

<font size="3">Arguments</font>

int

number – Intellect

class

string or number – ClassID or "ClassName". Default: PlayerClass
See :GetClassIdOrName(class) for valid class values.

level

number – Level used in calculations. Default: player's level

<font size="3">Notes</font>

• SpellCritPerInt values reverse engineered by Whitetooth (hotdogee [at] gmail [dot] com)
• Calculates the spell crit chance from intellect for given class and level.

<font size="3">Returns</font>

spellcrit

number – Spell crit percentage

statid

string – "SPELL_CRIT"

<font size="3">Example</font>

local spellCrit = StatLogic:GetSpellCritFromInt(1) -- GetSpellCritPerInt
local spellCrit = StatLogic:GetSpellCritFromInt(10)
local spellCrit = StatLogic:GetSpellCritFromInt(10, "MAGE")
local spellCrit = StatLogic:GetSpellCritFromInt(10, nil, 70)
local spellCrit = StatLogic:GetSpellCritFromInt(10, "MAGE", 70)

string

:GetStatMod("stat" [, school])

<font size="3">Arguments</font>

"stat"

string – The type of stat mod you want to get

school

string – Certain stat mods require an extra school argument

<font size="3">Notes</font>

• Calculates various stat mod values from talents and buffs.
• initialValue: sets the initial value for the stat mod.

if initialValue == 0, inter-mod operations are done with addition,

if initialValue == 1, inter-mod operations are done with multiplication,

• finalAdjust: added to the final result before returning, so we can adjust the return value to be used in addition or multiplication.

for addition: initialValue + finalAdjust = 0

for multiplication: initialValue + finalAdjust = 1

• stat:

"StatMod"	Initial value	Final adjust	schoo required
"ADD_CRIT_TAKEN"	0	0	Yes
"ADD_HIT_TAKEN"	0	0	Yes
"ADD_DODGE"	0	0	No
"ADD_AP_MOD_INT"	0	0	No
"ADD_AP_MOD_STA"	0	0	No
"ADD_AP_MOD_ARMOR"	0	0	No
"ADD_AP_MOD_SPELL_DMG"	0	0	No
"ADD_CR_PARRY_MOD_STR"	0	0	No
"ADD_MANA_REG_MOD_INT"	0	0	No
"ADD_RANGED_AP_MOD_INT"	0	0	No
"ADD_ARMOR_MOD_INT"	0	0	No
"ADD_SCHOOL_SP_MOD_SPI"	0	0	Yes
"ADD_SPELL_DMG_MOD_AP"	0	0	No
"ADD_SPELL_DMG_MOD_STA"	0	0	No
"ADD_SPELL_DMG_MOD_INT"	0	0	No
"ADD_SPELL_DMG_MOD_SPI"	0	0	No
"ADD_HEALING_MOD_AP"	0	0	No
"ADD_HEALING_MOD_STR"	0	0	No
"ADD_HEALING_MOD_AGI"	0	0	No
"ADD_HEALING_MOD_STA"	0	0	No
"ADD_HEALING_MOD_INT"	0	0	No
"ADD_HEALING_MOD_SPI"	0	0	No
"ADD_MANA_REG_MOD_NORMAL_MANA_REG"	0	0	No
"MOD_CRIT_DAMAGE_TAKEN"	0	1	Yes
"MOD_DMG_TAKEN"	0	1	Yes
"MOD_CRIT_DAMAGE"	0	1	Yes
"MOD_DMG"	0	1	Yes
"MOD_ARMOR"	1	0	No
"MOD_HEALTH"	1	0	No
"MOD_MANA"	1	0	No
"MOD_STR"	0	1	No
"MOD_AGI"	0	1	No
"MOD_STA"	0	1	No
"MOD_INT"	0	1	No
"MOD_SPI"	0	1	No
"MOD_BLOCK_VALUE"	0	1	No
"MOD_AP"	0	1	No
"MOD_RANGED_AP"	0	1	No
"MOD_SPELL_DMG"	0	1	No
"MOD_HEALING"	0	1

<font size="3">Returns</font>
None
<font size="3">Example</font>

StatLogic:GetClassIdOrName("MOD_STR")
StatLogic:GetClassIdOrName(10)

:GetStatNameFromID("stat")

<font size="3">Arguments</font>

"stat"

string – "StatID". ex: "DODGE", "DODGE_RATING"

<font size="3">Notes</font>

• Returns localized names for stat

<font size="3">Returns</font>

"longName"

string – The full name for stat.

"shortName"

string – The short name for stat.

<font size="3">Example</font>

local longName, shortName = StatLogic:GetStatNameFromID("FIRE_RES") -- "Fire Resistance", "FR"

:GetSum(item , table)

<font size="3">Arguments</font>

item

number or string or table – tooltip or itemId or "itemString" or "itemName" or "itemLink"

table

table – The sum of stat values are writen to this table if provided

<font size="3">Notes</font>

• Calculates the sum of all stats for a specified item.
• item:

tooltip

table – The tooltip showing the item

itemId

number – The numeric ID of the item. ie. 12345

"itemString"

string – The full item ID in string format, e.g. "item:12345:0:0:0:0:0:0:0".

Also supports partial itemStrings, by filling up any missing ":x" value with ":0", e.g. "item:12345:0:0:0"

"itemName"

string – The Name of the Item, ex: "Hearthstone"

The item must have been equiped, in your bags or in your bank once in this session for this to work.

"itemLink"

string – The itemLink, when Shift-Clicking items.

<font size="3">Returns</font>

sumTable

table – The table with stat sum values

{

["itemType"] = itemType,

["STAT_ID1"] = value,

["STAT_ID2"] = value,

}

<font size="3">Example</font>

StatLogic:GetSum(21417) -- [Ring of Unspoken Names]
StatLogic:GetSum("item:28040:2717")
StatLogic:GetSum("item:19019:117") -- TF
StatLogic:GetSum("item:3185:0:0:0:0:0:1957") -- Acrobatic Staff of Frozen Wrath ID:3185:0:0:0:0:0:1957
StatLogic:GetSum(24396)
SetTip("item:3185:0:0:0:0:0:1957")
-- [Deadly Fire Opal] ID:30582 - Attack Power +8 and Critical Rating +5
-- [Gnomeregan Auto-Blocker 600] ID:29387
StatLogic:GetSum("item:30538:3011:2739:2739:2739:0") -- [Midnight Legguards] with enchant and gems
StatLogic:GetSum("item:30538:3011:2739:2739:2739:0") -- [Midnight Legguards] with enchant and gems

number or string
number or string
number or string
number or string
number or string

:ModEnchantGem("link" [, enc] [, gem1] [, gem2] [, gem3] [, gem4])

<font size="3">Arguments</font>

"link"

string – "itemlink"

enc

number or string – enchantID to replace the current enchant. Default: no change

gem1

number or string – gemID to replace the first gem. Default: no change

gem2

number or string – gemID to replace the second gem. Default: no change

gem3

number or string – gemID to replace the third gem. Default: no change

gem4

number or string – gemID to replace the fourth gem. Default: no change

<font size="3">Notes</font>

• Add/Replace item's enchants or gems with given enchants or gems.

<font size="3">Returns</font>

link

number – The modified link

<font size="3">Example</font>

local link = StatLogic:ModEnchantGem("Hitem:31052:0:0:0:0:0:0:0", 1394)

:RemoveEnchant("link")

<font size="3">Arguments</font>

"link"

string – "itemlink"

<font size="3">Notes</font>

• Remove item's enchants.

<font size="3">Returns</font>

link

number – The modified link

<font size="3">Example</font>

local link = StatLogic:RemoveEnchant("Hitem:31052:425:525:525:525:525:0:0")

:RemoveEnchantGem("link")

<font size="3">Arguments</font>

"link"

string – "itemlink"

<font size="3">Notes</font>

• Remove item's gems and enchants.

<font size="3">Returns</font>

link

number – The modified link

<font size="3">Example</font>

local link = StatLogic:RemoveEnchantGem("Hitem:31052:425:525:525:525:525:0:0")

:RemoveGem("link")

<font size="3">Arguments</font>

"link"

string – "itemlink"

<font size="3">Notes</font>

• Remove item's gems.

<font size="3">Returns</font>

link

number – The modified link

<font size="3">Example</font>

local link = StatLogic:RemoveGem("Hitem:31052:425:525:525:525:525:0:0")

:SetTip(item)

<font size="3">Arguments</font>

item

number or string – itemId or "itemString" or "itemName" or "itemLink"

<font size="3">Notes</font>

• This is a debugging tool for localizers
• Displays item in ItemRefTooltip
• item:

itemId

number – The numeric ID of the item. ie. 12345

"itemString"

string – The full item ID in string format, e.g. "item:12345:0:0:0:0:0:0:0".

Also supports partial itemStrings, by filling up any missing ":x" value with ":0", e.g. "item:12345:0:0:0"

"itemName"

string – The Name of the Item, ex: "Hearthstone"

The item must have been equiped, in your bags or in your bank once in this session for this to work.

"itemLink"

string – The itemLink, when Shift-Clicking items.

<font size="3">Returns</font>
None
<font size="3">Example</font>

StatLogic:SetTip("item:3185:0:0:0:0:0:1957")