SUF focuses on a simplistic 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.
Slash commands: /shadoweduf (/suf)
Bug reporting
Because of how much of a pain dealing with comments on Curse is, I am disabling comments there. Please direct any bug reports to the ticket tracker.
Anchoring
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.
Units
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
Raid: Raid, Main Tank, Main Tank Target, Main Assist, Main Assist Target, Boss, Boss Target
Arena: Arena, Arena Target, Arena Pets
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
- Incoming heals: Supports LibHealComm-4.0 for incoming heal data which gives you more accurate information including heal over times and channels like Tranquility and Penance
- 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
- Fader: Fades frames when out of combat and inactive (100% mana/no target)
- Druid power/rune/totem bars: Supports simple rune and totem bars as well as Druid mana bars for the player frame
- 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.
Modules
Basic module support is included, should you be interested in building a module see the documentation on github for more information.
Currently released modules are:
CC Timers on portraits by Proditor.
Five second rule by Kemayo
Power bar colored by class by moniker
Aura indicators for unit frames by myself
Bar growth/empty bars by myself
PVP trinket based tags by myself
Damn Unit Sounds by myself, also not technically a SUF module it will restore the Blizzard sounds on targeting, focusing or toggling the PVP flag
tag v3.1
bdf4daddeeed5a41c8ea60598066b1d1a3e54e7f
Shadowed <shadowed.wow@gmail.com>
2010-01-17 15:12:31 -0800
Tagging as release 3.1
--------------------
Shadowed:
- Removed duplicate function call
- Separated raid frames can now be setup to use more than one row for group display
- Upped column spacing to -30 through 100
- Added groups per row/group row spacing options
- Added defaults for groups per row
- Removed AceTimer-3.0 embed
- Moved to the localizer on wowace to make it easier for people to translate
- *YOU WILL NEED TO UPDATE YOUR SUF MODULES AND RESTART YOUR GAME OR YOU WILL HAVE ERRORS*
- Moved all localization to ShadowUF.L
- Moved localization script to the scrapper -> site localizer version
- Changed 3D portraits around, will use the 3D question mark again if an unit cannot be found and in general made them a bit more reliable. Mostly I just stole what haste was doing in oUF
- Fixed predicated health/power/indicators not working after exiting configuration mod until a reload
- Fixed totems showing up at 100% when logging in
- Fixed layout serializer erroring if you tried to export/import a layout using SUF Indicators, you will need to reexport the layout for it to work
- Fixed 2D portraits not being tall enough when combo points were enabled, and the 3D portraits were enabled but they fallback to 2D
- Added a module event OnLayoutWidgets that fires when the bars/portrait and resized
- Tweaked frame levels a bit more to make the borders properly go below all indicators
- Updated zhCN and zhTW localization, thanks wowui.cn!
- When the player enters a vehicle, combat checking will switch to polling to get more accurate combat data, once they leave it will swap back to event driven
- Highlights will now appear behind text and indicators, but in front of the health bars/portraits, making them look more natural
- Fixed duplicate OnLayoutApplied in auras module
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)...
