DISCORD UNIT FRAMES
by Lozareth

Unit frames the way you want them.

Overview

The Features

Slash Commands

Element Descriptions

Options Overview

Frame Options

Element Base Options

Buff Frame Special Options

Combo Points Special Options

Class Frames Special Options

Debuff Frame Special Options

Alternate Mana Bar Special Options

Elite Texture Special Options

Health Bar Special Options

Icon Special Options

Mana Bar Special Options

Portrait Special Options

Target Marker Special Options:

Quest Boss Icon Special Options:

Tempory Enchant Special Options

TextBox Special Options

TextBox for Alternate Mana

XP Bar Special Options

Misc Options

Context Colors

Text Variables

Profiles


Overview:

This mod provides you with player, party, party pet, target, and target of target unit frames. There's also special target elements of each frame to display a target frame for each unit. The frames are fully customizable and can be tweaked in almost any way you can imagine.
Back to Top

The Features:

  • Customize the frames in nearly any way you can imagine.
  • Special effects to make things more noticable such as flashing an object when a unit's health is low or fading the amount lost on a health or mana bar.
  • Multiple saved profiles let you store and load settings on the fly.
  • A convenient options window for tweaking everything in the mod. Access it by typing /duf.
  • Highly optimized for performance despite the mass of config options.
  • Download and install custom frames built by other players.
  • Display info not shown in the default frames.
    • Back to Top

    Slash Commands:

  • /duf - Toggles the options window
    • Back to Top

    Element Descriptions:

  • Buff Frame - A single frame that holds all the unit's buff icons.
  • Class Icon - Displays a different icon depending on the unit's class.
  • Combo Points - Combo points display for Rogues and Druids. It's an element of the TARGET frame only.
  • Debuff Frame - A single frame that holds all the unit's debuff icons.
  • Elite Texture - This is the gold dragon texture you see for elite units and the silver dragon texture you see for rare units. It's an element of the TARGET frame only.
  • Happiness Icon - Displays your pet's happiness. It's an elementof the PET frame only.
  • Health Bar - A status bar that updates based on the unit's health.
  • Leader Icon - An icon displayed if the unit is your party's leader.
  • Loot Icon - An icon displayed if the unit is your party's master looter.
  • Mana Bar - A status bar that updates based on the unit's mana.
  • Portrait - A picture of the unit.
  • PvP Icon - An icon displayed if the unit is PvP-flagged.
  • Race Icon - Displays a different icon depending on the unit's race. For the target it will display the target marker if applied.
  • Status Icon - Changes depending on if the unit is resting, in combat, dead, or disconnected.
  • Phased Icon - Displays when a party member exists in a content phase that is not compatible with yours ("out-of-phase").
  • Target Health Bar - A status bar that updates based on the health of the unit's target.
  • Target Mana Bar - A status bar that updates based on the mana of the unit's target.
  • Temp. Enchants - A frame displaying temporary weapon temporary enchant like Rogue poisons on main, offhand and thrown weapons.
  • TextBox - Special frames you can configure to display any sort of text.
  • XP Bar - A status bar that updates based on the unit's XP. It's an element of the SELF and PET frames only.
    • Back to Top

    Options Overview:

    Every editbox (boxes where you type in text) in the options window requires you to hit enter before it will update your settings.

    Open the options window by typing /duf or setting its keybinding.

    At the top of the options window you'll notice a row of unit tabs marked SELF, PARTY, TARGET, PET, PARTY PETS, and TARGET OF TARGET. Each of these tabs brings up options for a particular unit frame or set of unit frames.

    The property tabs down the left side are to modify a particular part of the selected unit frame. For example, if you select the SELF tab at the top and the Health Bar tab on the left, you'll be looking at options for your health bar. If you then select the PARTY tab at the top, you'll then be looking at options for the health bars of the 4 party member frames. You'll notice two additional tabs appear at the top for each element: Base and Special. Base options are options that all elements have. Special options are unique to that particular element.

    There are two special property tabs for Self. ^Class Properties^ and vGeneral Propertiesv. Selecting Class Properties brings up a list of extras property tabs for class specific elements like Monk Harony bar and Death Knight Rune Frame. the General Properties tab returns you to the default list of element tabs for Self. ** Special Note ** if the Paladin Power Bar is hidden and re-shown using DUF Options it will fade. You can get it back by setting it to show and then close/re-open the options window.

    All 4 party frames share the same set of options. All 4 party pet frames also share a set of options. There's no way to individually tweak those frames, all of them must be the same. They can however be dragged to different locations.

    The Misc Options button will bring up a set of options that are global to the mod and not tied to a particular set of frames. It's also where you load and create new profiles.

    The Context Colors button brings up options for setting your context colors. Context colors are described below.

    The Unlock Elements button will unlock dragging for the different pieces of all frames. Drag elements still remain relatively postitioned to whatever they're attached to. Dragging only changes its x and y offsets from the attach frame. Remember to lock elements before you close the options window or you may end up dragging them accidentally.

    The Unlock Frames button will unlock the full unit frames for dragging. Every part of the frame will be dragged instead of just pieces of it.

    Back to Top

    Frame Options:

    These options refer to the entire unit frame rather than just a piece of it.

  • Alpha - Sets the transpareny of the entire unit frame.
  • Background Alpha - Sets the transparency of just the frame's background.
  • Background Color - Sets the color of the frame's background.
  • Background Padding - Sets the amount of space between the frame's border and the frame itself.
  • BG Texture - Type in the filename of a texture to apply to the frame's background. The file must be in the WorldOfWarcraft\Interface\AddOns\DiscordUnitFrames\CustomTextures folder unless the Custom Paths option is checked under Misc. Options.
  • Border Alpha - Sets the transparency of the border around the frame.
  • Border Color - Sets the color of the border around the frame.
  • Border Style - Sets the appearance of the border around the frame.
  • Color Context - These options lets you set dynamic recoloring for different parts of the frame. The Main and Background options both affect the unit frame's background but do let you specify two different context colors for the background. So you could have update both in response to unit reaction and unit health. See the section on Context Colors below to find out what each of them are.
  • Connect Frames - This option will connect the party frames to each other and the party pet frames to each other so that you can drag them all by dragging the first frame in the group (party1 or partypet1).
  • Copy Settings From - Choose another frame in the drop-down to copy settings from it to the frame you're currently editing. Click the COPY button to copy the settings. If WoW crashes without an error message, use the SAFE COPY button instead. It will reload your UI instead of applying the settings immediately and will prevent WoW from crashing.
  • Custom Tooltip - Checking the box on the left will allow you to define a custom tooltip for the unit frame. Type in the text for the tooltip in the long editbox to the right. All text variables are supported in custom tooltips. See the section below on text variables.
  • Disable Mouse - This option will stop the frame from intercepting mouse clicks. You will be able to click through it if this option is enabled.
  • Disable Tooltip - Prevents the unit tooltip from showing up when you move the mouse cursor over the unit frame.
  • Flash When Health Is Low - The frame will start blinking in and out when the unit's health drops below a certain percentage. You can set the percentage for this with the Low Health Threshold in Misc Options. Default is 10%.
  • Height - Sets how tall the unit frame is.
  • Hide Background - Hides the colored background behind the frame and the border around the frame.
  • Hide - Hides the unit frame.
  • Left-Click, Right-Click, Middle-Click - Use these options to define what different mouse-clicks on the unit frame do. Target Unit targets the frame's unit. Assist Unit targets the target of the frame's unit. Show Pop-up brings up the unit pop-up with options for leaving a party, promoting a party member, renaming your pet, etc. Do Nothing sets that click to have no effect.
  • Method - This option defines how the frames are connected together when the Connect Frames option is enabled.
  • Mouseover Color - Checking the checkbox next to the color box will cause the frames background to change to that color while you have the mouse cursor over it.
  • Mouseover Group - Sets the element to a particular group for mouseover events. When one element in a group has the mouse over it, all other elements/frames in the same group within the unit frame are considered to have the mouse over them.
  • Scale - Sets the scale for the unit frame and affects all of its elements. Handy way to resize everything.
  • Show Default Frame(s) - This option causes the default UI's frame(s) for the selected unit to not be hidden. DUF can be used alongside the default frames to add to them instead of replacing them.
  • Spacing - This option defines the amount of space between each frame when the Connect Frames option is enabled.
  • Width - Sets how wide the unit frame is.
    • Back to Top

    Element Base Options:

    These options are options that all elements of a frame have.

  • Alpha - Sets the transpareny of the entire element.
  • Attach Frame - This lets you specify what the element is attached to. It will drag along with its attach frame and maintain its relative position to that frame. Base unit frames can only be attached to UIParent.
  • Attach Point - This lets you specify the side/corner of the element that is attached to the Attach Frame.
  • Attach To - This lets you specify the side/corner of the Attach Frame that the Attach Point is attached to.
  • Background Alpha - Sets the transparency of just the element's background.
  • Background Color - Sets the color of the element's background.
  • Background Padding - Sets the amount of space between the element's border and the element itself.
  • BG Texture - Type in the filename of a texture to apply to the element's background. The file must be in the WorldOfWarcraft\Interface\AddOns\DiscordUnitFrames\CustomTextures folder unless the Custom Paths option is checked under Misc. Options.
  • Border Alpha - Sets the transparency of the border around the element.
  • Border Color - Sets the color of the border around the element.
  • Border Style - Sets the appearance of the border around the element.
  • Color Context - These options lets you set dynamic recoloring for different parts of the element. The Main context color recolors the main part of the element such as a health bar's status bar or textbox's text. See the section on Context Colors below to find out what each of them are.
  • Custom Tooltip - Checking the box on the left will allow you to define a custom tooltip for the element that shows when you move the mouse over the element. Type in the text for the tooltip in the long editbox to the right. All text variables are supported in custom tooltips. See the section below on text variables.
  • Disable Mouse - This option will stop the element from intercepting mouse clicks. You will be able to click through it if this option is enabled.
  • Disable Tooltip - Prevents the unit tooltip from showing up when you move the mouse cursor over the element.
  • Flash When Health Is Low - The element will start blinking in and out when the unit's health drops below a certain percentage. You can set the percentage for this with the Low Health Threshold in Misc Options. Default is 10%.
  • Frame Level Offset - This sets the element's position within its Frame Strata. It's not recommended that you rely heavily on this option, WoW's handling of frame levels is pretty flaky.
  • Frame Strata - This sets the artwork layer the element is displayed in. They're ordered from lowest to highest. Elements in higher stratas will be displayed above those in lower stratas. Element backgrounds however always remain in the same strata and cannot be raised or lowered.
  • Hide on Mouseover - Sets the element to hide when the mouse is over it or any element in the same Mouseover Group.
  • Hide - Hides this element.
  • Left-Click, Right-Click, Middle-Click - Use these options to define what different mouse-clicks on the element do. Target Unit targets the element's unit. Assist Unit targets the target of the element's unit. Show Pop-up brings up the unit pop-up with options for leaving a party, promoting a party member, renaming your pet, etc. Do Nothing sets that click to have no effect.
  • Mouseover Color - Checking the checkbox next to the color box will cause the element's background to change to that color while you have the mouse cursor over it.
  • Mouseover Group - Sets the element to a particular group for mouseover events. When one element in a group has the mouse over it, all other elements/frames in the same group within the unit frame are considered to have the mouse over them.
  • Nudge - These buttons let you precisely change the position of an element as an alternative to dragging. Left-clicking one of them will move the element 1 unit in that direction. Right-clicking one of them will move the element 10 units in that direction. Middle-clicking and holding on one of them will keep the element moving until you release the middle mouse button.
  • Show on Mouseover - Sets the element to show when the mouse is moved over any element that's in the same Mouseover Group. Hidden elements cannot detect mouseovers. This means you must have at least one visible element in the Mouseover Group that triggers all other elements in the same group to show.
  • X - This lets you specify the horizontal distance between the element's attach points.
  • Y - This lets you specify the vertical distance between the element's attach points.
    • Back to Top

    Buff Frame Special Options:

    Special Note About Buff Frames: All the buff frames change size to fit only those buffs which are active on the unit. This means they will grow away from and shrink towards whatever you have set for the frame's Attach Point in Base options. For example, if you set the Attach Point to RIGHT then the buff frame will grow to the left as you gain more buffs and shrink to the right as you lose buffs.

    The yellow smiley faces you see when opening the options window are a placeholder texture to show you what the frame looks like when it's full.

  • Horizontal Spacing - This sets the amount of horizontal space between each icon.
  • Max Buffs Shown - This sets a cap on the maximum number of buffs that can be displayed in the frame.
  • Reverse Fill Direction - This option causes the second row or column of the buff frame to fill in first. It has no effect on the direction the frame grows. Visually it determines whether new icons are added to the end of a bar or inserted at the beginning with all other icons being pushed along effectively changing the order of icon display not the position of the bar.
  • Size - This option sets the height and width of each of the buff icons.
  • Two Rows/Columns - This option splits the buff icons evenly into two rows or two columns if the Vertical Layout option is checked.
  • Vertical Layout - This option lines up the buff icons vertically.
  • Vertical Spacing - This sets the amount of vertical space between each icon.

    • Options Unique to the SELF frame's Buff Frame:
  • Show Duration - Checking this option will cause a text display for each buff's remaining duration to be shown.
  • Duration Font Height - This option lets you specify the size of the font for the durations.
  • Duration Alpha - This option lets you specify the transparency of the text display of each buff's duration.
  • Duration X Offset - This option lets you specify the horizontal offset of the duration from the buff icon.
  • Duration Y Offset - This option lets you specify the vertical offset of the duration from the buff icon.
  • Duration Color - This option lets you specify the color of the text for the buff's duration.
  • Duration Font - This option lets you specify a font to use for buff durations. Just type in the filename of the font. All font files must be placed in the WorldOfWarcraft\Inteface\AddOns\DiscordUnitFrames\CustomFonts folder.
  • Use mm:ss Format - This options will cause the durations to be displayed in a minutes:seconds format. For example, if the duration has 90 seconds remaining then it will display 01:30.
    • Back to Top

    Combo Points Special Options:

    Combo Points is a special element that exists only for the TARGET frame.

  • Size - This lets you set the height and width of the combo points.
  • Vertical Layout - Checking this option causes the combo points to display in a single column.
  • Color - This lets you change the color of the combo points.
  • Spacing - This lets you set the amount of space between each combo point.
  • Custom Texture - This lets you specify a texture to use for each combo point. Just type in the filename of the texture. All textures must be placed in the WorldOfWarcraft\Inteface\AddOns\DiscordUnitFrames\CustomTextures folder unless the Custom Paths option is checked under Misc. Options.
    • Back to Top

    Class Frames Special Options:

    Monk Harmony (Chi), Paladin Power, DK. Rune Frames, Warlock Shards are special element that exist only for the SELF frame under the ^CLASS PROPERTIES^ tab

  • Vertical Layout - Checking this option causes the runes/orbs to display in a single column.
  • Center Align (where available) - Checking this option causes the runes/orbs to be arranged from the central rune/orb out instead of left to right.
  • Size - This lets you set the height and width of the runes.
  • Spacing - This lets you set the amount of space between each rune/orb.
  • Out of Combat Alpha - This lets you set the visibility of the bars when no target is selected. Unless hidden that nars are always at full visibilty when a target is selected. In the case of the Walock Fury text, it gains its OOC Alpha setting for the bar setting.
    • Back to Top

    Debuff Frame Special Options:

    Special Note About Debuff Frames: All the debuff frames change size to fit only those debuffs which are active on the unit. This means they will grow away from and shrink towards whatever you have set for the frame's Attach Point in Base options. For example, if you set the Attach Point to RIGHT then the debuff frame will grow to the left as you gain more debuffs and shrink to the right as you lose debuffs.

    The green frowny faces you see when opening the options window are a placeholder texture to show you what the frame looks like when it's full.

  • Flash When Active - This causes any active debuffs to pulse in and out.
  • Horizontal Spacing - This sets the amount of horizontal space between each icon.
  • Max Buffs Shown - This sets a cap on the maximum number of debuffs that can be displayed in the frame.
  • Reverse Fill Direction - This option causes the second row or column of the debuff frame to fill in first. It has no effect on the direction the frame grows. Visually it determines whether new icons are added to the end of a bar or inserted at the beginning with all other icons being pushed along effectively changing the order of icon display not the position of the bar.
  • Size - This option sets the height and width of each of the debuff icons.
  • Two Rows/Columns - This option splits the debuff icons evenly into two rows or two columns if the Vertical Layout option is checked.
  • Vertical Layout - This option lines up the debuff icons vertically.
  • Vertical Spacing - This sets the amount of vertical space between each icon.

    • Options Unique to the SELF frame's DeBuff Frame:
  • Show Duration - Checking this option will cause a text display for each debuff's remaining duration to be shown.
  • Duration Font Height - This option lets you specify the size of the font for the durations.
  • Duration Alpha - This option lets you specify the transparency of the text display of each debuff's duration.
  • Duration X Offset - This option lets you specify the horizontal offset of the duration from the debuff icon.
  • Duration Y Offset - This option lets you specify the vertical offset of the duration from the debuff icon.
  • Duration Color - This option lets you specify the color of the text for the debuff's duration.
  • Duration Font - This option lets you specify a font to use for debuff durations. Just type in the filename of the font. All font files must be placed in the WorldOfWarcraft\Inteface\AddOns\DiscordUnitFrames\CustomFonts folder.
  • Use mm:ss Format - This options will cause the durations to be displayed in a minutes:seconds format. For example, if the duration has 90 seconds remaining then it will display 01:30.
    • Back to Top

    Alternate Mana Bar Special Options:

    * Special Note * The Alternate Mana Bar displays a players mana (for those that have it) while the primary power bar shows their attack power level.
    This special element exist only for the SELF frame.

  • Height - Sets the height of the bar.
  • Width - Sets the width of the bar.
  • Mana Color - Sets the color for the bar to use when the unit's power type is mana.
  • Secondary Bar Color - Sets the color of the fading bar shown when the Fade Amount Lost option is enabled.
  • Fill Instead of Deplete - Causes the bar to fill from left to right instead of going down from right to left. Unfortunately there's no way to reverse the direction of a status bar or make it vertical.
  • Resize Based On Max Amount - Checking this option will cause the bar's width to increase or decrease based on the unit's max mana compared to yours.
  • Fade Amount Lost - Checking this option will cause an amount lost on the bar to fade out instead of immediately disappear.
  • Custom Texture - This lets you specify a texture for the bar to use. All textures must be placed in the WorldOfWarcraft\Inteface\AddOns\DiscordUnitFrames\CustomTextures folder unless the Custom Paths option is checked under Misc. Options.
  • Secondary Bar's Custom Texture - This lets you specify a texture for the bar that fades amounts lost when the Fade Amount Lost option is enabled. All textures must be placed in the WorldOfWarcraft\Inteface\AddOns\DiscordUnitFrames\CustomTextures folder unless the Custom Paths option is checked under Misc. Options.
    • Back to Top

    TextBox for Alternate Mana Bar
    * Special Note *These special elements exist only for the SELF frame.
  • Although this text box can be placed anywhere on the screen it displays in accordance to the rules of the players mana generation. There are special Text Variables specifically for displaying information related to this textbox. They have the same Special Options as other TextBoxes
    • Back to Top

    Elite Texture Special Options:

    This is a special element that exists only for the TARGET frame.

  • Custom Elite Texture - This lets you specify a texture to replace the default texture when you're targetting an elite unit. Just type in the filename of the texture. All textures must be placed in the WorldOfWarcraft\Inteface\AddOns\DiscordUnitFrames\CustomTextures folder unless the Custom Paths option is checked under Misc. Options.
  • Custom Rare Texture - This lets you specify a texture to replace the default texture when you're targetting a rare unit. Just type in the filename of the texture. All textures must be placed in the WorldOfWarcraft\Inteface\AddOns\DiscordUnitFrames\CustomTextures folder unless the Custom Paths option is checked under Misc. Options.
  • Faces Left - Checking this will flip over the elite texture so that the dragon faces to the left.
  • Size - This lets you set the height and width of the elite texture.
    • Back to Top

    Health Bar Special Options:

    * Special Note * The Target Health Bar displays health for the target of the unit it belongs to. So the Target Health Bar for the pet frame will display health for whatever your pet is targetting.

  • Height - Sets the height of the bar.
  • Width - Sets the width of the bar.
  • Bar Color - Sets the color of the bar.
  • Secondary Bar Color - Sets the color of the fading bar shown when the Fade Amount Lost option is enabled.
  • Fill Instead of Deplete - Causes the bar to fill from left to right instead of going down from right to left. Unfortunately there's no way to reverse the direction of a status bar or make it vertical.
  • Resize Based On Max Amount - Checking this option will cause the bar's width to increase or decrease based on the unit's max health compared to yours.
  • Fade Amount Lost - Checking this option will cause an amount lost on the bar to fade out instead of immediately disappear.
  • Custom Texture - This lets you specify a texture for the bar to use. All textures must be placed in the WorldOfWarcraft\Inteface\AddOns\DiscordUnitFrames\CustomTextures folder unless the Custom Paths option is checked under Misc. Options.
  • Secondary Bar's Custom Texture - This lets you specify a texture for the bar that fades amounts lost when the Fade Amount Lost option is enabled. All textures must be placed in the WorldOfWarcraft\Inteface\AddOns\DiscordUnitFrames\CustomTextures folder unless the Custom Paths option is checked under Misc. Options.
    • Back to Top

    Icon Special Options:

  • Size - Sets the height and width of the icon.
  • Show Circular Border - Shows a circular border around the icon. It does not replace the border modified in Base options but does use the Border Color set there.
    • Back to Top

    Mana Bar Special Options:

    * Special Note * The Target Mana Bar displays mana for the target of the unit it belongs to. So the Target Mana Bar for the pet frame will display mana for whatever your pet is targetting.

  • Height - Sets the height of the bar.
  • Width - Sets the width of the bar.
  • Secondary Bar Color - Sets the color of the fading bar shown when the Fade Amount Lost option is enabled.
  • Fill Instead of Deplete - Causes the bar to fill from left to right instead of going down from right to left. Unfortunately there's no way to reverse the direction of a status bar or make it vertical.
  • Resize Based On Max Amount - Checking this option will cause the bar's width to increase or decrease based on the unit's max mana compared to yours.
  • Fade Amount Lost - Checking this option will cause an amount lost on the bar to fade out instead of immediately disappear.
  • Custom Texture - This lets you specify a texture for the bar to use. All textures must be placed in the WorldOfWarcraft\Inteface\AddOns\DiscordUnitFrames\CustomTextures folder unless the Custom Paths option is checked under Misc. Options.
  • Secondary Bar's Custom Texture - This lets you specify a texture for the bar that fades amounts lost when the Fade Amount Lost option is enabled. All textures must be placed in the WorldOfWarcraft\Inteface\AddOns\DiscordUnitFrames\CustomTextures folder unless the Custom Paths option is checked under Misc. Options.
  • Mana Color - Sets the color for the bar to use when the unit's power type is mana.
  • Rage Color - Sets the color for the bar to use when the unit's power type is rage.
  • Energy Color - Sets the color for the bar to use when the unit's power type is energy.
  • Focus Color - Sets the color for the bar to use when the unit's power type is focus.
  • Hide If Unit Doesn't Use Mana - This will hide the bar if the unit doesn't have any sort of power: mana, rage, energy, or focus.
    • Back to Top

    Portrait Special Options:

  • Size - Sets the height and width of the portrait.
  • Border Color - Sets the color of the circular border if that option's enabled.
  • Use Class Texture For Players - Causes a class icon to be displayed for players instead of a portrait.
  • Flip Portrait - Reversed a display left to right (changes default right facing portrait to left facing and visa versa). Only effects 2D and 3D (Face only) portraits.
  • Show Circular Border - Shows a circular border around the portrait. It doesn't replace the border configured in Base options.
  • Use 3D models for portraits - replaces the 2D face portrait with a full length 3D view of the the unit. The portrait will display the unit in its current form eg. Druid flight form and perform basic racial animations (sighs, jiggles, crouch, AFK etc) as well as animations for Death and Ghost form.
  • Face only - zooms in do display the 3D face portrait only. There are no animations in this mode.
    • Back to Top

    Target Marker Special Options:

    These are special elements that exist only for the TARGET frame. They are use to SELECT a target icon to place over the targets head. The targets Race Icon will also display the selected marker.
  • Height - Sets the heigh marker parent frame.
  • Width - Sets the width marker parent frame. Sizing the height and width of the parent frame allows you to create a mouseover area for showing/hiding the marker buttons
  • Size - Sets the height and width of the of the marker buttons.
  • Hide Target Marker When Solo - Hides the marker buttons when not in a group or raid.
  • X - Sets the horizontal location of the individual marker.
  • Y - Sets the vertical location of the individual marker.
    • Back to Top

    Quest Boss Icon Special Options:

    This icon is a special element that exist only for the TARGET frame. It diplays when a target is lootable even if you weren't the player to initially tap the target.
  • Size - Sets the height and width of the of the marker buttons.
  • Custom Icon Texture - Texture to use for the icon.
    • Back to Top

    Tempory Enchants Special Options:

    These are special elements that exist only for the SELF frame.
  • Size - Sets the height and width of the frame.
  • Vertical Layout - This option lines up the buff icons vertically.
  • Vertical Spacing - This sets the amount of vertical space between each button when using Vertical Layout.
  • Horizontal Spacing - This sets the amount of horizontal space between each button when using not Vertical Layout.
  • Show Duration - Checking this option will cause a text display for each Temporay Enchant's remaining duration to be shown.
  • Duration Alpha - This option lets you specify the transparency of the text display of each buff's duration.
  • Duration X Offset - This option lets you specify the horizontal offset of the duration from the Temporary Enchant button.
  • Duration Y Offset - This option lets you specify the vertical offset of the duration from the Temporary Enchant button.
  • Duration Color - This option lets you specify the color of the text for the Temporary Enchant's duration.
  • Duration Font - This option lets you specify a font to use for Temporary Enchant durations. Just type in the filename of the font. All font files must be placed in the WorldOfWarcraft\Inteface\AddOns\DiscordUnitFrames\CustomFonts folder.
  • Use mm:ss Format - This options will cause the durations to be displayed in a minutes:seconds format. For example, if the duration has 90 seconds remaining then it will display 01:30.
    • Back to Top

    TextBox Special Options:

  • Font Height - Sets the size of the text.
  • Font - Lets you specify a font for the text to use. Just type in the filename of the font. All font files must be placed in the DiscordUnitFrames\CustomFonts folder.
  • Height - Sets the height of the box that holds the text.
  • Hide If No Text - Hides the textbox if all its variables return no text.
  • or Text is - Hides the textbox if all its variables and formatted text return a particular string literal (ie. if the textbox is set to display -$dt and the or Text is entry is set to -0, the textbox will hide when 0 (zero) damage is taken).
  • Hide If Unit Doesn't Use Mana - Hides the textbox if the unit doesn't have any sort of power type: mana, rage, energy, or focus.
  • Horizontal Justification - Sets the horizontal alignment of the text within the box.
  • Label - Lets you name the textbox so you can tell them apart more easily in the element tabs on the left side of the window.
  • Maximum Number of Characters - Sets the maximum number of characters that will be shown in the textbox. All characters beyond the max will be removed.
  • Text Color - Sets the color of the text. Duh.
  • Text Variables - Clicking this button pops up a window listing each of the text variables you can use in the TextBox's Text setting.
  • Text - Type in the text here you want the textbox to show. See the section on Text Variables for special characters you can enter to display data about a unit. Remember to hit enter after typing in the text.
  • Healt/Mana Format Break - Sets the point at which the $hk, $kh, $mk, $km text variables start displaying the thousands portion in decimal notation. See Text variables for formatting Health/Mana for a quick explanation.
  • Vertical Justification - Sets the vertical alignment of the text within the box.
  • Width - Sets the width of the box that holds the text.
    • Back to Top

    XP Bar Special Options:

    These are special elements that exist only for the SELF and PET frames.

  • Height - Sets the height of the bar.
  • Width - Sets the width of the bar.
  • Bar Color - Sets the color of the bar.
  • Secondary Bar Color - Sets the color of the rested XP display on the SELF frame's XP bar.
  • Custom Texture - This lets you specify a texture for the bar to use. All textures must be placed in the WorldOfWarcraft\Inteface\AddOns\DiscordUnitFrames\CustomTextures folder unless the Custom Paths option is checked under Misc. Options.
  • Secondary Bar's Custom Texture - This lets you specify a texture for the rested XP display beneath the SELF frame's XP bar. All textures must be placed in the WorldOfWarcraft\Inteface\AddOns\DiscordUnitFrames\CustomTextures folder unless the Custom Paths option is checked under Misc. Options.
    • Back to Top

    Misc Options

  • Hide Party Frames In Raids - Checking this option will cause the party and party pet frames to automatically hide while you're in a raid.
  • Hide Target of Target When Soloing - Checking this option will keep the Target of Target frame from being displayed when you aren't in a party.
  • Hide Default Buff Frame - Checking this option will hide the default UI's buff frame that displays up by the minimap.
  • Lock Frames & Elements When Closing This Window - Checking this option will cause frames and elements to lock dragging automatically when you close the options window.
  • Hide Self in Pet Battles - Checking this option will hide the player unit frames when you enter a pet battle.
  • Hide Target in Pet Battles - Checking this option will hide the target unit frames when you enter a pet battle.
  • Hide Party in Pet Battles - Checking this option will hide the party and party pet unit frames when you enter a pet battle.
  • Custom Paths (for textures and fonts) - Check this option to allow you to place textures and fonts in a folder(s) other than the hard coded Interface\AddOns\DiscordUnitFrames\CustomTextures\ and Interface\AddOns\DiscordUnitFrames\CustomFonts\. You will have to add the full paths for ALL textures and fonts you use ie. Interface\AddOns\YourFolder\YourTexture. The file extension is not required. Valid file formats are .BLP and .TGA
  • Root Path for (textures and fonts) - Enter a default path to your custom textures and fonts (a trailing slash "\" is required). Where ever you have entered only a texture or font file name without a fully qualified path the root path will be prefixed at runtime.
  • Updates Per Second - This option lets you set the maximum number of times all the frames and elements can be updated per second. If you're having any performance issues, turning this option down can help.
  • Load Profile - Choose a profile from the drop-down menu and click the LOAD button to load it. If the profile causes WoW to crash, use the SAFE LOAD button. It will reload the UI instead of applying your settings immediately and prevent the crash. Click the DELETE button if you wish to remove the selected profile.
  • Low Health Threshold - Type in the percent you want the Flash When Low Health options to use. Must be typed as a decimal number less than 1: .1 for 10%, .5 for 50%, etc.
  • New Profile - Type in a name and click the CREATE button to start a new profile. All your current settings will be copied to the new profile.
  • Options Window Scale - Lets you resize the options window.
    • Back to Top

    Context Colors

    This is where you set the colors each of the various context colors use. Context Colors are colors that change based on certain game conditions.

  • Class - These colors are based on the unit's class.
  • Difficulty - These colors are based on the unit's level relative to yours.
  • Health - These are the colors for when the unit passes certain health levels. The object will gradually recolor from its base color to the health colors. Use the Health % Less Than options to set the health level at which the object matches the color exactly. It must be typed as a decimal number less than 1: .1 for 10%, .5 for 50%, etc.
  • Mana - These are the colors for when the unit passes certain mana/rage/energy/focus levels. The object will gradually recolor from its base color to the mana colors. Use the Mana % Less Than options to set the mana level at which the object matches the color exactly. It must be typed as a decimal number less than 1: .1 for 10%, .5 for 50%, etc. Uncheck each power type you want this context color to ignore.
  • Reaction - These colors are based on the unit's reaction towards you.
    • Back to Top

    Text Variables

    The following variables will get replaced with different sorts of info when used in any TextBox or Custom Tooltip.
    NOTE: variables are case sensitive. You can select a variable and use the button (top/right of the text entry) to insert the variable into the text at the curent cursor position (select again to clear).
    NameVariable to Place in Your TextDescription
    Class, Abbreviation$caAn abbreviated form of the unit's class. War is Warrior for example.
    Class, Mob$cyDisplays class only for NPCs.
    Class, Player$clDisplays class only for players.
    Classification$ccDisplays ELITE, RARE, or BOSS if the unit is any of those.
    Classification, Abbreviation$cxDisplays + for elites, (R) for rares, and ++ for bosses.
    Color Code$coUsed to place hexadecimal color codes. All following text will be in that color. Format is $coAARRGGBB; AA = alpha, RR = red, GG = green, BB = blue. $coFFFFFFFF is white and $coFF000000 is black.
    Color Context, Class$cwApply class context colors to all the following text.
    Color Context, Difficulty$cqApply difficulty context colors to all the following text.
    Color Context, Health$chApply health context colors to all the following text.
    Color Context, Mana$cmApply mana context colors to all the following text.
    Color Context, Reaction$crApply reaction context colors to all the following text.
    Color Power Type$czApply the color that has been set of the units power type: Mana, Rage, Focus, Energy or Runic.
    Combo Points$cpDisplays the number of combo points you have.
    Creature Difficulty$cdDisplays the difficulty of the unit: Trivial, Minor, Even, Tough, Very Tough, Suicide.
    Creature Family$cfDisplays the creature family of a mob: Dog, Cat, Plainstrider, etc.
    Creature Type$ctDisplays the creature type of a mob: Beast, Elemental, Demon, etc.
    Death Status$dsDisplays DEAD if the unit is dead.
    Default Color Code$csAfter using $co you can use $cs to return to the default coloring set for the textbox.
    Demonic Fury Current$dcCurrent Demonic Fury for Warlocks specializing in Demonology.
    Demonic Fury Max.$dmMaximum Demonic Fury for Warlocks specializing in Demonology.
    Demonic Fury Percent$deDemonic Fury displayed as a percentage for Warlocks specializing in Demonology.
    Faction$faDisplays if the unit is Horde or Alliance.
    Gender$sxDisplays the unit's gender.
    Gender, Abbreviation$saDisplays an abbreviation of the unit's gender: M for male, F for female, N for neuter.
    Guild$guDisplays the unit's guild.
    Health, Current$hcDisplays the unit's actual current health. Uses MobInfo2 and MobHealth2 values if you have one of those installed.
    Health, Current in k$hkDisplays the unit's actual current health divided by 1000 to 1 decimal place.
    Health, Current Percent$hpDisplays the unit's current health as a percent of max health.
    Health, Dynamic$hdDisplays the unit's Status Dynamic
    Health, Lost$dtDisplays the total amount of damage the unit's taken.
    Health, Lost Percent$dpDisplays the total amount of damage the unit's taken as a percent.
    Health, Max$hmDisplays the unit's max health. Uses MobInfo2 and MobHealth2 values if you have one of those installed.
    Health, Max in k$khDisplays the unit's max health divided by 1000 to 1 decimal place.
    Health, Regen Per Sec$hrDisplays the amount of health the unit is regenerating per second.
    Health, Regen Per Tick$htDisplays the amount of health the unit is regenerating per tick.
    In Combat$icDisplays In Combat if the unit is in combat.
    Keybinding$kbDisplays the keybinding used to target a party member.
    Level$lvDisplays the unit's level.
    Mana, Current$mcDisplays the unit's current mana, rage, energy, or focus.
    Mana, Current in k$mkDisplays the unit's current mana, rage, energy, or focus divided by 1000 to 1 decimal place.
    Mana, Current Percent$mpDisplays the unit's current mana, rage, energy, or focus as a percent.
    Mana, Lost$mxDisplays the total amount of mana, rage, energy, or focus the unit has lost.
    Mana, Lost Percent$myDisplays the total amount of mana, rage, energy, or focus the unit has lost as a percent of max mana.
    Mana, Max$mmDisplays the unit's maximum amount of mana, rage, energy, or focus.
    Mana, Max in k$kmDisplays the unit's maximum amount of mana, rage, energy, or focus divided by 1000 to 1 decimal place.
    Mana, Regen Per Sec$mrDisplays the amount of mana, rage, energy, or focus the unit is regenerating per second.
    Mana, Regen Per Tick$mtDisplays the amount of mana, rage, energy, or focus the unit is regenerating per tick.
    Mana, Type$mlDisplays if the unit uses Mana, Rage, Energy, or Focus.
    Name$nmDisplays the name of the unit.
    New Line$nlInserts a line break into the text. All text following it starts on a new line.
    Next Level$xnUnits next level (Current level + 1).
    NPC$npDisplays NPC if the unit is an NPC.
    Offline$ofDisplays OFFLINE if the unit is disconnected.
    Out of Detect Range$ivDisplays OUT OF RANGE if the unit is beyond detection range, around 70 yards.
    Out of Phase$phDisplays Out-Of-Phase if the unit is not in the same content phase as the player.
    Pet's Current XP$pxDisplays the amount of XP your pet current has.
    Pet's Current XP Percent$pcDisplays the amount of XP your pet current has as a percent.
    Pet's Happiness$phDisplays a number representing your pet's happiness.
    Pet's Max XP Needed to Level$pyDisplays the maximum amount of XP your pet needs to gain a level.
    Player Title$tpDisplays the player current title (Player Only).
    PvP Name$nrDisplays the name of the unit inclluding title.
    PvP Flagged$ptDisplays PVP if the unit is PvP-flagged.
    PvP Time Left$pfDisplays the left before a player is no longer flagged for PvP.
    Race$rcDisplays the unit's race.
    Race, Abbreviation$raDisplays an abbreviated form of the unit's race: Und for Undead, etc.
    Raid Group$rgDisplays the number of the raid group you're in.
    Reaction$reDisplays the unit's reaction towards you: Hostile, Neutral, Friendly.
    Real Mana (Alt.)$rmA current real Mana level when displayed as an alternate.
    Real Mana Max. (Alt.)$rxA maximum real Mana level when displayed as an alternate.
    Real Mana Percent (Alt.)$rmA current real Mana displayed as a percentage when displayed as an alternate.
    Realm Name$rnDisplays the realm a unit belongs to in X-realm groups.
    Recent Damage$rdDisplays the last amount of damage the unit took. Also displays dodges, parries, blocks, and misses. Fades after 1 second.
    Recent Heals$rhDisplays the amount of the last heal the unit received. Fades after 1 second.
    Tapped$doDisplays TAPPED if another player has tapped the unit.
    Target's Creature Type$ttCreature type for the unit's target.
    Target's Health$thCurrent health for the unit's target.
    Target's Health Percent$taCurrent health percent for the unit's target.
    Target's Level$tlLevel of the unit's current target.
    Target's Mana$tmCurrent mana for the unit's target.
    Target's Mana Percent$tbCurrent mana percent for the unit's target.
    Target's Max Health$txMax health for the unit's target.
    Target's Max Mana$tyMax mana for the unit's target.
    Target's Name$tnName of the unit's target.
    Unit Casting$ucThe current spell a unit is casting.
    Unit Role$urThe units role (Tank, Healer, Damager.
    Watched Faction Rep.$wcThe watched factions current reputation value.
    Watched Faction$wfThe current watched faction.
    Watched Faction Max.$wmThe current watched faction maximum reputation.
    Watched Faction Percent$wpThe currently attained watched faction reputation as percent.
    Watched Faction Reaction$wrThe watched faction reaction to the player.
    XP, Current$xcDisplays the amount of XP you currently have.
    XP, Current Percent$xyDisplays the amount of XP you currently have as a percent.
    XP, Max Needed to Level$xlDisplays the maximum amount of XP you need to gain a level.
    XP, Needed to Level$xdDisplays the net amount (max - current) of XP you need to gain a level.
    XP, Needed to Level Percent$xxDisplays the net amount (max - current) of XP you need to gain a level as a percent.
    XP, Rested Bonus$xrDisplays the amount of extra XP you have from resting.
    XP, Rested Percent$xbDisplays the amount of extra XP you have from resting as a percent.


    IF variables. The following variables will display text and other variables following them only if the condition is met.
    $EN is a universal end of condition variable otherwise the provisional END variable(s), or the end of the text, will also signify and end of condition.

    Example: $PL$cw$nr$NP$cr$nm$EN
    $PL(if unit is player) $cw(use class color) $nr(set text to unit name and title) $NP(if unit is NPC) $cr(use reaction color) $nm(set text to unit name)

    IFVariable to Place in Your TextProvisional END variables
    Unit is a player $PL $NP
    Unit is an NPC $NP $PL
    Back to Top

    Profiles

    As of DUF v2.3 your settings are saved in shared profiles rather than per character. Multiple characters using the same profile will automatically get any changes you make while logged into any of those characters. You do not have to save a profile, all your changes are written directly to the profiles settings. If you want a character to use different settings from other characters, you will have to start a new profile for that character.
    Back to Top

    Text variables for formatting Health/Mana
    (Toggled with "Format/Text Variables" button)

    You can select when to begin displaying the thousands portion in decimal notation (x.xk, xx.xk, xxx.xk).
    In the /DUF options window for each text box (under the "Special" tab) there are two new dropboxes, one for setting "Health Format Break ($hk, $kh)" and one for setting "Mana Format Break ($mk, $km)". The one setting will be used on both their respective current and max. displays. The break points are 1,000, 10,000, 100,000. The default is 100,000.

    Once you hit a million the notations become xm or xxm followed by the specified thousand notation.

    These options work from 1 - 99,999,999 after which the value is displayed in millions to two decimal places xxx.xxm.

    There is also a "Non Decimal" option that just displays the raw numbers comma delimited.