The main focus of SUF is having a simplistic configuration, while maintaining flexibility that the vast majority of users care about, this prevents unnecessary bloat that sacrifices performance. While you aren't going to be able to set that you want the health bar to be exactly 3.14 pixels outside of the health bar, you can change options that you actually care about such as bar height, ordering, frame height and so on. All configuration can be done on multiple units at the same time through the global configuration, meaning if you want to set the height of Player and Target frames to 50, but then you want to set the height of Target's Target and Target's Target of Target to 30 you can easily do that with changing only two options, instead of having to do it four times for each unit.
For people who want to tweak every single setting, you can enable advanced configuration which will show extra settings for those who have to tweak every little thing they have to. However, you do not need to enable this by default, and most people should not need to enable them.
Slash commands: /shadoweduf (/suf shorthand)
Includes the general features you expect in an unit frame, like health bars, the two new ones it has are anchoring and visibility:
Modules
SUF includes basic module support, if you're interested in building a module see the documentation documentation on my github site for more information.
Currently released modules are:
Arena frames by myself
CC Timers on portraits by Proditor.
Five second rule by Kemayo
Power bar colored by class by moniker
Aura indicators for raid frames by myself
Smooth bar updates by Antiarc
Bar growth/empty bars by myself
Anchoring
For those who are driven crazy because their frames look to be half a pixel off center of your player frames, you can simply anchor the frame to the player frames and solve the hassle of aligning everything. For example, the target frames are anchored to the right of the player frame, and the ToT frames are anchored to the top of the player frames (In the screenshots).
If you tried to drag player, all the other frames will follow it in the same anchoring. Each frame can still be manually positioned and put wherever you want, but this gives you a way of easily anchoring everything and keeping frames nice and aligned without having to use a ruler.
Visibility
If when inside an arena you want to see your totot or party's target, but in a raid you don't want to see either of those then instead of having to manually change settings or swap profiles on zoning you can set SUF to do it automatically. Modules can be set to be disabled inside raid instances, but enabled inside a party instance, or a battleground.
Other features
- Tags: Includes a simple tagging system that can be customized in virtually any way using Lua, so even if something isn't included by default odds are you can make the tags.
- 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.
- Fader: Fades frames when out of combat and inactive (100% mana/no target)
- Rune/totem bars: Supports simple rune and totem bars inside the players unit frames.
- Highlighting: Can highlight frames off of mouseover, debuffs you can cure, aggro, target and focus.
- 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: Profiles can be changed without having to do a UI reload, lets you quickly change settings based on where you are without the hassle of it either being buggy or having to reloadui each time.
And pretty much the usual UF features, indicators for leader/raid targets/etc, cast bars, portraits, combat text.
Author: Shadowed <shadowed.wow@gmail.com>
Date: Tue Nov 3 23:11:29 2009 -0800
- Combat fader will now fade back in when the player is casting a spell
- Localization update
- Updated LibHealcomm to 1.5.3
- Added [hp:color] tag, returns a color code of the units health left, works the same as color bar by health, but in color code form
- Changed [abs:incheal] to be rounded, no more decimal incoming heal values
- Always registering for threat updates now, too annoying to try and figure out what's going wrong with the other version
- Moved code around to support the new [hp:color] tag
- Added option to disable cooldown rings completely, not exposing it yet
Date: Mon Oct 26 08:33:45 2009 -0700
- Updated LibHealComm-4.0
Date: Sun Oct 25 13:13:00 2009 -0700
- Removed duplicate check for creating child units
Date: Sat Oct 24 20:40:49 2009 -0700
- Fixed "Hide in 5-man raid option" now hides when there are 6 or more people in a raid rather than 5 or more
- Fixed typo in "Hide in 5-man raid" option for party frames, it's supposed to hide party frames in a raid with more than 5 people (as description indicates)
- Localization update
- Updated LibHealComm-4.0 to 1.5.2
Date: Thu Oct 22 11:51:15 2009 -0700
- Fixed UpdateThreat not resetting the hasPercent flag, might fix the delay in threat update
Date: Tue Oct 20 18:02:42 2009 -0700
- Updated LibHealComm-4.0 and LibWrapperHealComm-1.0
- Removed another incoming heal reference
- Library update
- Changed incoming heal bar to be hidden as soon as the heal changes instead of delaying it until next health update
Date: Mon Oct 19 07:18:51 2009 -0700
- Added UnregisterUpdateFunc
- Fixed aggro updates being registered for units that did not need it
Date: Fri Oct 16 22:26:31 2009 -0700
- Registered UpdateThreat to be called when the frame does a full update, should fix aggro warnings become stuck for targets sometimes
- Fixed temporary enchants not being updated when refreshed before they end
- Changed power API calls to check <= 0 rather then == 0 before displaying a number, should fix -longnumbehere when doing the Drak'Tharon Keep last boss
- Fixed a bug in [smart:curmaxpp] causing it to not update correctly
Merge: 2b67262 a5e537b
Date: Thu Oct 15 16:58:55 2009 -0700
Merge branch 'master' of git@github.com:Shadowed/ShadowedUnitFrames
Date: Tue Oct 13 18:45:15 2009 -0700
- Localizaiton update (Thanks wowui.cn!)
Once more with more feeling!
- Once more with feeling
Reverted before playing with wowace repo
Date: Mon Oct 12 20:34:38 2009 -0700
- Fixed indicators changing everytime an option was changed when using mover frames
- Fixed leader frame being recreated everytime OnEnable is called (Oops!)
- Moved aura examples to the auras file rather then the movers
Installation Guide
- Exit "World of Warcraft" completely
- Download the mod you want to install
- Make a folder on your desktop called "My Mods"
- Save the .zip/.rar files to this folder.
- If, when you try to download the file, it automatically "opens" it... you need to RIGHT click on the link and "save as..." or "Save Target As".
- Extract the file - commonly known as 'unzipping'
Do this ONE FILE AT A TIME!
- Windows
- Windows XP has a built in ZIP extractor. Double click on the file to open it, inside should be the file or folders needed. Copy these outside to the "My Mods" folder.
- WinRAR: Right click the file, select "Extract Here"
- WinZip: You MUST make sure the option to "Use Folder Names" is CHECKED or it will just extract the files and not make the proper folders how the Authors designed
- Mac Users
- StuffitExpander: Double click the archive to extract it to a folder in the current directory.
- Verify your WoW Installation Path
That is where you are running WoW from and THAT is where you need to install your mods.
- Move to the Addon folder
- Open your World of Warcraft folder. (default is C:\Program Files\World of Warcraft\)
- Go into the "Interface" folder.
- Go into the "AddOns" folder.
- In a new window, open the "My Mods" folder.
- The "My Mods" folder should have the "Addonname" folder in it.
- Move the "Addonname" folder into the "AddOns" folder
- Start World of Warcraft
- Make sure AddOns are installed
- Log in
- At the Character Select screen, look in lower left corner for the "addons" button.
- If button is there: make sure all the mods you installed are listed and make sure "load out of date addons" is checked.
- If the button is NOT there: means you did not install the addons properly. Look at the above screenshots. Try repeating the steps or getting someone who knows more about computers than you do to help.
Translations
When you download a mod, please be sure that the mod is compatible with your translation of wow. Some mods only work on the US versions, while some only work on some of the various European versions. These variations are called "Localizations".
TOC Numbers (Out of Date Mods)
When Blizzard patches WoW, they change the Interface number. This means that all mods will be "out of date" unless or until the author releases a new version for that interface. Some people go into the .toc files and update the numbers themselves, but this is STRONGLY advised against as it will cause problems locating possible incompatibilities addons. When you log into WoW after a patch, you DO NOT have to delete your interface directory. All you have to do is simply tell WoW to ignore the interface numbers and load all the mods anyway. All you have to do is, while at the "character select" screen, look in the lower left corner and click on the "addons" button. A window will pop up listing all your installed mods.
If you look in the upper left corner of that window there should be a box that says "Load Out of Date AddOns". You want to CHECK this box. Now simply go into WoW normally and all your mods should load. As of the 1.9 patch, you will have to do this after EVERY patch/update that Blizzard posts! If you encounter any problems with a mod after a patch, please be sure to let the author of the mod know so they can fix it.
See also: About "Out Of Date AddOns"
Mac Support
WoW addons are not platformed based. As such, they can be used on either Mac or PC. You can extract both .zip and .rar files on a Mac using StuffitExpander.
Directory Structure
World of Warcraft
|_ Interface
|_AddOns
|_*AddonName*
|_ *AddonName*.toc
|_ *AddonName*.xml
|_ *AddonName*.lua
|_ (possibly others as well)...