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
You can find a in-development test version for Legion here:
Download v4.1-Beta1 for Legion

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 pixelbat pixelbat Nov 27, 2012 at 22:28 UTC - 0 likes

    Monk chi not showing up in the secondary power bar with 5.1.

  • Avatar of thanje thanje Nov 21, 2012 at 17:15 UTC - 0 likes

    Hi, is there a way to make the little menu from Blizzard raid UI always appear on top of suf ? It has always been doing so, but I change my player frame and put it in the middle of my screen, since then, the little raid/party menu (to put signs, rdy check, etc.) is always hidden behind suf frames when I open it... That's really annoying, can someone help me ? :)

  • Avatar of user_650047 user_650047 Nov 20, 2012 at 20:15 UTC - 0 likes

    Hi, Just wanna check , why is it that when i enable Shadowed unit frame. the challenge mode timer will be block. when I disable the addon, timer will appear. Anyway i can work around this to enable the timer and use this addon?

  • Avatar of machinelf machinelf Nov 19, 2012 at 07:41 UTC - 0 likes

    LOL i love you Shadowed

    Rehide Blizzard frames if they are shown while disabled without tainting them. Accounts for poorly done addons that forcibly show frames like VuhDo and HealBot

  • Avatar of Shadowed Shadowed Nov 18, 2012 at 20:30 UTC - 0 likes

    Nilvalue: Thanks, your way isn't quite how I want to fix it, but I'll have a fix up in a bit that is the equivalent to what you did.

    Exorti: Odds are you need to reset your SUF profile, and if you played on a private server then I can't help you at all on that. Odds are whatever issues you are running into are either related to an old SV or private servers.

  • Avatar of Nilvalue Nilvalue Nov 10, 2012 at 16:36 UTC - 0 likes

    Rangecheck bug solved

    I modify some lines in ShadowedUnitFrames\modules\range.lua and now its working well..


    if( spell ) then frame:SetRangeAlpha(IsSpellInRange(spell, frame.unit) == 1 and ShadowUF.db.profile.units[frame.unitType].range.inAlpha or ShadowUF.db.profile.units[frame.unitType].range.oorAlpha) elseif( UnitInRaid(frame.unit) or UnitInParty(frame.unit) ) then frame:SetRangeAlpha(UnitInRange(frame.unit, "player") and ShadowUF.db.profile.units[frame.unitType].range.inAlpha or ShadowUF.db.profile.units[frame.unitType].range.oorAlpha) else frame:SetRangeAlpha(CheckInteractDistance(frame.unit, 4) and ShadowUF.db.profile.units[frame.unitType].range.inAlpha or ShadowUF.db.profile.units[frame.unitType].range.oorAlpha) end


    if( spell ) then frame:SetRangeAlpha((IsSpellInRange(spell, frame.unit) == 1 or CheckInteractDistance(frame.unit, 4)) and ShadowUF.db.profile.units[frame.unitType].range.inAlpha or ShadowUF.db.profile.units[frame.unitType].range.oorAlpha) end

    Last edited Nov 11, 2012 by Nilvalue
  • Avatar of Nilvalue Nilvalue Nov 08, 2012 at 17:34 UTC - 0 likes

    Hi, I find a bug about the rangecheck function: SUF cannot check the range between player and the friendly units who are unhealable or enermy units who are unattackable.

  • Avatar of Exorti Exorti Nov 02, 2012 at 18:15 UTC - 0 likes

    Hey! I'm back in the game after 1½ years and the first thing I did was to get SUF. But I currently have three problems.

    1. Each time I click on a player/NPC, the game freezes up like a tenth of a second. 2. My target plate is just a black window. I can see my targets target and everything else except that. 3. When I unlock frames to configurate them, they get stuck in the unlocked position. It seems to randomly get stuck with some things in configuration mode.

    It might be worth adding that during my time away from wow, I played some privateservers aswell, which the client I downloaded from When I bought real wow two weeks ago it kind of merged the new real with the old one. Maybe thiis is a part of the problem?

    PS. Great addon, really clean and nice!

    Edit: If it's worth adding, I bought a battlechest that doesn't contain Cataclysm & MoP, havent bought those yet. so I only have up to the Lich King expansion.

    Last edited Nov 02, 2012 by Exorti: Information
  • Avatar of Maurokakalos Maurokakalos Nov 01, 2012 at 11:44 UTC - 0 likes

    I love this addon but, I'm having a problem. When I'm targeting a unit the border highlight of the frame does not work. When I open the config window and uncheck / recheck the border highlight options it works ( not for the boss frames though which is most important for me atm) until I lock the frames. Then, it stops working again. Sorry if my post is not very explanatory , my English is not that good. Is there anything I can do to help you understand better the problem? Thanks for this great addon.

  • Avatar of pyakuz pyakuz Oct 31, 2012 at 15:44 UTC - 0 likes


    awesome frames! but evrytime i try respec some talents on my hunter i got error message from SUF... can u guys fix that?


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