Note: This is a beta release. Everything that's completed should be stable, but there's a very limited set of configuration options, and I've not implemented buff filtering quite yet. Also, the description is out of date :P
Sage is a minimalistic, lightweight unit frame replacement designed to require minimal configuration. If you're looking for a set of unit frames with giant 3D models, or frames that are infinitely configurable, then Sage is not for you. If you're looking for a set of functional frames that "just work", then welcome home
Included Frames
Player, Target, Target of Target, Party, Pet, and Focus
Features
Low memory and CPU usage and a modular design
Simple Configuration
Highly Visible Debuffs: For friendly units debuffs are enlarged and displayed to the right. Healthbars are also set to change color whenever a friendly unit is debuffed.
Multiple styles for statusbar text
Range Checking for the Party Frames: Party frames can be set to fade out when out of range of a selected spell
Support for Clique, MobHealth, MobHealth3, and SharedMedia
Using Sage
Configuration
To bring up the options menu, type /sage or /sg
Docking: With sticky bars enabled, its possible to dock one frame to another by simply dragging next to the frame you wish to stick it to
Scaling: When unlocked, frames can be scaled by simply dragging its bottom right corner. Hold shift when dragging to scale all frames stuck to the one you're scaling
Disabling: You can disable a frame by disabling its addon in the Addons menu
Player Frame
The player frame displays your name, level, health, mana, pvp status, master loot status, group leader status, raid target icon, and optionally your experience or reputation
In a raid, your level display changes to show what raid group you are in
Your name's color changes based on your combat and resting status. Blue means you are resting, red means you are in combat
To toggle between watching reputation or experience, open the character menu (c by default) go to your reputation tab. To watch reputation, click on a faction and check the option to watch reputation. Uncheck it to go back to watching your experience
Target Frame
The target frame displays your target's name, level, health, mana, and raid target icon.
If you're targeting a unit controlled by a player, the target frame will display that unit's class, else the frame will display that unit's classification (humanoid, beast, etc), and elite status
The color of the name of your target is based on a large amount of conditions, and is similar to the colors of the Blizzard target frame
Combo points are displayed to the left of the frame. By default, combo points are displayed in a style similar to Tony Hawk games: Spelling out combo means you have a max amount of combo points
For friendly units, buffs are displayed at the bottom of the frame, with debuffs on the side. For enemy units, the arrangement is reversed
When your target starts casting a spell, a casting bar will appear in the unit classification area. It'll give you an icon of what the target is casting, and tell you how long until the spell completes
The Target of Target Frame
The target of target frame displays the same amount of information as your target frame, minus buffs, debuffs, and mana, though if you have health bar debuff coloring on, you'll still be able to see if your target of target is debuffed
The Focus Frame
The focus unit was added by Blizzard in 2.0.1. Its basically a secondary target you manually set and unset
Sage's Focus frame displays the same amount of information as the target frame
To set a unit as your focus, type /focus, and to clear it, type /clearfocus
You can setup key bindings for setting and clearing your focus in the key bindings menu (ESC, Keybindings)
The Pet Frame
The pet frame displays about the same amount of information as the player frame
Buffs are displayed at the bottom of the frame, debuffs to the right
For hunters, a happiness indicator is displayed to the right of the frame. It functions exactly like the blizzard provided one
Your pet's combat status is displayed by the color of your pet's name. Red means its in combat, white that its not
The Party Frames
Party frames show the standard amount of information as the other frames
Buffs are displayed below the frame, debuffs to the right
The color of the name of a member of your party signifies what class it is. The colors are the same as the ones used by the raid frames. In addition, if the given party member has aggro, their name will turn red
If one of your party members has a pet, a health bar for that pet will show up under the member's mana bar
You can set whether to show the party frame in a raid or not via the options menu
You can set what spell to use for range checking via the options menu
Slash Commands
/sg or /sage: Toggles the option menu
/sg lock: Toggles locking frame positions
/sg sticky: Toggles auto anchoring frames
/sg scale <frameList> <scale>: Sets the scale of <frameList>. 1 is normal scale
/sg setalpha <frameList> <opacity>: Sets the opacity of <frameList>
/sg texture <texture>: Sets the statusbar texture
/sg set <profle>: Switches settings to <profile>
/sg save <profle>: Saves current settings as, and switches to <profile>
/sg copy <profile>: Copies settings from <profile>
/sg delete <profile>: Deletes <profile>
/sg reset: Returns to default settings
/sg list: Lists all profiles
/sg version: Prints the current version
Change Log - Sage UnitFrames
3.2.7
* 3.2 bugfixes
3.2.6 (Beta)
* Buff bugfix
3.2.5 (Beta)
* 3.1 TOC bump.
* Potential bugfix for the party frame visibility issue
* I think my buff filtering is probably broken for 3.1, too. I'll try and fix it in a week or so.
3.2.3 (Beta)
* Fixed a bug causing party pet frames to scale crazily.
* Fixed a bug causing the width slider to not work.
3.2.2 (Beta)
* Fixed a bug with hiding party frames when in a raid.
* When in a raid, the level display will now switch to show what group you are in.
3.2.1 (Beta)
* Made the show in raid option work
* Added an assert to help me debug some things if something blows up
3.2.0 (Beta)
* Added a fix to theoretically make the combo point display work properly on Malygos
* Added a fix to theoretically fix the tagging color issue
* Added a global text mode selector
* Whenever Sage.Frame('id').sets[key] = value is called with a unique value,<key>_Change(newValue) is called for both the frame and its children
* Added a "Show Only Debuffs I've Cast" option to the target and focus frame
* Added a "Show Only Buffs I've Cast" option to all frames that have a buff display
* Added a "Display Combo Points as a Number" option to the target frame
3.1.5 (Pre-Beta)
* Completely recoded to be WoW 3.0.8 compatible/do what I want it to do.
Optional Files - Sage UnitFrames
Sorry, there are currently no optional files available.
I have one question tho, could it be possible to add support for druid mana bar? I mean to see druid mana in bear/cat form i think it shouldnt be big problem now cos blizzard support that yeah?
Sage exists because I hate giant configuration menus, and also because I cannot replicate sage using other addons (without too much work on my part). I've thrown out a 3.2 update to fix any redbox errors.
Originally posted by Tuller
Sage is a weird one for me: Its both my least popular, addon, but as complex as my major addons (Bagnon, Dominos). I want to drop it, but I cannot since there's no viable alternative in my eyes :P
I for one can appreciate your dilemma. So I'm posting to say first, thank you very much for the great addons you build and maintain. I have been using a few of yours for some time now, and they are really great.
With sage in particular, I'd like to echo what others have already posted - while it may not reflect large numbers, it is by far the most straightforward, accessible, and enjoyable unit frame addon I've ever tried.
I can't stand fiddling with all the seemingly endless configuration "options" that a lot of other unit frame addons require for a workable setup.
I can see how those would work for players who wanted or needed those options, but personally every time I try to setup pitbull or ag or shadowed uf or similar, it always ends up as an exercise in complete frustration for me. I always give up, and then mope around for days on end complaining about why there can't be a UF addon that "just works" and is easy to setup.
Sometimes, I wonder why blizz. won't just make their frames and panels move-able. If I could just move the blizz uf's bottom-ish central, just above the ends of my dominoes bars, sometimes I think I would just do that and to heck with it. As a tank, it's invaluable to me to have that info. well placed to complement my play-style so I can track imp. combat info.
So that's where sage unit frames came in for me. When I set the addon up for the first time, it was like a light-bulb went on, and I thought "this is perfect!".
So yea - I'm pretty much your ideal use-case for the addon. Sorry for the whole fan-boy trip - but my point is - maybe sage is more popular to a specific audience, than can be readily measured from the statistics you have on downloads etc.
Thanks again for the great addons; especially sage. I'll understand whatever you decide to do at this point - and please don't feel rushed - just wanted to show my support for the addon here.
I really like sage too, hope you don't give up on it. I try out other frames now and then, because sometimes I have minor issues with Sage, and because I'm an addon junkie. I can tell this one isn't your favorite though, it's not as rock solid as dominos and bagnon. But there's really nothing else like it, everything else i try is so damn cluttered and complicated i want to scream, so I stick with Sage
I know that Sage is more or less broken with 3.2. Not sure when I'll get around to fixing it.
Sage is a weird one for me: Its both my least popular, addon, but as complex as my major addons (Bagnon, Dominos). I want to drop it, but I cannot since there's no viable alternative in my eyes :P
thank you Tuller for this addon. i have gone back and forth between so many so many times and just came to the conclusion that i was doing too much. this keeps with my minimal design.
I dont get any errors and all the sage addons are enabled i just get the standard blizzard unit frames have tried it on 2 computers same thing. Have manually installed and used curseslient to install sage. Not sure at this point what to try.
Originally posted by Tahnok I have been trying to get suf to work the last couple days, but no mater what i try i can't get them to show up. The options menu is there but the frames themselves are not. I have tried loading them without any addons running but sage and still no luck. Also tried /run SageDB = nil; ReloadUI() idk if that would help my situation but i tried it anyway. Any help would be appreciated.
Do you get any error messages? Are all sage addons enabled?
I have been trying to get suf to work the last couple days, but no mater what i try i can't get them to show up. The options menu is there but the frames themselves are not. I have tried loading them without any addons running but sage and still no luck. Also tried /run SageDB = nil; ReloadUI() idk if that would help my situation but i tried it anyway. Any help would be appreciated.
Originally posted by joshwill80 yeah, only my buffs/debuffs are showing even though i have those options off. changelog makes it sound as if 3.2.5 caused this problem and 3.2.6 fixed it, unless i'm reading it wrong. regardless, buff filtering is still broken for me in 3.2.6.
This was broken for me for ages too. I found that toggling the show-own-buffs option a couple of times fixed it for me permanently. Probably an incorrectly saved setting thing resulting from the bugged version.
yeah, only my buffs/debuffs are showing even though i have those options off. changelog makes it sound as if 3.2.5 caused this problem and 3.2.6 fixed it, unless i'm reading it wrong. regardless, buff filtering is still broken for me in 3.2.6.