UNIT¶
is¶
Parameters¶
UNIT1: The first unit to compare.UNIT2: The second unit to compare.
Returns BOOL¶
trueif the two units are the same,falseotherwise.
Example:¶
groupSize¶
groupSize || group.members || num.members
Parameters¶
- None
Returns NUMBER¶
- The total number of group members (including the player). Returns
0if not in a group.
Example:¶
IsSolo¶
Parameters¶
- None
Returns BOOL¶
trueif the player is not in a group,falseotherwise.
Example:¶
IsParty¶
Parameters¶
- None
Returns BOOL¶
trueif the player is in a party (1-5 members),falseotherwise.
Example:¶
IsRaid¶
Parameters¶
- None
Returns BOOL¶
trueif the player is in a raid (more than 5 members),falseotherwise.
Example:¶
groupType¶
Parameters¶
- None
Returns NUMBER¶
- Returns a numeric value representing the group type:
3= RAID2= Party1= SOLO
Example:¶
ingroup¶
Parameters¶
UNIT: The unit to check for group membership.
Returns BOOL¶
trueif the specified unit is in the player's party or raid group,falseotherwise.
Example:¶
incdmg¶
Parameters¶
UNIT: The unit to calculate incoming damage for.seconds: The time frame in seconds to calculate incoming damage for (default is 3 seconds).
Returns NUMBER¶
- The total damage taken by the unit in the specified time frame, or 0 if the target doesn't exist.
Example:¶
incdmg.phys¶
Parameters¶
UNIT: The unit for which to calculate incoming physical damage.seconds: The time frame in seconds to calculate incoming physical damage for (default is 3 seconds).
Returns NUMBER¶
- The total damage taken by the unit in the specified time frame, or 0 if the target doesn't exist.
Example:¶
incdmg.magic¶
Parameters¶
UNIT: The unit for which to calculate incoming magic damage.seconds: The time frame in seconds to calculate incoming magic damage for (default is 3 seconds).
Returns NUMBER¶
- The total damage taken by the unit in the specified time frame, or 0 if the target doesn't exist.
Example:¶
incdmg.reset¶
!> DEPRECATED
- This condition is no longer necessary as damage tracking now automatically resets. Calling this function has no effect.
Parameters¶
UNIT: The unit to reset the incoming damage counter for.
Returns NIL¶
- This condition does not return a value.
Example:¶
incdmg.phys.reset¶
!> DEPRECATED
- This condition is no longer necessary as physical damage tracking now automatically resets. Calling this function has no effect.
Parameters¶
UNIT: The unit to reset the incoming physical damage counter for.
Returns NIL¶
- This condition does not return a value.
Example:¶
incdmg.magic.reset¶
!> DEPRECATED
- This condition is no longer necessary as magic damage tracking now automatically resets. Calling this function has no effect.
Parameters¶
UNIT: The unit to reset the incoming magic damage counter for.
Returns NIL¶
- This condition does not return a value.
Example:¶
boss¶
boss || isBoss
Parameters¶
UNIT: The unit to check for boss status.
Returns BOOL¶
trueif the unit is a boss,falseotherwise.
Example:¶
elite¶
Parameters¶
UNIT: The unit to check for elite classification.
Returns BOOL¶
trueif the unit has an elite classification,falseotherwise.
Example:¶
classification¶
Parameters¶
UNIT: The unit to check for classification.-
classif: The classification string to compare with. Multiple classifications can be separated by spaces or commas.classifworldboss rareelite elite rare normal trivial minus
Returns BOOL¶
trueif the unit's classification matches any of the given classifications,falseotherwise.
Example:¶
worldboss¶
Parameters¶
UNIT: The unit to check for world boss classification.
Returns BOOL¶
trueif the unit is classified as a world boss,falseotherwise.
Example:¶
id¶
Parameters¶
UNIT: The unit whose ID will be checked.ID_STRING: The expected numeric ID, passed as a string.
Returns BOOL¶
trueif the unit's actual numeric ID matches the numeric ID parsed from theID_STRING,falseotherwise.
Example:¶
reaction¶
Parameters¶
UNIT: The unit to check for reaction level.
Returns NUMBER¶
- The reaction level of the unit towards the player:
1= Hated2= Hostile3= Unfriendly4= Neutral5= Friendly6= Honored7= Revered8= Exalted0= Unknown or unit doesn't exist
Example:¶
hasReaction¶
Parameters¶
UNIT: The unit to check for the reaction.reaction: The expected reaction level (can be a number or string name: "hated", "hostile", "unfriendly", "neutral", "friendly", "honored", "revered", "exalted").
Returns BOOL¶
trueif the unit has the expected reaction level,falseotherwise.
Example:¶
threat¶
Parameters¶
UNIT: The unit to check for threat percentage towards the player.
Returns NUMBER¶
- The unit's threat percentage against the player. At 100% the player will become the primary target.
Example:¶
aggro¶
Parameters¶
UNIT: The unit to check for aggro on the player.
Returns BOOL¶
trueif the target has aggro on the player,falseotherwise.
Example:¶
UnitThreatSituation¶
Parameters¶
UNIT1: The first unit to check threat situation.UNIT2: The second unit to check threat situation against.
Returns NUMBER | NIL¶
- Returns the threat situation status between two units, or
nilif either unit doesn't exist.0= Unit does not have threat1= Unit has threat but is not tanking (another unit has higher threat)2= Unit has highest threat (is tanking)3= Unit has threat and is tanking, but another unit is about to gain threat
Example:¶
speed¶
Parameters¶
UNIT: The unit whose speed to retrieve.
Returns NUMBER¶
- The speed of the unit in yards per second. Returns
0if the unit doesn't exist.
Example:¶
moving¶
Parameters¶
UNIT: The unit to check if is currently moving
Returns BOOL¶
trueif the unit is moving,falseotherwise.
Example:¶
IsMovingForward¶
Parameters¶
UNIT: The unit to check if it is moving forward.
Returns BOOL¶
trueif the unit is moving forward,falseotherwise.
Example:¶
IsMovingBackward¶
Parameters¶
UNIT: The unit to check if it is moving backward.
Returns BOOL¶
trueif the unit is moving backward,falseotherwise.
Example:¶
IsStrafeLeft¶
Parameters¶
UNIT: The unit to check if it is strafing left.
Returns BOOL¶
trueif the unit is strafing left,falseotherwise.
Example:¶
IsStrafeRight¶
Parameters¶
UNIT: The unit to check if it is strafing right.
Returns BOOL¶
trueif the unit is strafing right,falseotherwise.
Example:¶
predictPosition¶
Parameters¶
UNIT: The unit whose position is to be predicted.seconds: The time in seconds into the future for which to predict the unit's position.
Returns NUMBER, NUMBER, NUMBER | NIL¶
- The predicted
x, y, zcoordinates of the unit, ornilif the prediction cannot be made.
Example:¶
currentSpeed¶
Parameters¶
UNIT: The unit whose current speed to retrieve.
Returns NUMBER¶
- The current speed of the unit in yards per second.
Example:¶
walkSpeed¶
Parameters¶
UNIT: The unit whose walking speed to retrieve.
Returns NUMBER¶
- The walking speed of the unit in yards per second.
Example:¶
runSpeed¶
Parameters¶
UNIT: The unit whose running speed to retrieve.
Returns NUMBER¶
- The running speed of the unit in yards per second.
Example:¶
backSpeed¶
Parameters¶
UNIT: The unit whose backward speed to retrieve.
Returns NUMBER¶
- The backward speed of the unit in yards per second.
Example:¶
swimSpeed¶
Parameters¶
UNIT: The unit whose swimming speed to retrieve.
Returns NUMBER¶
- The swimming speed of the unit in yards per second.
Example:¶
target¶
Parameters¶
UNIT1: The unit whose target will be checked.UNIT2: The unit to compare the target against.
Returns BOOL¶
trueif the target of the specified unit1 matches the given unit2,falseotherwise.
Example:¶
targetme¶
- This condition checks if the specified unit is targeting the player.
Parameters¶
UNIT: The unit to check for targeting.
Returns BOOL¶
trueif the unit is targeting the player, otherwisefalse.
Examples:¶
isplayer¶
isplayer || player
Parameters¶
UNIT: The unit to be checked.
Returns BOOL¶
trueif the unit is a player-controlled unit,falseotherwise.
Example:¶
inphase¶
Parameters¶
UNIT: The unit to be checked for being in the same phase.
Returns BOOL¶
trueif the unit is in the same phase as the player,falseotherwise.
Example:¶
exists¶
Parameters¶
UNIT: The unit to be checked for existence.
Returns BOOL¶
trueif the unit exists,falseotherwise.
Example:¶
guid¶
Parameters¶
UNIT: The unit for which to retrieve the GUID.
Returns STRING¶
- The GUID of the target, or nil if the target is not valid.
Example:¶
visible¶
Parameters¶
UNIT: The unit to check for visibility.
Returns BOOL¶
trueif the unit is visible,falseotherwise.
Example:¶
dead¶
Parameters¶
UNIT: The unit to check for death or ghost state.
Returns BOOL¶
trueif the unit is dead or a ghost,falseotherwise.
Example:¶
alive¶
Parameters¶
UNIT: The unit to check for being alive.
Returns BOOL¶
trueif the unit is alive,falseif it is dead or a ghost.
Example:¶
infront¶
Parameters¶
UNIT: The unit to check if the player is facing.
Returns BOOL¶
trueif the player is facing the unit,falseotherwise.
Example:¶
infrontof¶
Parameters¶
UNIT1: The unit that is checked to be in front.UNIT2: The unit to check if it is facing UNIT.
Returns BOOL¶
trueif unit2 is facing unit1,falseotherwise.
Example:¶
behind¶
Parameters¶
UNIT: The unit to check if the player is behind.
Returns BOOL¶
trueif player is behind the unit,falseotherwise.
Example:¶
behindof¶
Parameters¶
UNIT1: The unit to check if it is behind unit2.UNIT2: The reference unit.
Returns BOOL¶
trueif unit1 is behind unit2,falseotherwise.
Example:¶
inConeOf¶
Parameters¶
UNIT1: The unit to check if it is within the cone.UNIT2_ANGLE: The reference unit and the cone angle (optional, default angle is 180 degrees). Provide as a string in the format "unit2, angle".
Returns BOOL¶
trueif unit1 is within the specified cone angle in front of unit2,falseotherwise.
Example:¶
lastmoved¶
Parameters¶
UNIT: The unit to check for movement.
Returns NUMBER¶
- The
time in secondssince the unit was last moved, or0if the unit is not valid or has not moved.
Example:¶
movingfor¶
Parameters¶
UNIT: The unit to check for movement.
Returns NUMBER¶
- The
time in secondsthat the unit has been continuously moving, or0if the unit is not valid or is not moving.
Example:¶
movingToward¶
Parameters¶
UNIT1: The unit to check if it is moving toward another unit.UNIT2_ANGLE_SEC: A string containing the target unit, optional angle (default 30 degrees), and optional time threshold (default 0 seconds) separated by commas (e.g., "unit2, 45, 0.5").
Returns BOOL¶
trueif unit1 is moving toward unit2 within the specified angle and has been moving for at least the specified seconds,falseotherwise.
Example:¶
movingAwayFrom¶
Parameters¶
UNIT1: The unit to check if another unit is moving away from it.UNIT2_ANGLE_SEC: A string containing the moving unit, optional angle (default 220 degrees), and optional time threshold (default 0 seconds) separated by commas (e.g., "unit2, 220, 0.5").
Returns BOOL¶
trueif unit2 is moving away from unit1 within the specified angle and has been moving for at least the specified seconds,falseotherwise.
Example:¶
pvp¶
Parameters¶
UNIT: The unit to check for PvP flag with the player.
Returns BOOL¶
trueif the unit is flagged for PvP,falseotherwise.
Example:¶
friend¶
Parameters¶
UNIT: The unit to check for friendly status.
Returns BOOL¶
trueif the unit is friendly,falseotherwise.
Example:¶
canassist¶
Parameters¶
UNIT: The unit to check for assist eligibility.
Returns BOOL¶
trueif the player can assist the unit,falseotherwise.
Example:¶
enemy¶
enemy || isenemy || canattack
Parameters¶
UNIT: The unit to check for enemy status or attack eligibility.
Returns BOOL¶
trueif the unit is an enemy,falseotherwise.
Example:¶
range¶
Parameters¶
UNIT: The unit to measure combat range against.TIPO(optional): The type of range to check.1for default/melee range,2for caster range. Defaults to1.
Returns NUMBER¶
- The combat range between the player and the unit, or 999 if the range cannot be determined.
Example:¶
rangefrom¶
Parameters¶
UNIT1: The first unit to measure combat range from.UNIT2_TIPO: The second unit to measure combat range to, and an optional type. Provide as a string in the format "unit2, tipo".tipocan be1for default/melee range, or2for caster range. Defaults to1.
Returns NUMBER¶
- The combat range between the two units, or 999 if the range cannot be determined.
Example:¶
distance¶
Parameters¶
UNIT: The unit to measure distance against.
Returns NUMBER¶
- The distance between the player and the unit, or 999 if the distance cannot be determined.
Example:¶
distancefrom¶
Parameters¶
UNIT1: The first unit to measure distance from.UNIT2: The second unit to measure distance to.
Returns NUMBER¶
- The distance between the two units, or 999 if the range cannot be determined.
Example:¶
petrange¶
Parameters¶
UNIT: The unit to measure pet's combat range against.
Returns NUMBER¶
- The combat range between the player's pet and the unit, or
999if the range cannot be determined.
Example:¶
petdistance¶
Parameters¶
UNIT: The unit to measure pet's distance against.
Returns NUMBER¶
- The distance between the player's pet and the unit, or
999if the distance cannot be determined.
Example:¶
level¶
Parameters¶
UNIT: The unit whose level to retrieve.
Returns NUMBER¶
- The level of the unit, or
-1if the level cannot be determined.
Example:¶
combat¶
Parameters¶
UNIT: The unit to check for combat status.
Returns BOOL¶
trueif the unit is in combat,falseotherwise.
Example:¶
role¶
Parameters¶
UNIT: The unit whose role to retrieve.
Returns STRING¶
-
The role assigned to the target unit:
"TANK", "HEALER", "DAMAGER", or "UNKNOWN"if the role cannot be determined.For WOTLK version
For WOTLK version returns
TANK,HEALER,DAMAGER,MELEE,CASTER,NONE
Example:¶
hasrole¶
Parameters¶
UNIT: The unit to check for the role.-
expectedRoleThe expected role to search for within the unit's role. Multiple roles can be separated by "||"."TANK", "HEALER", "DAMAGER", or "UNKNOWN"
Returns BOOL¶
trueif the unit has a role containing the expected name,falseotherwise.
Example:¶
name¶
Parameters¶
UNIT: The unit whose name to retrieve.
Returns STRING¶
- The name of the unit, or
Unknownif the name cannot be determined.
Example:¶
hasname¶
Parameters¶
UNIT: The unit to check for the name.expectedNameThe expected name to search for within the unit's name. Multiple names can be separated by "||".
Returns BOOL¶
trueif the unit has a name containing the expected name,falseotherwise.
Example:¶
creature.type¶
creature.type || creatureType
Parameters¶
UNIT: The unit whose creature type to retrieve.
Returns STRING¶
-
The
localizedcreature type of the unit, ornilif the creature type cannot be determined.- enUS
"Aberration","Beast","Critter","Demon","Dragonkin","Elemental","Gas Cloud","Giant","Humanoid","Mechanical","Non-combat Pet","Not specified","Totem","Undead","Wild Pet"
- enUS
Example:¶
hascreature.type¶
hascreature.type || hascreatureType
Parameters¶
UNIT: The unit to check for the creature type.expectedTypeThelocalizedexpected creature type to compare with. Multiple types can be separated by "||".
Returns BOOL¶
trueif the unit has the expected creature type,falseotherwise.
Example:¶
hasclass¶
hasclass || class
Parameters¶
UNIT: The unit to check for the class.expectedClassThe expected class name or ID to compare with. Multiple classes can be separated by "||".
Returns BOOL¶
trueif the unit belongs to the expected class,falseotherwise.
Example:¶
hasRace¶
Parameters¶
UNIT: The unit to check for the race.expectedRace: The expected race name to compare with. Multiple races can be separated by "||". Note: "undead" is internally converted to "scourge".
Returns BOOL¶
trueif the unit belongs to the expected race,falseotherwise.
Example:¶
hasFaction¶
Parameters¶
UNIT: The unit to check for faction.expectedFaction: The expected faction name ("Alliance" or "Horde").
Returns BOOL¶
trueif the unit belongs to the expected faction,falseotherwise.
Example:¶
combatReach¶
Parameters¶
UNIT: The unit whose combat reach to retrieve.
Returns NUMBER¶
- The combat reach of the unit in yards. Returns
1.5if the combat reach cannot be determined.
Example:¶
inmelee¶
Parameters¶
UNIT: The unit to check for melee range.
Returns BOOL¶
trueif the target unit is within melee range,falseotherwise.
Example:¶
inranged¶
Parameters¶
UNIT: The unit to check for ranged combat range.
Returns BOOL¶
trueif the unit is within the ranged combat range of 40,falseotherwise.
Example:¶
timetodie¶
timetodie || deathin || ttd
Parameters¶
UNIT: The unit for which to estimate time to death.
Returns NUMBER¶
- The estimated time to death in
seconds. Returns a high value if is a dummy.
Example:¶
charmed¶
Parameters¶
UNIT: The unit to check for being charmed.
Returns BOOL¶
trueif the unit is charmed,falseotherwise.
Example:¶
timetopercent¶
timetopercent || ttp
Parameters¶
UNIT: The unit for which to estimate time to reach a specific health percentage.PERCENTAGE: The health percentage (0-100) to which you want to estimate the time. If not provided or invalid, defaults to 0%.
Returns NUMBER¶
- The estimated time to X percentage in seconds. Returns a high value if the calculation cannot be performed.
Example:¶
isdummy¶
Parameters¶
UNIT: The unit to check for being a dummy unit.
Returns BOOL¶
trueif the unit is a dummy unit,falseotherwise.
Example:¶
swimming¶
Parameters¶
- None
Returns BOOL¶
trueif the player is swimming,falseotherwise.
Example:¶
falling¶
Parameters¶
- None
Returns BOOL¶
trueif the player is falling,falseotherwise.
Example:¶
indoors¶
Parameters¶
- None
Returns BOOL¶
trueif the player is indoors,falseotherwise.
Example:¶
haste¶
Parameters¶
UNIT: The unit for which to retrieve the spell haste percentage.
Returns NUMBER¶
- The spell haste
percentageof the specified unit.
Example:¶
connected¶
Parameters¶
UNIT: The unit to check for being online and not loading.
Returns BOOL¶
trueif the specified unit is a player character who is currently online (not disconnected or loading),falseotherwise.
Example:¶
combattime¶
combattime || combat.time
Parameters¶
UNIT: The unit to check for combat time duration.
Returns NUMBER¶
- The time duration in
secondsfor which the specified unit has been in combat.
Example:¶
los¶
Parameters¶
UNIT: The unit to check for line of sight.
Returns BOOL¶
trueif there is line of sight between the player character and the specified unit,falseotherwise.
Example:¶
losfrom¶
Parameters¶
UNIT1: The first unit to check from.UNIT2: The second unit to check line of sight to.
Returns BOOL¶
trueif there is line of sight between the two specified units,falseotherwise.
Example:¶
position¶
position || pos || location
Parameters¶
UNIT: The unit whose position to retrieve.
Returns NUMBER, NUMBER, NUMBER, NUMBER¶
- Returns the
x, y, zcoordinates and facing angle (in radians) of the unit.
Example:¶
facing¶
Parameters¶
UNIT: The unit whose facing angle to retrieve.
Returns NUMBER¶
- The facing angle of the unit in radians.
Example:¶
createdBy¶
Parameters¶
UNIT1: The unit to check who created it.UNIT2: The unit to compare against as the creator.
Returns BOOL¶
trueif unit1 was created by unit2,falseotherwise.
Example:¶
createdByServer¶
Checks whether the given object was created directly by the server.
Parameters¶
obj: The object to check.
Returns BOOL¶
trueif the object was created by the server,falseotherwise.
Example:¶
TimeInCombat¶
Parameters¶
- None
Returns NUMBER¶
- The time in seconds that the player has been in combat. Returns
0if not in combat.
Example:¶
TimeOutCombat¶
Parameters¶
- None
Returns NUMBER¶
- The time in seconds that the player has been out of combat. Returns
0if in combat.
Example:¶
hasloot¶
hasloot || IsLootable
Parameters¶
UNIT: The unit to check for loot availability.
Returns BOOL¶
trueif the specified unit has loot that can be looted by the player character,falseotherwise.
Example:¶
mapid¶
Parameters¶
- None
Returns NUMBER¶
- The current map ID of the player's location.
Example:¶
IsNearID¶
Parameters¶
ID: The NPC ID to search for.distance: The maximum distance in yards to check (default: 60).
Returns BOOL¶
trueif an NPC with the specified ID is within the given distance,falseotherwise.
Example:¶
IsNearName¶
Parameters¶
name: The NPC name to search for.distance: The maximum distance in yards to check (default: 60).
Returns BOOL¶
trueif an NPC with the specified name is within the given distance,falseotherwise.
Example:¶
InstanceName¶
Parameters¶
name(optional): The instance name to compare against.
Returns STRING | BOOL¶
- If
nameis not provided, returns the current instance name as a string. - If
nameis provided, returnstrueif it matches the current instance name,falseotherwise.
Example:¶
InstanceType¶
Parameters¶
type(optional): The instance type to compare against ("party", "raid", "arena", "pvp", "scenario", "none").
Returns STRING | BOOL¶
- If
typeis not provided, returns the current instance type as a string. - If
typeis provided, returnstrueif it matches the current instance type,falseotherwise.
Example:¶
ZoneText¶
Parameters¶
name(optional): The zone text to compare against.
Returns STRING | BOOL¶
- If
nameis not provided, returns the current zone text as a string. - If
nameis provided, returnstrueif it matches the current zone text,falseotherwise.
Example:¶
pvpzone¶
Parameters¶
- None
Returns BOOL¶
trueif the player is in a PvP zone (arena or battleground),falseotherwise.
Example:¶
indungeon¶
Parameters¶
- None
Returns BOOL¶
trueif the player is in a dungeon (party or raid instance),falseotherwise.
Example:¶
OnTaxi¶
Parameters¶
UNIT: The unit to check if it is on a taxi.
Returns BOOL¶
trueif the unit is on a taxi flight,falseotherwise.
Example:¶
lowestRoster.health¶
Parameters¶
- None
Returns NUMBER | NIL¶
- The current health of the player or the group/raid member with the lowest health. Returns
nilif the player is not in a group or if no members are found.
Example:¶
tagged.byme¶
- This condition checks if the specified unit is tagged by the player.
Parameters¶
UNIT: The unit to check for tagging.
Returns BOOL¶
trueif the unit is tagged by the player, otherwisefalse.
Example:¶
tagged.by.other¶
- This condition checks if the specified unit is tagged by other players.
Parameters¶
UNIT: The unit to check for tagging.
Returns BOOL¶
trueif the unit is tagged by other players, otherwisefalse.
Example:¶
IsTrackUnit¶
Parameters¶
UNIT: The unit to check if it is being tracked.
Returns BOOL¶
trueif the unit is being tracked (appears on minimap),falseotherwise.
Example:¶
IsSpecialInfo¶
Parameters¶
UNIT: The unit to check for special info flag.
Returns BOOL¶
trueif the unit has special info flag,falseotherwise.
Example:¶
IsDead¶
Parameters¶
UNIT: The unit to check if it is dead.
Returns BOOL¶
trueif the unit is dead,falseotherwise.
Example:¶
IsTappedByAllThreatList¶
Parameters¶
UNIT: The unit to check if it is tapped by all threat list members.
Returns BOOL¶
trueif the unit is tapped by all threat list members,falseotherwise.
Example:¶
IsPreparation¶
Parameters¶
UNIT: The unit to check if it is in preparation state.
Returns BOOL¶
trueif the unit is in preparation state,falseotherwise.
Example:¶
IsPlusMob¶
Parameters¶
UNIT: The unit to check if it is a plus mob (elite mob indicator).
Returns BOOL¶
trueif the unit is a plus mob,falseotherwise.
Example:¶
CanPerformAction¶
Parameters¶
UNIT: The unit to check if it can perform actions.
Returns BOOL¶
trueif the unit can perform actions,falseotherwise.
Example:¶
IsInCombat¶
Parameters¶
UNIT: The unit to check if it is in combat.
Returns BOOL¶
trueif the unit is in combat,falseotherwise.
Example:¶
dispellableWith¶
Parameters¶
UNIT: The unit to check for dispellable auras.spell: The spell ID or name of the dispel ability.
Returns BOOL¶
trueif the unit has at least one aura that can be dispelled with the specified spell,falseotherwise.
Example:¶
subgroup¶
Parameters¶
UNIT: The unit to check for raid subgroup.
Returns NUMBER¶
- The raid subgroup number (1-8) of the unit, or
-1if the unit is not in a raid or not found.
Example:¶
spec¶
Parameters¶
UNIT: The unit for which to retrieve the specialization ID.
Returns NUMBER¶
- The specialization ID of the specified unit.

| Class | Spec 1 | Spec 2 | Spec 3 | Spec 4 | Spec 5 |
|---|---|---|---|---|---|
| Death Knight | 250 Blood | 251 Frost | 252 Unholy | 1455 Initial | |
| Demon Hunter | 577 Havoc | 581 Vengeance | 1456 Initial | ||
| Druid | 102 Balance | 103 Feral | 104 Guardian | 105 Restoration | 1447 Initial |
| Evoker | 1467 Devastation | 1468 Preservation | 1473 Augmentation | 1465 Initial | |
| Hunter | 253 Beast Mastery | 254 Marksmanship | 255 Survival | 1448 Initial | |
| Mage | 62 Arcane | 63 Fire | 64 Frost | 1449 Initial | |
| Monk | 268 Brewmaster | 270 Mistweaver | 269 Windwalker | 1450 Initial | |
| Paladin | 65 Holy | 66 Protection | 70 Retribution | 1451 Initial | |
| Priest | 256 Discipline | 257 Holy | 258 Shadow | 1452 Initial | |
| Rogue | 259 Assassination | 260 Outlaw | 261 Subtlety | 1453 Initial | |
| Shaman | 262 Elemental | 263 Enhancement | 264 Restoration | 1444 Initial | |
| Warlock | 265 Affliction | 266 Demonology | 267 Destruction | 1454 Initial | |
| Warrior | 71 Arms | 72 Fury | 73 Protection | 1446 Initial |
Example:¶
hasSpec¶
Parameters¶
UNIT: The unit for which to check the specialization.expectedSpecId: The expected specialization ID. Multiple IDs can be separated by "||".
Returns BOOL¶
trueif the unit has the expected specialization ID,falseotherwise.
Example:¶
delay¶
Parameters¶
UNIT: The unit to check for the delay.name_secs: A string containing the name and delay time (in seconds) separated by a comma.
Returns BOOL¶
trueif the delay has passed,falseotherwise.
Example:¶
timeout¶
Parameters¶
UNIT: The unit to check for the timeout.name_secs: A string containing the name and timeout duration (in seconds) separated by a comma.
Returns BOOL¶
trueif the timeout has not been reached,falseotherwise.
Example:¶
frame.visible¶
Parameters¶
name: The name of the frame to check for visibility.
Returns BOOL¶
trueif the frame is currently shown,falseotherwise.
Example:¶
sitting¶
Parameters¶
UNIT: The unit to check if it is sitting.
Returns BOOL¶
trueif the unit is sitting,falseotherwise.
Example:¶
influenced¶
Parameters¶
UNIT: The unit to check if it is influenced.
Returns BOOL¶
trueif the unit is influenced,falseotherwise.
Example:¶
controlled.byme¶
Parameters¶
UNIT: The unit to check if it is controlled by the player.
Returns BOOL¶
trueif the unit is controlled by the player,falseotherwise.
Example:¶
istotem¶
Parameters¶
UNIT: The unit to check if it is a totem.
Returns BOOL¶
trueif the unit is a totem,falseotherwise.
Example:¶
attackable¶
Parameters¶
UNIT: The unit to check if it is attackable.
Returns BOOL¶
trueif the unit is attackable,falseotherwise.
Example:¶
looting¶
Parameters¶
UNIT: The unit to check if it is looting.
Returns BOOL¶
trueif the unit is looting,falseotherwise.
Example:¶
pet.incombat¶
Parameters¶
UNIT: The unit to check if the pet is in combat.
Returns BOOL¶
trueif the pet is in combat,falseotherwise.
Example:¶
pvp.flagged¶
Parameters¶
UNIT: The unit to check if it is flagged for PvP.
Returns BOOL¶
trueif the unit is flagged for PvP,falseotherwise.
Example:¶
choked¶
Parameters¶
UNIT: The unit to check if it is choked.
Returns BOOL¶
trueif the unit is choked,falseotherwise.
Example:¶
pacified¶
Parameters¶
UNIT: The unit to check if it is pacified.
Returns BOOL¶
trueif the unit is pacified,falseotherwise.
Example:¶
stunned¶
Parameters¶
UNIT: The unit to check if it is stunned.
Returns BOOL¶
trueif the unit is stunned,falseotherwise.
Example:¶
istaxi¶
Parameters¶
UNIT: The unit to check if it is on a taxi flight.
Returns BOOL¶
trueif the unit is on a taxi flight,falseotherwise.
Example:¶
disarmed¶
Parameters¶
UNIT: The unit to check if it is disarmed.
Returns BOOL¶
trueif the unit is disarmed,falseotherwise.
Example:¶
confused¶
Parameters¶
UNIT: The unit to check if it is confused.
Returns BOOL¶
trueif the unit is confused,falseotherwise.
Example:¶
fleeing¶
Parameters¶
UNIT: The unit to check if it is fleeing.
Returns BOOL¶
trueif the unit is fleeing,falseotherwise.
Example:¶
possessed¶
Parameters¶
UNIT: The unit to check if it is possessed.
Returns BOOL¶
trueif the unit is possessed,falseotherwise.
Example:¶
selectable¶
Parameters¶
UNIT: The unit to check if it is selectable.
Returns BOOL¶
trueif the unit is selectable,falseotherwise.
Example:¶
skinnable¶
Parameters¶
UNIT: The unit to check if it is skinnable.
Returns BOOL¶
trueif the unit is skinnable,falseotherwise.
Example:¶
mounted¶
Parameters¶
UNIT: The unit to check if it is mounted.
Returns BOOL¶
trueif the unit is mounted,falseotherwise.
Example:¶
dazed¶
Parameters¶
UNIT: The unit to check if it is dazed.
Returns BOOL¶
trueif the unit is dazed,falseotherwise.
Example:¶
sheathed¶
Parameters¶
UNIT: The unit to check if it is sheathed.
Returns BOOL¶
trueif the unit is sheathed,falseotherwise.
Example:¶
feign.death¶
Parameters¶
UNIT: The unit to check if it is feigning death.
Returns BOOL¶
trueif the unit is feigning death,falseotherwise.
Example:¶
petAttack¶
Commands the player's pet to attack a specified target.
Parameters¶
unit: The target unit for the pet to attack (e.g., "target", "mouseover", "fakeunit", etc...).
Returns BOOL¶
- Returns
trueafter issuing the attack command.