PitBull Unit Frames 3.0

This project is abandoned.

Whether this project is out of date or its author marked it as abandoned, this project is no longer maintained.

If you wish to take this project over, please report it and state your intentions.

Please note that PitBull3 is no longer being actively developed. On top of lack of active development itself, it's based on the Rock framework which itself is no longer maintained either.

I strongly recommend that users migrate to PitBull4. You can not convert your config from PitBull3 and must reconfigure.

PitBull4 itself can be found at:

You can find guides for setting it up at:

And the FAQ here:

While PitBull4 is still in beta it is fully functional and has more features than PitBull3. It is actively developed on and bug fixes made regularly.

I do not plan on making any fixes to PitBull3 once Cataclysm releases. So you have plenty of time to make the migration.

Accepting paypal donations to [email protected]

PitBull is a Unit Frames addon that provides maximal customization and undergoes rigorous efficiency testing. It is created in a modular framework, which allows for mulitple authors to put their skills to work creating this great project.

It has support for many different kinds of units: player, target, pet, pet's target, target of target, target of target of target, focus, focus' target, party, party pets, party targets, party pet targets, raid, raid pets, raid targets, main tanks, main tank targets, main assists, main assist targets, etc.

Note: Almost all texts are configurable using the LibDogTag-3.0 format. See http://old.wowace.com/wiki/LibDogTag-3.0 for details or type '/dog' in-game.


  • Aura - track any buffs or debuffs on the shown units. Also has the ability to highlight based on a curable debuff.
  • Banzai - highlight units that have threat on them.
  • BarFader - allow for smooth fading when units gain or lose health/mana.
  • CastBar - attach a cast bar to the applicable units: covers player, pet, party, target, focus, etc.
  • CombatIcon - show an icon when the unit is in combat.
  • CombatFader - fade unit out when out of combat.
  • CombatText - show realtime damage/healing text on the unit frame.
  • ComboPoints - for Rogues and Druids, show combo points.
  • DruidManaBar - for Druids, show a mana bar when in Cat/Bear form.
  • ExperienceBar - for the player and hunter pets, show an experience bar.
  • HealthBar - show current health.
  • HappinessIcon - show an icon on the pet frame to indicate its happiness.
  • HideBlizzard - hide unneeded Blizzard frames .
  • Highlight - show a highlight when hovering over a frame or targetting said frame.
  • LeaderIcon - show the leader of the party.
  • MasterLooterIcon - show the master looter of the raid.
  • Portrait - show a 3D, 2D, or class portrait.
  • PowerBar - show a mana/energy/focus/rage bar.
  • PvPIcon - show an icon when the unit is in PvP mode.
  • RaidTargetIcon - how the raid target icon (Skull/Triangle/etc.)
  • RangeCheck - fade the unit frame slightly when the unit is out of range.
  • ReadyCheckIcon - show Ready Check icon based on if the unit is ready or not.
  • ReputationBar - for the player, show a reputation bar.
  • RestIcon - show an icon if the player is resting.
  • Spark - Graceful display of energy ticks and the spellcasting five-second-rule.
  • ThreatBar - show a threat bar on the unit frame.
  • TotemTimers - shows Totem timers for the PitBull player frame.
  • VisualHeal - for healers, shows a bar showing the estimated heal amount while casting.
  • VoiceIcon - show an icon based on whether or not the unit is talking.

    Note: all modules can be enabled or disabled on-demand. Disabled modules don't take up any extra memory or CPU power.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Shefki Shefki Oct 12, 2010 at 01:53 UTC - 0 likes

    Not being updated for 4.0.1, switch to PitBull4.

  • Avatar of Shefki Shefki Apr 01, 2010 at 21:40 UTC - 0 likes

    Important announcement about PitBull Unit Frames.

    Effective today development on PitBull4 is ceasing. We will be resuming development of PitBull3. We've heard the call of users who have brought their difficulties in switching to PitBull4.

    The lack of a way to migrate settings to PitBull4 to PitBull3 has caused users a great deal of frustration in switching. Especially in light of the new configuration style of PitBull4. Layouts while very powerful have proven to be too confusing.

    Many features that are simply not possible with PitBull3 will be lost in going back. For instance the ability to have as many frames as you wanted for any given unit (which was almost done for singletons and not just groups), advanced aura filtering that you can control, multiple text providers so you can choose not to use LibDogTag, and rune support for Death Knights.

    Users who have migrated to PitBull4 should immediately begin migrating their configurations back to PitBull3.

    Was an April Fool's Day joke.

    Last edited Apr 02, 2010 by Shefki
  • Avatar of malak72 malak72 Jan 17, 2010 at 01:07 UTC - 0 likes

    I took a few minutes and modded the raid target icon module into a new one that adds the role icons to the frames; allowing you to see the dagger, cross or shield based on the role selected for the lfg tool when the people in your group queued. If anyone would be interested it's hosted here at our guild site.


    Take care folks.

  • Avatar of Mustt Mustt Dec 03, 2009 at 13:30 UTC - 0 likes

    I'm amending my previous post to include that it only happens on the DK the other chars are fine, It's the same message over and over "Interface\AddOns\PitBull_Aura\Update.lua:181: Attempt to index upvalue 'allFriendlyBuffs' (a nil value)

    It's driving me crazy

  • Avatar of Mustt Mustt Dec 03, 2009 at 12:07 UTC - 0 likes

    I have been using PB 3.0 for a long time and just started to get this error by the count you can see that it never goes away, is there anything I can do?

    Message: Interface\AddOns\PitBull_Aura\Update.lua:368: attempt to index upvalue 'totalSelfBuffs' (a nil value) Time: 12/03/09 04:04:30 Count: 3162 Stack: [string "Interface\FrameXML\BasicControls.xml:<Scrip..."]:18: in function <[string "Interface\FrameXML\BasicControls.xml:<Scrip..."]:4> [C]: ? Interface\AddOns\PitBull_Aura\Update.lua:368: in function <Interface\AddOns\PitBull_Aura\Update.lua:238> Interface\AddOns\PitBull_Aura\Core.lua:807: in function `UpdateAuras' Interface\AddOns\PitBull_Aura\Core.lua:839: in function `object_method' ...ns\CowTip\libs\LibRockTimer-1.0\LibRockTimer-1.0.lua:289: in function <...ns\CowTip\libs\LibRockTimer-1.0\LibRockTimer-1.0.lua:227>

  • Avatar of Vealan Vealan Nov 20, 2009 at 17:01 UTC - 0 likes

    I use pitbull 3.0 i have an awesome setup. for some reason i can no longer edit the options the pitbull tab doesnt open up it just kinda flickers when i try to click it and i recieve some errors. Also my focus frame doesnt work at all anymore. i believe its because its outdated or something is screwed up. I tried installing 4.0 thinking it was just an upgraded version but its completely different and messes up my whole setup how do i fix this?

  • Avatar of incith incith Nov 10, 2009 at 15:09 UTC - 0 likes

    How come you have no damn screenshots of anything? And PB4 only has a screenshot of the configuration menu?

    I'd love to actually see the.. you know.. FRAMES.. some examples.. anything?

    Last edited Nov 10, 2009 by incith
  • Avatar of EvilNuff EvilNuff Sep 23, 2009 at 02:30 UTC - 0 likes

    The Unknown spell ID: 51375 error is due to a change in the spell id for unholy blight.
    In Pitbull_Aura/Filter.lua change line 603 from:
            [51375] = true, -- Unholy Blight
            [49194] = true, -- Unholy Blight

  • Avatar of keLston keLston Sep 22, 2009 at 19:51 UTC - 0 likes

    PitBull_Aura-2.0\Filter.lua:696 Unknown spell ID: 51375
    PitBull_Aura-2.0\Filter.lua:696 in function `turn'
    PitBull_Aura-2.0\Filter.lua:709 in main chunk
    <in C code>: ?
    PitBull-3.0r1883\PitBull.lua:3168 in function <Interface\AddOns\PitBull\PitBull.lua:3144
    PitBull-3.0r1883\PitBull.lua:3253 in function <Interface\AddOns\PitBull\PitBull.lua:3179
    <in C code>: ?
    LibRock-1.0-90298 (PitBull):2461: in function <...face\AddOns\PitBull\libs\LibRock-1.0\LibRock-1.0.lua:2436
    LibRock-1.0-90298 (PitBull):2510: in function <...face\AddOns\PitBull\libs\LibRock-1.0\LibRock-1.0.lua:2503
    LibRock-1.0-90298 (PitBull):2583: in function <...face\AddOns\PitBull\libs\LibRock-1.0\LibRock-1.0.lua:2546
    LibRock-1.0-90298 (PitBull):2694: in function <...face\AddOns\PitBull\libs\LibRock-1.0\LibRock-1.0.lua:2689
    <in C code>: in function `LoadAddOn'
    Interface\FrameXML\UIParent.lua:232 in function `UIParentLoadAddOn':
    Interface\FrameXML\UIParent.lua:255 in function `CombatLog_LoadUI':
    Interface\FrameXML\UIParent.lua:502 in function <Interface\FrameXML\UIParent.lua:474

  • Avatar of torsti torsti Aug 09, 2009 at 15:55 UTC - 0 likes

    I have the Problem, that i can´t show the Charwindow from Players with Rightklick on Player Targetframe. The Option "To View" already there, but nothing happend when i klick on it.


Date created
May 22, 2007
Last update
Mar 23, 2010
Development stage
GNU General Public License version 2 (GPLv2)
Reverse relationships
Recent files
  • R: v3.2.16 for 3.3.0 Mar 23, 2010
  • A: r1901 for 3.3.0 Mar 23, 2010
  • A: r1900 for 3.3.0 Mar 23, 2010
  • R: v3.2.15 for 3.3.0 Dec 12, 2009
  • A: r1898 for 3.3.0 Dec 12, 2009