Scudmarx50532@legacy41569935 (talk | contribs) (New page: {{wowapi}} __NOTOC__ <!-- Describe the purpose of the function, exhausting detail can be saved for a later section --> Returns information about a unit's standing in another unit's threa...) Â |
Scudmarx50532@legacy41569935 (talk | contribs) No edit summary |
||
| Line 3: | Line 3: | ||
<!-- Describe the purpose of the function, exhausting detail can be saved for a later section --> |
<!-- Describe the purpose of the function, exhausting detail can be saved for a later section --> |
||
| − | Returns information about a unit's standing in another unit's threat table. New in [Patch 3.0]. |
+ | Returns information about a unit's standing in another unit's threat table. New in [[Patch 3.0]]. |
<!-- List return values and arguments as well as function name, follow Blizzard usage convention for args --> |
<!-- List return values and arguments as well as function name, follow Blizzard usage convention for args --> |
||
Revision as of 21:08, 12 October 2008
 |
Automated updating of API pages at this location, to reflect patch changes, has ceased from 10.1.7 onwards. |
Returns information about a unit's standing in another unit's threat table. New in Patch 3.0.
isTanking, status, threatpct, rawthreatpct, threatvalue = UnitDetailedThreatStatus("unit", "mob")
Parameters
Arguments
- ("unit")
- unit
- String - The UnitId whose threat to query (e.g. "player", "party2", "pet", etc.)
- ("mob")
- mob
- String - The UnitId of the unit whose threat table to query (e.g. "target", "pettarget" etc.)
Returns
- isTanking
- Integer - returns 1 if the unit is primary threat target of the mob (is tanking), or nil otherwise.
- status
- Integer - returns the threat status for the unit on the mob, or nil if unit is not on mob's threat table. (3 = securely tanking, 2 = insecurely tanking, 1 = not tanking but higher threat than tank, 0 = not tanking and lower threat than tank)
- threatpct
- Number - returns the unit's threat on the mob as a percentage of the amount required to pull aggro, scaled according to the unit's range from the mob. At 100 the unit will pull aggro. Returns 100 if the unit is tanking and nil if the unit is not on the mob's threat list.
- rawthreatpct
- Number - returns the unit's threat as a percentage of the tank's current threat. Returns nil if the unit is not on the mob's threat list.
- threatvalue
- Number - returns the unit's total threat on the mob.
Example
local _,_,threatpct,_,_ = UnitDetailedThreatSituation("player", "target");
ChatFrame1:AddMessage('You are ' .. tostring(threatpct) .. '% towards aggro.');
Result
- Prints the player's evaluated threat% to the chat frame. e.g.
You are 80.189041098141% towards aggro.
Details
- The function will return all nil values if the unit is not on the mob's threat list or if either unit isn't available.