This is early pre-release Alpha code... use at your own risk!

nUI is a user interface replacement. 100% standalone code designed to feel like Bliz meant the UI to look this way. nUI removes a ton of clutter from the display, provides detailed targeting information, an integrated HUD, cooldowns and more.

In the long run, it is intended as an alternative to a pile of add-ons such as custom unit frames, custom action bars, HUDs, minimap mods and so on.

There is much work remaining to be done, but this is a start. Feedback and suggestions are welcome, please keep in mind it is alpha code, incomplete and known to have bugs.

Currently supports integration of MobInfo-2, Recount, Omen2, KLH Threat Meter and Threat 2.0

Your donation to support continued development of nUI would be greatly appreciated! 

https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=kscottpiel@gmail.com&item_name=Make%20a%20donation%20to%20support%20nUI%20%20project%20development&no_shipping=1&no_note=1&tax=0&currency_code=USD&lc=US&bn=PP-DonationsBF&charset=UTF-8

Baby needs new shoes. ~smile~

Current Features...

-- No dependencies. 100% Original stand-alone code.
-- Greatly reduced screen clutter
-- Integrated unit casting bars w/ latency
-- Advanced targeting info... Pet Target, ToT, ToTT
-- Detailed HUD including player casts, cooldowns, threat and more
-- Advanced player casting bar with latency and GCD
-- Integrated cooldown counters, OOM and OOR indicators
-- Integrated range to target calculation
-- Integrated buff/debuff displays for all units
-- Integrated buff countdowns
-- Integrated mousewheel minimap zoom-in and zoom-out
-- Integrated mousewheel scrolling of chat and combat log
-- Integrated world coordinates
-- Integrated user interface reload "/nui rl"
-- Integrated support for MobInfo2 (mob health and data)
-- Integrated support for Recount (damage meters)
-- Automatic faction watching
-- Automatic management of MiniMap buttons
-- Expanded battlefield map
-- Adaptive buff/debuff display based on target reaction

============ INSTALLATION NOTES =============

There are no special installation requirements for this mod. Like any other mod, download the ZIP file and unzip its contents (with directory names intact) into your World of Warcraft "interface\addons" directory... typically that would be

    * c:\program files\world of warcraft\interface\addons

There is no configuration required. However, you can use /nui to get a list of the slash commands nUI understands.

The only special consideration during installation is what mods, if any, you have currently installed that nUI will be replacing. nUI has four key feature sets that may require you to disable mods you already have installed. If you have a mod installed that provides...

    * customized action bars (such as Bartender)
    * a HUD (like metaHUD)
    * custom casting bars (such as Quartz)
    * customized unit frames (player, pet, target, etc. such as x-Perl) 

... then I would suggest you consider disabling them to use the ones built into nUI.

See INSTALL.txt for more detailing installation instructions

============ Dashboard Scaling ================

By default, the nUI dashboard should exactly fit across your screen's width. The "gap" between the left edge of the chat window frame, the right edge of the information frame (where the battlefield map and bag bar are at present) and the bottom of both of those regions should be equal.

If you have open air to the left or right of the dashboard or part of the chat frame and information frame (as well as the bag bar) are chopped off, then you will need to adjust your nUI scale. I've tried to get as many of the common resolutions done as I could, but I know they aren't all correct. Nor does my display card support every possible resolution.

If you are using a resolution that is not in the nUI scaling table or you find I have a scale calculated incorrectly for the display resolution you use, you can correct that by using the slash command "/nui scale {n}" where {n} is some number between 0.5 and 1.5 -- the higher the number, the wider the nUI dashboard will become. You can use "/nui scale 0" to return to the default scale for the current resolution at any time.

Please... if you use a display resolution that is not in the nUI table or you find one of my existing scales is wrong, leave a message here in my comment section and let me know what display resolution you are using and what scale value you used to fit the nUI dashboard on the screen so I can update my scaling table.

Thanks.

============= MINIMAP BUTTON FIX ==============

If you encounter non-Blizzard minimap buttons that the button bag does not manage, please leave me a note with the name of the mod that causes the problem and I'll try to fix it in the next release.

========== INTEGRATED THREAT METER ============

nUI now has an integrated single target threat meter in the HUD. This meter may be based on Omen2 (or the Threat-2.0 library without Omen2 installed). The integrated HUD threat meter is comprised of a bar located directly below the player character on screen which will be colored according to the critical threat level.

The center point in the bar is the threat level of the character that currently holds the target's aggro. The left edge of the bar is equivalent to zero threat and the right edge of the bar is equivalent to twice the threat level of the current aggro holder. The remaining features depend on whether the player, the player's pet or a party member has aggro at that time and whether or not the player is in a party or a group and/or has a pet.

Regardless of all else, if the player does not have a pet, is not in a party and is not in a raid, the threat meter will not be displayed. Otherwise, the threat meter will only display if and when the player, the player's pet or party members are in combat. While in combat, if the player currently has aggro, the message "~AGGRO~" appears directly above the threat meter. If the player's pet has aggro, then the message "~PET AGGRO~" will appear directly above the threat meter. Otherwise, the name of the party/raid member who current has aggro is displayed.

The amount of threat estimated to be required to pull aggro on the target is indicated by a red tab to the right of center on the threat bar. This value represents 110% of the threat level of the current aggro holder if the player is in melee range, otherwise it is 130% of their threat level

If the player does not currently have aggro, the player's threat level is indicated by a light blue tab moving left to right on the top edge of the threat bar and the bar will color from green to red depending on how high the player's threat is relative to the current aggro holder's threat. If the player is in melee range, the bar will color full yellow at 90% of the aggro holder's threat and full red at 110% of the aggro holder's threat. Otherwise, the bar will color full yellow at 70% of the aggro holder's threat and red at 130%. If the player is not in a party or a raid and the player has pulled aggro from their pet, the bar will always color red. The player tab is not displayed when the player holds the target's aggro.

If the player's pet does not currently have aggro, then the pet's threat is indicated by a light blue tab moving left to right on the bottom edge of the threat bar. The threat bar does not ever color according to the pet's threat level. The pet's tab is not displayed when the pet holds the target's aggro.

The party/raid member with the highest threat level other than the player, the player's pet and the current aggro holder is indicated by a purple tab moving left to right along the top edge of the threat bar indicating their threat relative to the current aggro holder's threat. If the player currently holds aggro, then the bar will color according to that player's threat relative to the player's own threat. For tanks, this will indicate how "at risk" that player is for pulling aggro from you. If the player is soloing with a pet, or not other party/raid members have threat, this tab will not be displayed. 

If the player does not currently hold aggro, then the position of the player's threat indicator relative to the party/group member's threat indicator is a hint of what may be expected if the tank's aggro is wiped (i.e. a fear, etc.). In this event, threat can be expected to pass to whichever one is closest to the current aggro holder's threat at the time of the aggro wipe. If the player's blue marker is left of the party member's purple marker, the party member will most likely gain the target's aggro, otherwise the player will like gain the target's aggro. 

For the benefit of those unfamiliar with how to use a threat meter, here are some "strategy" notes to get you started. 

Main tank: your goal is to always hold the aggro. If you see your "~AGGRO~" message replaced by another player name above the threat meter, you've lost aggro and need to intervene, taunt and regain (for Warrior tanks, obviously). The closer the other party/raid member's threat indicator gets to the center of the meter, the more at risk for losing aggro you are. If their threat is right of center, aggro loss is imminent. If their threat is at or right of the red aggro gain marker, you need to take action now or be ready to react at any moment.

Off tank: when dual tanking mobs, the off-tank is seeking to keep their blue threat indicator between the next highest party/raid member's purple threat indicator and the center of the meter (the main tank's threat). If you begin to exceed the main tanks threat (your marker is right of center), you need to back down your threat generation or you risk pulling aggro from the main tank. As a rule, you want your threat marker as close to left of center as possible. If a party/raid member's threat indicator is between your indicator and center, they will gain the target's aggro if the main tank's aggro is wiped... you need to step up your threat generation or get them to back off their own.

DPS/CC/Healers: As a rule... you always want to keep your threat left of center on the meter. Right of center you are at high risk of pulling aggro from the tank and to the right of the aggro gain indicator you are nearly certain to pull aggro at any moment and should immediately feign death,fade, vanish, whatever you can do to clear your threat. If you are working with an off-tank, then you should keep your threat level to the left of both the center and the purple party/raid member indicator (which we would hope to be the off-tank's threat). If your threat level is between then purple party/raid member indicator and center, then you will gain aggro if the main tank's aggro is wiped. Back your threat down and get your threat marker left of the purple marker. 
