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.
Just started using Sage today actually, hope I enjoy it, was able to include a texture I'd wanted to match my raid frames just fine.
Under the following:
Sage > Style > ___________
[x] Show Casting Bars
I obviously have this checked, yet the default blizzard casting bar persists, is this a bug, or, is it only enabled for the Target Frame? If that's the case, how would I go about enabling it for the player frame?
------------------------
Also found this under Sage>obj>Click
SecureUnitButton_OnLoad(frame, id or parent.id, function() frame:ShowMenu() end)
--support for click casting mods that use the clique standard
ClickCastFrames = ClickCastFrames or {}
ClickCastFrames[frame] = true
I made it false, because I didn't want click2cast to be enabled for the player/target/tot/pet., but it did nothing.
Originally posted by teedog I am unable to get the "Show Party in Raid" option to stick to disabled after restarting WoW. Everytime I start WoW, the option is enabled again. Am I doing something wrong is is this a bug?
I am unable to get the "Show Party in Raid" option to stick to disabled after restarting WoW. Everytime I start WoW, the option is enabled again. Am I doing something wrong is is this a bug?
Originally posted by S9Th Well, I don't really think that Sage lacks something (except _maybe_ separate font size and bars height/width settings), just wanted to know the direction its development is following
The best thing about sage is auras (automatic scaling of enemy's buffs is pure win) and, well, don't know how to put it, "readability". Combining it with Satrina Buff Frame is much more convenient than all those bloated aura modules for pitbull and aguf.
Right. That's really what sage was designed for. I want to be able to see things, not have to stare at tiny text to determine if I need something etc. At the same time, I do not want too much information on screen at once. Thus I'm always looking to see if there's something I can move/alter.
Well, I don't really think that Sage lacks something (except _maybe_ separate font size and bars height/width settings), just wanted to know the direction its development is following
The best thing about sage is auras (automatic scaling of enemy's buffs is pure win) and, well, don't know how to put it, "readability". Combining it with Satrina Buff Frame is much more convenient than all those bloated aura modules for pitbull and aguf.
Originally posted by S9Th Thanks for the reply. I mentioned LibSharedMedia, because somehow Sage stopped seeing SM textures after i installed SharedMedia update. I believe, the reason for this is that Sage couldn't find the version of Sharedmedia library it supports among the loaded libraries. So embedding such a library, like you did with OmniCC or providing information where to get the needed version is a possible solution. Whether it is 3.0 or 2.0 doesn't really matter for me as the end user.
I also noticed that you added Ace3 branch at your google code page, though without any changes. Are you going at some point to implement layout system to support raid frames, for example? If possible, could you reveal some information about planned new features, if there are any.
Thank you very much in advance.
Sage did not include shared media, because when I implemented support for it, SharedMedia was dependent on Ace2. Sage will embed either LSM 2 or LSM 3.
Raid Frames: Not likely to happen. The main reasons for this are that: I'm not really a raider (my guild does Kara/ZA, but not enough that I see raid frames all of the time), and I'm perfectly (haha) satisfied with PerfectRaid.
I really think raid frames need to be more specialized than a generic unit frames addon.
Planned features: New options menu (bongos/omnicc like), library updates (hence the Ace3 branch name), and UI tweaks. Coloring health bars by class, coloring the pet bar's health by happiness, and using 1.4k instead of (1400) have all been implemented in either the trunk or Ace3 build, and will be fleshed out more as I try to streamline things. I will also be implementing a new debuff option: "Show only debuffs I've cast" The Sage bar code will also be synced up with the bar code from Bongos, though the only thing you'll probably see from that is relative positioning.
Redesign: If I ever really want to implement target of X frames, this will require me to redo the look of sage pretty drastically. I do not personally have a need for focus or party targets, so this is unlikely to happen.
I have all sorts of crazy ideas in my head for stuff (designer/runtime mode for unit frames, with some sort of painting mechanism for desigining), but I don't know if they will ever be seen :P
Originally posted by Tuller Sage will be updated, its just my other stuff has a higher priority right now.
LSM3: Maybe. There's a bit of an argument going on about the library right now, so I'm waiting for it to settle down.
MobHealth4: Only as an external.
Thanks for the reply. I mentioned LibSharedMedia, because somehow Sage stopped seeing SM textures after i installed SharedMedia update. I believe, the reason for this is that Sage couldn't find the version of Sharedmedia library it supports among the loaded libraries. So embedding such a library, like you did with OmniCC or providing information where to get the needed version is a possible solution. Whether it is 3.0 or 2.0 doesn't really matter for me as the end user.
I also noticed that you added Ace3 branch at your google code page, though without any changes. Are you going at some point to implement layout system to support raid frames, for example? If possible, could you reveal some information about planned new features, if there are any.
Originally posted by S9Th Are you planning to update Sage UF to support LibSharedMedia-3.0 and possibly LibMobHealth-4.0?
And will there be any other changes to Sage in the light of you writing Bongos3 and implementing Ace3 in most of your addons?
Sage will be updated, its just my other stuff has a higher priority right now.
LSM3: Maybe. There's a bit of an argument going on about the library right now, so I'm waiting for it to settle down.
Are you planning to update Sage UF to support LibSharedMedia-3.0 and possibly LibMobHealth-4.0?
And will there be any other changes to Sage in the light of you writing Bongos3 and implementing Ace3 in most of your addons?
Originally posted by molter200 First I want to thank you for this addon.
Having moved into Arena somewhat there is one thing I really miss which is a focus target to see who gets sheepd/manaburned and so on.
Optional Party targets and especcially a Focus target frame would make this addon perfect for me. I have downloaded the ToToT addition and wanted to ask if a focus target can be added likewise.
I just wanted to add my vote for these as well. Party Targets and Focus Targets are very important to me. I currently use MainAssist to help me with this, but would rather have it be part of my unit frames (and I don't want to use any of the big, bulky and fancy unit frames).
Originally posted by Tuller Party targets are not likely to happen, unless I do major design changes.
First I want to thank you for this addon.
Having moved into Arena somewhat there is one thing I really miss which is a focus target to see who gets sheepd/manaburned and so on.
Optional Party targets and especcially a Focus target frame would make this addon perfect for me. I have downloaded the ToToT addition and wanted to ask if a focus target can be added likewise.
Last edited by molter200 : 01-23-2008 at 12:48 PM.