PlateTweaks
Version 1.3.0  ·  World of Warcraft 12.1 (Midnight)

Colors enemy nameplate health bars and borders based on which of your own
debuffs are active on them.


INSTALL
-------
Extract the PlateTweaks folder into:

    World of Warcraft\_retail_\Interface\AddOns\

You should end up with ...\Interface\AddOns\PlateTweaks\PlateTweaks.toc

Restart the game, or type /reload if it is already running.


GETTING STARTED
---------------
Type  /pt  to open the settings window.

    1. Health Coloring -> New Rule
    2. Add a debuff from the dropdown, or type its name
    3. Click the color swatch and pick something you will notice

Use the Test buttons at the top of either coloring tab to see your colors on
real nameplates without needing the debuffs up.

Each rule has two panels: Edit Conditions (its debuffs) and Edit Color/
Appearance (its color, an optional Colored Texture fill from a small pattern
library, and whether it shows on your target/focus). A Colored Texture fill
can visually clash with target/focus highlight art some nameplate addons
already draw over the health bar -- the appearance panel warns about this
when it applies.

Cover missing health is a per-rule option in the same appearance panel. It
paints the empty part of the bar -- the health the unit has already lost --
in one opaque color, so the rule's coloring reads clearly no matter what your
nameplate addon draws there. Because it is opaque it will also cover other
addons' overlays on that side of the bar, which is the point, but worth
knowing before you turn it on. Its color and opacity are shared by every rule
that uses it, and the swatch appears at the bottom of the Health Coloring
rule list once at least one rule has the option enabled.


MODULES
-------
Health Coloring   tints the health bar
Border Coloring   draws a colored border, with its own separate rules
Aura Icons        an optional row of icons; off by default

Each is enabled independently in its own tab header. The window header lists
which are currently on.


COMPATIBILITY
-------------
Works with Blizzard's default nameplates and with other nameplate addons
(EllesmereUI, Plater, Platynator and others). It draws on whatever health bar
it finds rather than replacing your plates.

If your nameplate addon already shows aura icons, leave the Aura Icons module
off so you do not get two rows.


PERFORMANCE
-----------
Single-debuff rules are cheap. A rule requiring two debuffs at once costs
considerably more, because the game does not let addons read enemy auras and
every combination has to be covered in advance.

    One debuff      ~10 textures per nameplate
    Two debuffs     ~100 textures and ~11 frames

Two debuffs per rule is the maximum. Three is not a limitation of the addon
so much as of what the game still allows inside a dungeon, where the cost
grows per debuff rather than per texture.

If you ever see stutter, remove two-debuff rules first.


TROUBLESHOOTING
---------------
    /pt status

Prints what the addon has actually built on the nameplates in front of you.
Unlike the settings window it works in combat and inside a dungeon, which is
where problems tend to appear. Include its output in any bug report.

    /pt perf

Prints what the addon is costing right now, and projects that to a full pull
(40 nameplates). Textures and secure frames are the real cost, not CPU time,
which is why this counts those instead.

    /pt bar

For "the settings look right but this particular nameplate is not colored".
Reports what the addon found on your current target specifically: the health
bar it is drawing on, and whether each of that rule's textures is actually
visible. Useful when /pt status looks healthy but one plate does not.


HELP
----
Discord:  https://discord.gg/cdKSgKyCVJ

This addon is early and changing quickly. Bug reports and suggestions welcome.


CREDITS
-------
Font: Expressway, included in media/fonts.
Libraries: LibStub, CallbackHandler-1.0, LibSharedMedia-3.0.
Textures: some Colored Texture fill patterns (media/textures) used from
EllesmereUI.
