
HealPoints - A WoW benchmark addon for healers, Version 1.1
================================================================

1: About
2: Usage
3: Formulas used
4: HealPoint stats
5: Equipment supported
6: Talents supported
7: Known bugs and shortcomings
8: Frequently asked questions (FAQ)
9: Version history

----------------------------------------------------------------
1: About
----------------------------------------------------------------

HealPoints was developed by Eridan, Argent Dawn EU.
With assistance from Melthruil (coding and testing), Elanae 
(testing) and Tas (testing).

HealPoints uses a modified version of the BonusScanner 
library by CrowleyAJ. http://ui.worldofwar.net/ui.php?id=1461

HealPoints was inspired by TankPoints by Whitetooth.
http://www.curse-gaming.com/mod.php?addid=1365

----------------------------------------------------------------
2: Usage
----------------------------------------------------------------

The addon is accessed from the Character Info sheet. Below the 
character, the computed HealPoints benchmark value will be displayed
(healing classes only). If you mouse-over the "HealPoints: xxxxx"
line, additional information (such as mana regen) will be displayed.

If you click on "HealPoints: xxxxx", the HealPoints Calculator will
be displayed. The calculator is divided into three parts. Several of
the displayed stats have explanatory tooltips - just mouse-over.

The bottom part displays basic stats such as intelligence and spirit.
These stats can be adjusted using buttons or by entering a value directly.
You can then observe how this will change other stats. (Useful to
choose between +24 healing or +4 mana/5s enchants for your new bracer,
for example)

The middle part displays stats about the healing spells your 
character knows. You can select the different spells using the
drop down menus. The right drop down menu is used for heal-over-time
(HoT) spells and is only used for priests and druids. For each of
the selected spells, HP/sec, HP/mana and Total healing are displayed.
Total healing is the amount of HP you can heal with the selected spell
using a full mana bar (mana regeneration is not considered).

The top part explains how the HealPoint stat is computed. It consists
of three parts: PowerPoints, EndurancePoints and RegenPoints. Each
of these is explained by tooltip and in section 4 of this document.

----------------------------------------------------------------
3: Formulas used
----------------------------------------------------------------

Effect of spirit:
Spirit increases normal mana regeneration. For priests 13 + 
spirit / 4 is regenerated every 2 seconds. For paladins, druids
and shamans, the value is 15 + spirit / 5. (For very low levels of
spirit (<50) these formulas are no longer accurate.)

Intelligence and spell crit:
Int increases the chance for a spell critical. HealPoints calculates
this as intelligence / 59.5. This was the formula given by Tseric on
the WoW US Mage boards:

	"The basic mechanic of INT to Crit% is an increase of 1% every 
	59.5 points for mages. A mage is generally expected to have around 
	286 points of INT at 60. This works out to about 5% crit on average for 
	mages. It is possible to go higher, as Crit% does go up incrementally.
	EDIT- The increase of 1%crit for 59.5 is for everyone, not just mages. 
	However, mages tend to have more INT, thus my phrasing.

A spell crit increases the healing effect by 50 %. Heal-over-time spells 
cannot crit. (For regrowth the burst part can crit, the HoT part not.)

+healing and spell casting time:
The effect of +healing equipment varies with spell casting time.
For burst spells, casting time of 3.5s or longer gives full effect. 
Faster spells get x/3.5s of the +healing bonus
(where x = casting time). Heal over time (HoT) spells are 
treated similarly, but with 15s instead of 3.5s. For these 
spells, the +healing bonus is divided between each HoT tick.
If a spell has reduced casting time (from talents or equipment),
the original casting time is used to find the effect of +healing.

+healing and lowlevel spells:
Healing spells learned before level 20 have reduced effect
from +healing equipment. From extensive testing, I've come up
with the following approximation: effect = 0.03737 * lvl + 0.25263
where lvl is the level the spell is learned.

+healing and regrowth:
For regrowth, the +healing bonus is split in two. Half is applied to
the HoT-effect and 2.0/3.5 of the other half is applied to the
burst heal effect.

Blessing of Light and lowlevel spells:
BoL also have reduced effect for spells learned before level 20.
I've found these values: Holy Light rank 1: 0.2; rank 2: 0.4; 
rank 3: 0.7

----------------------------------------------------------------
4: HealPoint stats
----------------------------------------------------------------

PowerPoints:
Hitpoints healed in 30 seconds using your most
powerful spell, starting with full mana bar.
Regeneration and 5 second rule are taken into account.

EndurancePoints:
Hitpoints healed in 3 minutes using your most
efficient spell, starting with empty mana bar.
Regeneration and 5 second rule are taken into account.

RegenPoints:
Mana regenerated in 1 minute using normal regen.
I.e. outside the 5 second rule.

----------------------------------------------------------------
5: Equipment supported
----------------------------------------------------------------

The BonusScanner library is used to detect 
* +healing 
* +mana/5s 
* +spell crit
* +spell crit (holy)

It has also been modified to support the following set/equip bonuses:
* Allows x% of your Mana regeneration to continue while casting.
* Improves your chance to get a critical strike with Nature spells by x%.
* Reduces the casting time of your Regrowth spell by 0.x sec.
* Reduces the casting time of your Holy Light spell by 0.x sec.
* -0.x sec to the casting time of your Flash Heal spell.
* Increases the duration of your Rejuvenation spell by x sec.
* +x damage and healing spells.

In addition, HealPoints has special support for the following items:
* Shard of Afrasa

----------------------------------------------------------------
6: Talents supported
----------------------------------------------------------------

Druid:
Balance
	Moonglow
Feral Combat
	Heart of the Wild
Restoration
	Improved Healing Touch, Reflection, Tranquil Spirit,
	Improved Rejuvenation, Gift of Nature, Improved Regrowth

Paladin:
Holy
	Divine Intellect, Healing Light, Illumination, Holy Power
Blessing of Light (all ranks) is also supported.

Priest:
Discipline
	Mental Agility, Mental Strength, Meditation
Holy
	Improved Renew, Holy Specialization, Spiritual Healing,
	Improved Healing, Master Healer

Shaman:
Enhancement
	Ancestral Knowledge
Restoration
	Improved Healing Wave, Tidal Focus, Tidal Mastery, 
	Purification

----------------------------------------------------------------
7: Known bugs and shortcomings
----------------------------------------------------------------

Normal mana regeneration values are not accurate for
very low spirit values (below 50 or so).

Crit% = Intelligence / 59.5 is used for all classes and
levels even if the formula is probably only correct for lvl 60.

The following set bonuses are not supported:

Vestments of Transcendence
8: Your Greater Heals now have a heal over time component 
   equivalent to a rank 5 Renew.

The Earthfury
5: After casting your Healing Wave or Lesser Healing Wave spell, 
   gives you a 25% chance to gain Mana equal to 35% of the base 
   cost of the spell.
8: Your Healing Wave will now jump to additional nearby targets. 
   Each jump reduces the effectiveness of the heal by 80%, and 
   the spell will jump to up to two additional targets.

----------------------------------------------------------------
8: Frequently asked questions (FAQ)
----------------------------------------------------------------

Q: Why is (name of slow, powerful spell) selected as my most 
efficient spell and used to compute EndurancePoints when 
(name of fast, less powerful spell) has much higher HP/mana?

A: The advantage with slow, powerful spells is that you don't 
need to cast so many of them to heal a lot. And fewer casts 
means more time with normal mana regeneration. Fast spells may
be cheap, but they don't heal a lot so you need to cast more
of them - meaning little or no time with normal mana regeneration.

If there is a large difference between your casting regen and 
normal regen, a slow and powerful spell will probably heal more 
in 3 mins than a fast, less powerful. Actually, EndurancePoints 
are computed for all spells you know (except HoTs) with the spell 
giving the highest value selected as the most efficient. 

----------------------------------------------------------------
9: Version history
----------------------------------------------------------------

*** 1.0 ***

Initial release.

*** 1.1 ***

Added support for items with "+x damage and healing spells".

Added "Tot HP (+r)" stat which shows hitpoints healed with selected 
spell using the whole mana bar when casting regeneration is taken into 
account.

Fixed bug regarding the Tidal Mastery shaman talent.

Minor optimizations.