ShamanPartyHeal offers Shamans easy one-button access to their healing spells for healing party members and themselves. Conceptually simple, this mod lets you heal the people who need it, without having to target them manually, or even having to deselect the enemy you're fighting. It also gives maximum mana efficiency, by looking at the talents that modify heal power (Purification) and the amount of hit points to be healed and will automatically use a lower rank of healing if the target doesn't need your biggest heal rank. This also works when not in a party, and this will save you mana by automatically selecting the healing spell that does the neccessary healing with the minimum mana use.

Features:

* Uses the spell and rank that gives the right amount of healing for the target.
* When in combat, it prefers the spells and ranks that maximises healing/time.
* When out-of-combat, it prefers the spells and ranks that maximises healing/mana.
* Automatically selects a lower rank if mana is low.
* Considers the Purifaction talent to adjust spell and rank selection.
* Considers the health lost during channeling of the healing spell and adjust the healing needed accordingly.
* Detects if Nature's Swiftness is active and uses the spell and rank that maximises healing/mana.
* If a target is out of range or not in line of sight, that player will be blacklisted for 5 or 2 seconds respectively.
* Target a player who is not in your party, and he will be the target of the heal, if no one in the party or yourself needs healing.
* If you don't have Lesser Healing Wave, it will fall back to Healing Wave (pre-level 20 characters)
* Configuration panel with build-in help function to configure options that affect the decisions. Type '/sph cfg' to activate.



Basic Usage:
Use the standard key bindings interface (in the menu) to bind a key to use for healing. Whenever you think anyone (or yourself) need healing, push the button, and the mod will automatically decide which healing spell and rank to cast, and who to cast it on. When the healing spell has been cast, you return to attacking whatever you were attacking before invoking the command. The key binding 'Heal' will target any party member or yourself, while the key binding 'Heal Self' will always target yourself. Alternatively, if you want a toolbar button that can be triggered with the mouse, bind the command '/sph' or '/sph self' to a macro button (type '/macro' in chat to open the macro interface).

Advanced Usage:

* The default settings will work nicely for most people. If you want to change any settings, type '/sph cfg' to bring up the configuration panel.
* Targeting someone who is not in the party, will temporarily include them in the party with lowest priority for as long as they remain targetet. That is, they will only be healed if no one in the party needs healing. Because health can only be determined for party members, the healing needed will be estimated and the appropriate spell and rank will be used. This is very usefull for casually healing strangers that seems to be in over their head, without inviting them into the party, or using dedicated healing spells on the action bar.
* Targeting a party members pet, will temporarily raise it's priority for as long as it remain targetet, so that it is considered equal to party members, regardless of the setting in the configuration panel. This is usefull if you don't normally heal pets, but need to heal a dying pet. Simply target it, and it will get the same priority as party members and hence be healed if it is the one with lowest health.
* Targeting yourself, will temporarily raise your priority, for as long as you remain targetet, so that you take precendence over everyone else. If you don't need healing, anyone else who needs healing will be healed as was the case if you didn't target yourself. This behaviour is off by default and must be enabled in the configuration panel.



In depth details:
The system that decides which spell to use is based on analysis of the efficiency (life/mana) and healing rate (life/time) of the two single target healing spells available to the Shaman. As of patch 1.10 Lesser Healing Wave and Healing Wave has almost the same efficiency. However, Lesser Healing Wave is always the fastest healing. Nevertheless there is one reason for using Healing Wave, even in combat. Assuming that the player buys all skills when they are available, there will always be a rank of Healing Wave that is more powerfull than the best available Lesser Healing Wave. If a character who is healthy (defineable threshold) needs a very big heal (bigger than the biggest available Lesser Healing Wave), it will be more efficient (life/mana) to use the Healing Wave, instead of two smaller Lesser Healing Waves, and it would be safe to do so, since the target is healthy and there is no danger of him dying. Anyways, two Lesser Healing Waves takes 3sec to cast, just as the Healing Wave does, so no harm done. A different situation is out of combat, where it is simply most efficient both in terms of time and mana to use the healing spell that gives the target just the right amount regardless of the type of healing spell.

Based on these observations the decision system follows these steps:

* Find the party member, party member pet or external target with the lowest health if anyone has less than the General Healing Threshold (Default: 90%). By default pets will only be healed, if no party members need healing (can be changed in the configuration panel), and external targets will only be healed if no party members or pets need healing.
* Select the most suitable spell and rank based on:
* If in combat, use Lesser Healing Wave, unless one of these are true: a) Lesser Healing Wave is not available (sub level 20 characters) or b) The player has more life than the Healthy Threshold (Default: 70%) AND the Healing Wave gives a bigger heal than the biggest Lesser Healing Wave.
* If not in combat, use the spell that gives the most accurate amount of healing (this will save mana).
* If the player has less than the Selv Preservation Threshold (Default: 50%) life they take precedence and become the target.
* If the target is a party member, tell the party who you're healing (optional, off by default).


# If Nature's Swiftness is activated, the healing spell will be chosen as if out of combat, regardless of whether the healing target or the player is in combat or not.

Tips:
The threshold parameters can be set to other values in the configuration panel which can be brought up by typing '/sph cfg' in chat. If the Healthy Threshold is set to 100% (or simply larger than the General Healing Threshold), Lesser Healing Wave will always be used in combat since the target is never considered healthy. Additionally, if the Selv Preservation Threshold is set to 100%, the target for the healing will always be yourself ('permanent self preservation'). Alternatively the command '/sph self' forces the target for the heal to be yourself, if you only need it sometimes.

Originally written by Chris Hill / Aaron Lieberman
Rewritten and extended by Thomas Thorsen

Supported Commands:
/sph - Heals the party member that most need it with the best suited healing spell.
/sph cfg - Opens up the configuration panel.
/sph help - Displays command list (this list).
/sph self - Forces the target of the healing to be yourself.

TODO:
- Improve the method for determining if the caster is 'in combat'. The idea is to detect when the player is being hit, and consider the player out of combat when a certain time has passed since the last hit was received (4-6 sec.).
- Make it possible to display notifications in chat window instead of in the center of the screen (as an option).
- Add the possibility to only heal certain classes or player names, or to exclude certain classes or player names from healing.