DogTag-1.0/Tags
From WowAce Wiki
Contents |
[edit]
Complex tag
- Text(arg)
- Returns `arg`.
[edit]
Permanent and semipermanent characteristics of the unit
- Name
- Name of the unit if it exists. Otherwise, the unit id.
- NameRealm
- Name and server of the unit, for use in battlegrounds. text([Name][Realm:Prepend(-)])
- NameHostile
- Name of the unit in hostility color. [Name:HostileColor]
- IsFriend
- "True" if the unit is a friend, blank otherwise.
- IsEnemy
- "True" if the unit is not a friend, blank otherwise. Note: alias for [~IsFriend]
- Level
- The level of the unit, if can be determined. Otherwise "??".
- IsMaxLevel
- Returns "True" if the level of the unit is greater than or equal to the maximum level of the game (60 or 70, depending on whether you have the expansion).
- IsPlayerOrPet
- Check to see if the unit is a player or a pet.
- IsPlayer
- To see if the unit is a player.
- IsPet
- To see if the unit is a pet.
- Faction
- "Horde", "Alliance", some other faction, or blank.
- Race
- The race, e.g. "Dwarf".
- SmartRace
- The race, e.g. "Dwarf", if a player, otherwise the creature type or family. If undetermined, "Unknown".
- ShortRace
- A short version of the race, e.g. "Dw" for "Dwarf". Note: Alias for [Race:ShortRace]
- Creature
- The creature type or family of the unit if it can be determined. Otherwise "Unknown".
- CreatureType
- ???
- Class
- The class of the unit, if can be determined. Otherwise "Unknown".
- SmartClass
- The class of the unit, but only if the unit is a player or a hostile non-pet.
- PlayerClass
- The class of the unit, but only if the unit is a player. Note: Alias for [IsPlayer?Class]
- ShortClass
- The class of the unit in a short form. e.g. "Pa" for "Paladin". Note: Alias for [Class:ShortClass]
- ShortSmartClass
- The class of the unit in a short form. e.g, but only if the unit is a player or a hostile non-pet. Note: Alias for [SmartClass:ShortClass]
- ShortPlayerClass
- The class of the unit in a short form. e.g, but only if the unit is a player. Alias for [PlayerClass:ShortClass]
- ClassColor
- The color of the class of the unit.
- Classification
- "Rare", "Elite", "Rare-Elite", "Boss", or blank.
- ShortClassification
- "r", "+", "r+", "b", or blank.
- Plus
- "+" if the unit is a plus mob. Otherwise blank.
- Sex
- "Male", "Female", or blank
- ShortSex
- "m", "f", or blank
[edit]
Status (ephemeral)
- Range
- Identifies a span of distance away from the unit, based on abilities that might be used on the unit.
- Zone
- Returns the zone of the unit, if not in the same zone as you.
- Status
- "Offline", "Dead", "Ghost", "Soulstone" (only if dead and soulstoned), "Feigned Death", or blank. Offline:HasDivineIntervention:[Dead?IsFeignedDeath:HasSoulstone:Dead]
- Offline
- "Offline" or blank.
- AFK
- "AFK" or blank.
- DND
- "DND" or blank.
- AFKDND
- "AFK", "DND", or blank.
- PvP
- "PvP" or blank.
- Resting
- "Resting" if the player is current resting in an inn or city. (More on rest in the #Happiness, reputation, experience section below.)
- InCombat
- "Combat" if the unit is in combat.
- Leader
- "Leader" if the unit is a leader. Note: to wrap in parentheses, try [Leader:Paren]
- LeaderShort
- "L" if the unit is a leader. Note: to wrap in parentheses, try [LeaderShort:Paren]. This is actually an alias for [Leader:Trunc(1)]
- FKey
- "F1", "F2", "F3", "F4", or "F5" if the unit is the player or a party member.
- RaidGroup
- The raid group of the unit. Note: to wrap in parentheses, try [RaidGroup:Paren]
- TappedByMe
- "*" if the unit has been tapped by the player. Otherwise blank.
- IsTapped
- "Tapped" if the unit has been tapped by someone other than the player. Otherwise blank.
- Guild
- The name of the guild of the unit, blank otherwise. Note: to wrap in angle brackets, try [Guild:Angle]
- GuildRank
- The guild rank of the unit, blank otherwise.
- GuildNote
- The guild general note for the unit.
- OfficerNote
- The guild officer note for the unit.
- PvPRank
- The PvP rank of the unit. If no rank, then will return blank.
- PvPRankNum
- The PvP rank number of the unit. No rank will return 0, getting higher as a higher rank is achieved.
- IsUnit(unitID)
- (uncertain:) Checks to see the unit's ID matches unitID.
- Example: On your party frame's name text you might want [Name] [IsUnit(target)?text(Targeted):Angle]
- NumTargeting
- Number of other units in the party or raid that are targeting the unit.
[edit]
Auras
- HasAura(arg)
- Check to see if the unit has an aura called arg. The following are aliases to this function.
- IsShadowform
- IsFeignedDeath
- IsStealthed
- HasShieldWall
- HasLastStand
- HasSoulstone
- HasMisdirection
- HasIceBlock
- HasInvisibility
- HasDivineIntervention
- HasDebuffType(arg)
- Check to see if the unit has a debuff of type arg. The following are aliases to this function.
- HasMagicDebuff
- HasCurseDebuff
- HasPoisonDebuff
- HasDiseaseDebuff
[edit]
Health
- CurHP
- The current health for the unit
- MaxHP
- The maximum health for the unit
- PercentHP
- The percentage of health for the unit. Note: This does not include a percent sign. To use that, try [PercentHP:Percent]
- MissingHP
- The missing health for the unit. Note: This does not include the negative sign. To use that, try [MissingHP:Negate]
- FractionalHP
- The current health, '/', and the maximum health.
- SureHP
- The current health, '/', and the maximum health, if the health can be determined properly. Otherwise, blank.
- SmartHP
- The current health, '/', and the maximum health, if the health can be determined properly. Otherwise, show the health as a percentage. Note: This is an alias for [SureHP:PercentHP:Percent]
- IsMaxHP
- Returns 'True' if the unit's current hp is equal to its maximum.
[edit]
Power (mana, energy, rage, focus)
- CurMP
- The current mana/energy/rage/focus for the unit
- MaxMP
- The maximum mana/energy/rage/focus for the unit
- PercentMP
- The percentage of mana/energy/rage/focus for the unit. Note: This does not include a percent sign. To use that, try [PercentMP:Percent]
- MissingMP
- The missing mana/energy/rage/focus for the unit. Note: This does not include the negative sign. To use that, try [MissingMP:Negate]
- FractionalMP
- The current mana/energy/rage/focus, '/', and the maximum mana/energy/rage/focus.
- IsMaxMP
- Returns 'True' if the unit's current mana/energy/rage/focus is equal to its maximum.
- HasNoMP
- Returns 'True' if the unit's maximum mana/energy/rage/focus is 0.
- TypePower
- The type of power for the unit, i.e. "Mana", "Rage", "Focus", "Energy".
- IsPowerType(arg)
- Returns `arg`, where `arg` is Rage, Focus, Energy, or Mana and the power type of the unit matches. Note: To check the player's power type, use [IsPowerType#player(arg)]
- IsMana
- Returns 'Mana' if the power type of the unit is mana. Note: To check if the player uses mana, use [IsMana#player]
- IsFocus
- Returns 'Focus' if the power type of the unit is focus.
- IsEnergy
- Returns 'Energy' if the power type of the unit is energy. Note: To check if the player uses energy, use [IsEnergy#player]
- IsRage
- Returns 'Rage' if the power type of the unit is rage. Note: To check if the player uses rage, use [IsRage#player]
- Combos
- The number of combos on the target.
- ComboSymbols
- "@" repeated the number of combos times. e.g. if 3 combo points, "@@@"
[edit]
Happiness, reputation, experience
- HappyNum
- The happiness of the player's pet. 1 for Unhappy, 2 for Neutral, 3 for Happy, 0 if unknown.
- HappyText
- "Happy", "Neutral", or "Unhappy".
- HappyIcon
- ":D", ":|", or "B("
- CurXP
- The current experience of the unit.
- MaxXP
- The maximum experience of the unit.
- PercentXP
- The percentage experience of the unit. Note: This does not include the percentage sign. To use that, try [PercentXP:Percent]
- MissingXP
- The missing experience of the unit. Note: This does not include the negative sign. To use that, try [MissingXP:Negate]
- FractionalXP
- The current experience, '/', and maximum experience of the unit.
- RestXP
- The current rested experience of the unit. Note: This only works for the player
- PercentRestXP
- The current percentage of rested xp. Note: this is RestedXP/MaxXP*100
- CurRep
- The current reputation for the currently watched faction.
- MaxRep
- The maximum reputation for the currently watched faction.
- PercentRep
- The percentage of reputation for the currently watched faction.Note: This does not include the percentage sign. To use that, try [PercentRep:Percent]
- MissingRep
- The missing reputation for the currently watched faction. Note: This does not include the negative sign. To use that, try [MissingRep:Negate]
- FractionalRep
- The current reputation, '/', and the maximum reputation for the currently watched faction.
- RepReaction
- Returns Friendly, Neutral, etc.
- RepName
- The name of the currently watched faction.
- DruidForm
- Returns "Bear", "Cat", "Tree", "Travel", "Moonkin", "Flight", or "Aquatic" if the unit is a druid and in that shapeshift form, blank otherwise.
- Target
- The name of the target of the unit, blank if unknown.
- IsMouseover
- Returns "True" if the frame is currently being hovered over.
- IsUnit(unit)
- Returns "True" if the unit associated with the current frame is the same unit as the one provided.
- IsPlayer
- Returns "True" if the unit is a player. (As opposed to a non-player character)
- IsPet
- Returns "True" if the unit is a player's pet.
- IsPlayerOrPet
- Returns "True" if the unit is a player or player's pet.
[edit]
Threat
- Threat
- MaxThreat
- PercentThreat
- MissingThreat
- FractionalThreat
- HasNoThreat
- EnemyThreat
- MissingEnemyThreat
- FractionalEnemyThreat
- MaxEnemyThreat
- PercentEnemyThreat
- HasNoEnemyThreat
[edit]
Colors
- RepColor
- The hostility color of the currently watched faction.
- StatusColor
- The color based on the current unit's state state. Gray for dead, orange for disconnected, white otherwise.
- HappyColor
- The color based on the happiness of the player's pet. Green for happy, yellow for neutral, red for unhappy.
- HostileColor
- The color of the hostility of the unit.
- ClassColor
- The color of the class of the unit.
- HPColor
- The color of the health of the unit (red close to death, yellow at 50%, green at full health).
- AggroColor
- The color of the aggro for the unit.
- DifficultyColor
- The color of the difficulty of the unit.
- PowerColor
- The color of the power type for the unit. (e.g. blue for Mana, red for Rage).
- CombatColor
- Red if in combat, white otherwise.
- Color(rrggbb)
- Switch to the specified hex color.
- White
- Return to the default color.
- Red
- Switch to red.
- Blue
- Switch to blue.
- Green
- Switch to green.
- Cyan
- Switch to cyan. (In-between blue and green)
- Fuchsia
- Switch to fuchsia. (In-between red and blue, like purple)
- Yellow
- Switch to yellow.
- Gray
- Switch to gray.
[edit]
List of modifiers
- IsEqual(arg)
- Return the value if it is equal to `arg`, otherwise blank.
- IsNotEqual(arg)
- Return the value if it is not equal to `arg`, otherwise blank. Note: alias for [~IsEqual(arg)]
- IsLess(arg)
- Return the value if it is less than `arg`, otherwise blank.
- IsLessEqual(arg)
- Return the value if it is less than or equal to `arg`, otherwise blank.
- IsGreater(arg)
- Return the value if it is greater than `arg`, otherwise blank. Note: alias for [~IsLessEqual(arg)]
- IsGreaterEqual(arg)
- Return the value if it is greater than or equal to `arg`, otherwise blank. Note: alias for [~IsGreaterEqual(arg)]
- Hide(arg)
- Return blank if the value is equal to `arg`. Note: alias for [~IsEqual(arg)]
- HideLess(arg)
- Return blank if the value is less than `arg`. Note: alias for [~IsLess(arg)]
- HideGreater(arg)
- Return blank if the value is greater than `arg`. Note: alias for [~IsGreater(arg)]
- HideLessEqual(arg)
- Return blank if the value is less than or equal to `arg`. Note: alias for [~IsLessEqual(arg)]
- HideGreaterEqual(arg)
- Return blank if the value is greater than or equal to `arg`. Note: alias for [~IsGreaterEqual(arg)]
- HideUnless(arg)
- Return blank if the value is not equal to `arg`. Note: alias for [~IsNotEqual(arg)]
- HideZero
- Return blank if the value is 0. Note: alias for [Hide(0)]
- Prepend(arg)
- Prepend `arg` to the value.
- Append(arg)
- Append `arg` to the value.
- Negate
- Return the negative of the value if it is a number. Otherwise, do nothing.
- Percent
- Return the value followed by "%" if it is a number. Otherwise, do nothing.
- Short
- Return a smaller version (showing 3 decimal places) of the value if the value is a number and greater than 10000. Otherwise, do nothing.
- VeryShort
- Return a smaller version (showing 1-3 decimal places) of the value if the value is a number and greater than 1000. Otherwise, do nothing.
- Round or Round(place)
- Round a number to a specified decimal place. if `place` is not given, then 0 is assumed.
- Upper
- Return the uppercase version of the value.
- Lower
- Return the lowercase version of the value.
- Outline
- Creates a black outline around text. [Outline] must be placed in front of your DogTag string. ex. [Outline][Name]
- ThickOutline
- Creates a thick black outline around text. [ThickOutline] must be placed in front of your DogTag string. ex. [ThickOutline][Name]
- Bracket
- If the value is not blank, then wrap it in [], e.g. [CurHP:Bracket] => "[500]"
- Paren
- If the value is not blank, then wrap it in (), e.g. [CurHP:Paren] => "(500)"
- Angle
- If the value is not blank, then wrap it in <>, e.g. [CurHP:Angle] => "<500>"
- Brace
- If the value is not blank, then wrap it in {}, e.g. [CurHP:Brace] => "{500}"
- Trunc(num)
- Truncate the value to `num` characters. Note: UTF-8 aware
- Contains(arg)
- Return the value if the value contains `arg`, otherwise blank.
- HideContains(arg)
- Return blank if the value contains `arg`, otherwise return the value. Note: alias for [~Contains(arg)]
- ShortRace(race)
- Return the shortened version of `race`, e.g. "Dw" for "Dwarf". Returns blank if `race` is unknown.
- ShortClass(class)
- Return the shortened version of `class`, e.g. "Pa" for "Paladin". Returns blank if `class` is unknown.
- RepColor
- Wrap the value in the hostility color of the currently watched faction.
- StatusColor
- Wrap the value in a color based on the current unit's state state. Gray for dead, orange for disconnected, red for in combat, yellow for resting, white otherwise.
- HappyColor
- Wrap the value in a color based on the happiness of the player's pet. Green for happy, yellow for neutral, red for unhappy.
- HostileColor
- Wrap the value in a color based on the hostility of the unit.
- ClassColor
- Wrap the value in a color based on the class of the unit.
- HPColor
- Wrap the value in a color based on the health of the unit.
- AggroColor
- Wrap the value in a color of the aggro for the unit.
- DifficultyColor
- Wrap the value in a color of the difficulty of the unit.
- PowerColor
- Wrap the value in a color of the power type for the unit. (e.g. blue for Mana, red for Rage).
- CombatColor
- Wrap the value in red if in combat, white otherwise.
- Color(rrggbb)
- Wrap the value in the specified hex color.
- White
- Wrap the value in white
- Red
- Wrap the value in red.
- Blue
- Wrap the value in blue.
- Green
- Wrap the value in green.
- Cyan
- Wrap the value in cyan. (In-between blue and green)
- Fuchsia
- Wrap the value in fuchsia. (In-between red and blue, like purple)
- Yellow
- Wrap the value in yellow.
- Gray
- Wrap the value in gray.
