Shadowed Unit Frames

Another example

SUF focuses on a simple configuration while maintaining the flexibility that most users will care about, preventing unnecessary bloating of the addon that sacrifices performance. While you aren't going to be able to set the health bar to be exactly 3.14 pixels outside of the unit frames, you can change options you actually care about such as bar height, ordering, frame height and so on. To speed up configuration, you can configure multiple units at the same time through the global configuration. For example, if you want to set the height of the Player, Target, Focus and Party frames to 50 then the height of Target's Target, Target's Target of Target, Focus Target to 30 you can easily do this by changing two options instead of having to do it seven times.

However, should you need a little bit of extra configuration do not despair! An advanced option is included that will unlock additional configuration giving finer control over the configuration.

Shadowed Unit Frames in Legion
As of version v4.1.0, WoW 7.0 and Legion is fully supported!

Slash commands: /shadoweduf (/suf)

Donations are not required, but are appreciated!

Are you driven crazy by your party frames not aligning up exactly with your player frames, even if it's only half a pixel off? The anchoring system will let you solve all alignment issues, by allowing you to anchor a frame to another and set a simple offset from the frame it is anchored to, or by manually setting the X/Y position of the frame.

Using the screen shot as an example, if you drag the player frame the other frames will move with the player frame preserving the alignment and spacing. Each frame can still be manually positioned wherever you want, but this gives you a way of easily anchoring and moving frames around without having to use a ruler.

Zone configuration (Disabling options/units by zone type)
Units and modules can be enabled or disabled based on the type of zone you are in. For example, if you want to see party targets and party pets while you are in an arena but nowhere else then you can use the visibility options to enable it only while inside an arena. Modules can also be disabled by zone type, if you want to see party auras while in a raid instance but nowhere else you can disable the module in raid instances only.

Profiles do not have to be swapped and it is all automatic.

Supports unit frames are as follows:

Player: Player, Pet, Pet Target
General: Target, Target of Target, Target of Target of Target, Focus, Focus Target
Party: Party, Party Pets, Party Targets, Party ToT
Raid: Raid, Raid Pet, Main Tank, Main Tank Target, Main Assist, Main Assist Target, Boss, Boss Target, Boss ToT, Main Assist ToT, Main Tank ToT
Arena: Arena, Arena Target, Arena Pets, Arena ToT
Battleground: Battleground, Battleground Target, Battleground Target


  • Tags: Includes a simple tagging system that can be customized in virtually any way using Lua, even if something isn't included by default odds are you can make the tags
  • Incoming Heals: Supports the Blizzard Events for incoming heal data, no external libraries needed
  • Auras: Can be set to only show auras you casted, or can cast on others. Can enlarge auras that you casted, and hide the cooldown ring on the timers of auras you didn't cast as well to make it more obvious which ones you casted and which ones you didn't
  • Aura Timers: You will need a mod such as OmniCC to show timers on buffs and debuffs
  • Aura Indicators: Display colored squares or icons for certain auras on any unit
  • Fader: Fades frames when out of combat and inactive (100% mana/no target)
  • Class Power (Eclipse, Holy Power, etc): Supports all of the class power features from Eclipse to Burning Embers.
  • Highlighting: Border highlighting of frames based on mousing over them, curable debuffs, aggro or you are targeting/focusing them
  • Range Checking: Fades frames out that are out of range of you
  • Exportable Layouts: If you have a layout, or your friend has a layout you want to try out you can export/import SUF layouts by going to /suf -> Layout Manager
  • Profiles: You can change from any profile to another one without reloading your UI, should you want to use a completely different layout based on zone you can easily switch profiles without hassle

Pretty much all the general unit frame settings are in, health bars, cast bars, power bars, portraits, indicators and so on.

Basic module support is included, should you be interested in building a module see the documentation on github for more information.

Currently released:


Please focus all discussions, questions or general feedback to the forum thread:

For feature requests and bug reports, please continue to use the Ticket tracker. Feel free to ask on the thread first, if you're unsure what to do!

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

  • Avatar of Shadowed Shadowed Apr 15, 2010 at 04:24 UTC - 0 likes

    I don't plan on adding the ability to set specific fonts per tag, you can already font size per tag. If you want coloring, you can just use color codes around tags, namely "|cffRRGGBB" for example |cffff2020 will give you a mostly red color.

  • Avatar of maxt123 maxt123 Apr 15, 2010 at 03:58 UTC - 0 likes

    Hi Shadowed, Awsome addon! Pretty much works better than Pitbull abd Stuf Unit frames! It really misses one crucial configuration option though - color and font editing for individual tag or at least text. it's a pain to do it with lua for every text. Do you think you would be able to add this feature sometime soon? it would make this addon perfect! Thanks!

  • Avatar of Shadowed Shadowed Apr 15, 2010 at 01:07 UTC - 0 likes

    tenchu: It's been fixed in alpha

    Mists: Ah! Sorry missed your comment. That doesn't sound like something which would be very easy to do, could you give a screenshot indicating what you're talking about so I can confirm thought?

  • Avatar of tenchu tenchu Apr 12, 2010 at 19:12 UTC - 0 likes

    incoming heal will change the color of the entire unit frame in raid instead of the amount of incoming heal on the unit frame with v3.2.9-1-g5ee8c5c. OK with v3.2.9 for 3.3.3 on 1 Apr 2010.

  • Avatar of Mists Mists Apr 09, 2010 at 16:04 UTC - 0 likes

    For some unit types, especially party members, I like to display auras in 2 rows, with buffs starting topleft and growing right-down, and debuffs starting bottomright and growing left-up. Both buffs and debuffs share the icons, it's not limited to 1 row for buffs and 1 row for debuffs. I'm used to this arrangement from years of agUF, and as much as I tried I can't seem to be able to find a different aura layout that's as good for me as this. The advantage this has over "buffs then debuffs" in SUF is that it's very easy to differentiate between them, without the need to look at the border.

    Since I've switched to SUF many months ago (an excellent addon I have to add), I've maintained my own aura module that was basically a copy of the SUF module with only this change done (and probably badly done too, but it worked). It's quite annoying though to have to overwrite the original each time I update SUF, and fix potential breakages due to changes in SUF.

    Now of course I'd be grateful if you could include such an option in SUF's aura module. However if I don't miss something this would require pretty big changes so you might not be willing to do it. In this case, I'd ask the question: how would you do it if you wanted to change the behaviour of a SUF module through an external addon? Or even specifically the auras module? I don't mind having a stab at doing it if I have some good pointers, because my current approach is not good and I can't seem to find a proper way to do it.

    I hope I explained myself clearly enough, if not I can try to explain it better. Thanks in advance for your time.

  • Avatar of Shadowed Shadowed Apr 09, 2010 at 06:21 UTC - 0 likes

    Not much I can do about that, you could try sorting by index but that's something Blizzard does, not me. If it's not sorting by tank/healer/dps/dps/dps and you're using index (or default) sorting then you're out of luck.

  • Avatar of martinboy martinboy Apr 05, 2010 at 14:14 UTC - 0 likes

    As of patch 3.3.3 blizzard made it so party frames in random heroic would be sorted in order of tank, healer, dps, dps, dps but SUF doesnt always sort it that way. Is it blizzards sorting order, that doesnt work or is it something in SUF?

  • Avatar of Shadowed Shadowed Apr 02, 2010 at 23:05 UTC - 0 likes

    drewdog26: Will look into it

    karkassEU: No it's not to both of those.

  • Avatar of drewdog26 drewdog26 Apr 02, 2010 at 17:05 UTC - 0 likes

    Hi, I have a problem, when trying to import a layout from a friend I get the following error message. (please keep in mind he copied and pasted it into a word document, I don't know if there is an easier way to do this)

    The error message reads:

    Failed to import layout, error:

    [string "return {powerColors={MANA={r=0.3:g=0.5:b=0.85:}FOCUS={r=1:g=0...."]:1: '}' expected near ']'

    Please help with this,


    Last edited Apr 02, 2010 by drewdog26
  • Avatar of karkassEU karkassEU Apr 02, 2010 at 10:39 UTC - 0 likes

    Kudos Shadowed. been using this addon for few months now and love it. However there are 2 things bothering me. 1 Is it possible to show show the player who gives the buff in the buff tooltip like in x-perl? 2 Is it possible to remove the player in the raid frame? I bet this it is but can't find how.

    Thanx for your work mate.


Date created
May 17, 2009
Last update
Sep 13, 2016
Development stage
  • deDE
  • enUS
  • frFR
  • koKR
  • ruRU
  • zhCN
  • zhTW
All Rights Reserved
Curse link
Shadowed Unit Frames
Reverse relationships
Recent files