HealBot

Healbot continues by Strife.

============================== Main host ==============================
 http://healbot.alturl.com
===============================================

HealBot allows for 20 key mouse combinations to cast any beneficial spells. 
HealBot allows for 20 key mouse combinations to cast on disabled bars. 
Any usable item can be added to all combos. 
Any existing macro can be added to all combos.
Target, Focus and Assist can be added to all combos 
HealBot can track and display who has aggro
HealBot can be used for decursive functions 
HealBot can be used for monitoring buffs and buffing 
HealBots appearance can be configured and preferred appearances can be saved as skins. 
HealBot can show party/tanks/checked targets/extras in a raid, extras can be filtered and sorted. 
Multiple HealBots in a party/raid sync incoming heals. 
HealBot will accurately range check at all times for spells and items. 
HealBot has a built in res monitor and is compatible with CTRA (CTRA not required) 
HealBot has a SmartCast out of combat option, this will cast a spell in the following order.. 

1. res 
2. decurse 
3. buff 
4. heal 
5. user setting


==============================================================================
Slash Commands:
==============================================================================

/hb o << open options panel 
/hb x << initiate spells and equipment bonuses 
/hb ri << reset bars displayed 
/hb info << display versions of Healbot in party/raid
/hb ui << reload ui
/hb defaults << Reset default options
/hb show << reset the position of the bars to default
/hb cb << Clears the BlackList


==============================================================================
Other addons:
==============================================================================

== Performance related issues. == 
Use this to see which addons are heavy on cpu/memory:  
http://www-en.curse-gaming.com/downloads/details/7934/


== Plugins ==
The titan plugin is available as a download.
http://healbot.alturl.com


==============================================================================
Frequently Asked Questions.
==============================================================================

1. Can I use HealBot with none healing classes.
2. Can the bars be sorted and only show those most needing heals and allow key/mouse combos to heal.
3. Will a future version of HealBot have a SmartCast feature while in combat.
4. Can I hide the incoming heals estimator.
5. Can I hide all the bars and only show those needing a debuff removed.
6. Can HealBot be sorted by groups, for example have 2 Groups per column.
7. I have a slow PC, are there any options I should set?
8. I can't see when people are out of range, how do I fix this?

Answers.
-------------------------
1: Can I use HealBot with none healing classes.
* Yes

2: Can the bars be sorted and only show those most needing heals and allow key/mouse combos to heal.
* Not possible in WoW 2.x

3: Will a future version of HealBot have a SmartCast feature while in combat.
* Not possible in WoW 2.x

4: Can I hide the incoming heals estimator.
* Yes.
* On the Skins tab, reduce the incoming heals opacity.

5: Can I hide all the bars and only show those needing a debuff removed.
* Yes.
* On the Healing tab, set the Alert Level to 0.
* On the Skins tab, set the Disabled opacity to 0, then click on the bar Disabled and set the Disabled text opacity to 0 (far right slider in colour picker), then same for the Background and Border.

6: Can HealBot be sorted by groups, for example have 2 Groups per column.
* From 2.0, yes.
* On the Skins tab, switch on Show Headers and then set the Number of Headers(Groups) per column.

7: I have a slow PC, are there any options I should set?
* Yes, the following options will have HealBot running lite.
* On the General tab: turn off Close Automatically.
* On the Healing tab: turn off Targets, set Alert Level to 75% or lower.
* On the Healing tab: set Range Check Frequency to 0.4sec or higher.
* On the Healing tab: Show extra bars for specific classes your responsible for healing.
* On the Buffs tab: turn off also in combat
* Turn off the Aggro Monitor
* Turn off Fluid Bars

8: I can't see when people are out of range, how do I fix this?
* On the skins tab, reduce the disabled bar opacity, to reduce the text opacity click on the bar labeled Disabled.


==============================================================================
Quick Guide:
==============================================================================

=== Pre defined combos ===
Ctrl+Alt+Left: This Enables or Disables (default) the bar, use this if you always want focus on certain targets.
Ctrl+Alt+Middle: This adds the name on the bar to the BlackList, a use for this might be to BlackList imps. Note to clear the blacklist: ResetHB or ReloadUI or type /hb cb 

=== General tab ===
Disable HealBot: Disabled all events and hides the bars
Show Minimap Button: Show button on minimap, hold right mouse button to move
Lock position: Locks the frame
Anchor: Set the anchor point, Healbot will then grow away from the anchor
Close automatically: Closes the frame when no one needs a buff added/debuff removed/heal and only when out of combat
Play sound on open: Plays a sound when the frame is opened.
Hide options button: Hides the options button on the frame.
Right click on panel opens options: Right click on edges will open the options.
Hide Party Frames: Hide the standard party frames - Including Player optional
Monitor Aggro: Track everyone with aggro allowing you to be a proactive healer, bar will enable for all in range with aggro
Use Fluid Bars: Update the bars in a fluid motion - Only use this option if the update is fast and smooth.
Chat Options: send a message when casting.

=== Spells tab ===
Set spells for: select Enabled bars at all times (which includes at all times in combat) or Disabled bars when out of combat.
Button: select the button for binding a spell to that button.
Click/Shift/Ctrl/Alt: Enter the spell in here to bind. Note: any item can also be entered, also Target/Assist/Focus can be entered.
Use Enabled Settings when Target in Combat: If your out of combat and the target is in combat, the enabled (combat) setting is used
Always use Enabled Settings: Always use Enabled (Combat) Settings
Avoid accidental PVP flagging: Keep bars disabled if the target is PVP flagged and your not
SmartCast: Use this to automatically select a spell when out of combat, this binds to the left click. The types of spells can also be enabled/disabled, for example Druids might want to turn off res.

=== Healing tab ===
Self: Show a bar for yourself
Group: Show bars for your group.
Tanks: Show bars for the tanks
Target: Show bars for members you target, note up to 10 raid members can be checked.
Extra: Show bars for any raid members not selected from the above, extras can be filtered on this tab.
Pets: Show bars for any pets in your party/raid
Alter level: Highlight the bars and text when a members health drops below this level.
Range Check Frequency: How often range checking is performed on enabled bars - if Monitor Aggro is enabled, this will alternate with a Range Check at this frequency.
Sorting and Filtering: this is for extra bars.
Configure classes for: Set classes for class types Melee/Ranged/Healers/Custom. Note these types can be used with filtering extra bars, monitoring debuffs and buffs.

=== Cure tab ===
Monitor to remove debuffs and in combat: set these options to monitor.
Spell to debuff: set the spell you would use, ie. Remove Curse would monitor for Curse. Note. these are the spells SmartCast will use, to use a spell in combat you must set it on the spells tab, by default Alt+Left and Alt+Right will have a spell set.
Ignore Debuff: Options to ignore debuffs not normally decused, see below.
Health bar colours: Change the members bar to this colour when affected by a debuff. The colour can be changed by clicking on the bar.
Debuff Warnings: options for giving warnings when a members has been affected by a debuff.

Ignore Debuffs options:
- Irrelevant by class: Debuffs should as mana effect on warriors/rogues.
- Non harmful effect: Debuffs which do no harm, such as Hunter's mark.
- Short duration: Debuffs which only last for a few seconds.
- Slow movement effect: Debuffs which only effect movement speed.

=== Skins tab ===
Lots of options here, best to simply play around with them.
Things to note are:
If you find an appearance you like, give it a name and save the skin.
Set the number of columns to 0, this sorts bars by headers.
Everything on this tab does something, click on the bars for colour options.

=== Tips tab ===
Show Tooltips: shows a tooltip with usable spell/item
Show target information: shows information about the target, name/class/health and if needing a buff or affected by a debuff.
Show detailed spell information: show details for spells including bonuses.
Show instant cast recommendation: shows if the target would benefit from spells such as shield and HoT's
Position tooltip: set where the tooltip is displayed
Bar Information options: show information on the bar such as class/health as a delta or %/set text to class colour.
Show HoT icons: Allows you to track your own Hots

=== Buff tab ===
Monitor for buffs and in combat: set to monitor for buffs, recommend not setting in combat.
Spell to buff: set the spell to monitor for, note in cases like MotW and GotW only MotW is an option but both buffs are treated the same. note SmartCast will use the buff set, if for example a Paladin wanted to use a greater blessing then set it on the spells tab.
Check Members: set to monitor members in your group or the raid (includes group) or a certain class or just yourself.
Bar Colours: click on the bar to set the colour you want when members of your party/raid are in need of a buff, their bar colour will change to the setting on the buff tab.

=== Defaults ===
Click this to set defaults, note any extra saved skins will be lost.


==============================================================================
Macro Examples   (Please share your macros - pm me on Cursed)
==============================================================================

Druid
-----

These examples make maximum use of trinkets (slots 13 and 14)

Example #1: Healing Touch

/script UIErrorsFrame:Hide()
/console Sound_EnableSFX 0
/use 13
/use 14
/console Sound_EnableSFX 1
/script UIErrorsFrame:Clear(); UIErrorsFrame:Show()
/cast [target=hbtarget] Healing Touch;


Example #2: Regrowth

/script UIErrorsFrame:Hide()
/console Sound_EnableSFX 0
/use 13
/use 14
/console Sound_EnableSFX 1
/script UIErrorsFrame:Clear(); UIErrorsFrame:Show()
/cast [target=hbtarget] Regrowth;


Example #3: Lifebloom

/script UIErrorsFrame:Hide()
/console Sound_EnableSFX 0
/use 13
/use 14
/console Sound_EnableSFX 1
/script UIErrorsFrame:Clear(); UIErrorsFrame:Show()
/cast [target=hbtarget] Lifebloom;


Example #4: Rejuvenation

/script UIErrorsFrame:Hide()
/console Sound_EnableSFX 0
/use 13
/use 14
/console Sound_EnableSFX 1
/script UIErrorsFrame:Clear(); UIErrorsFrame:Show()
/cast [target=hbtarget] Rejuvenation;


Shaman
------

Example #1: Chain Heal

#showtooltip Chain Heal
/stopcasting
/cast [target=mouseover,help] Chain Heal
/equip Totem of Healing Rains


Example #2: Healing Wave

#showtooltip Healing Wave
/stopcasting
/cast [target=mouseover,help] Healing Wave
/equip Totem of Spontaneous Regrowth


Example #3: Healing Wave(Rank 1)

#showtooltip Healing Wave(Rank 1)
/stopcasting
/cast [target=mouseover,help] Healing Wave(Rank 1)
/equip Totem of Spontaneous Regrowth


Example #4: Lesser Healing Wave

#showtooltip Lesser Healing Wave
/stopcasting
/cast [target=mouseover,help] Lesser Healing Wave
/equip Totem of the Plains


Priest
------

Example #1: Greater Heal.

#show Greater Heal
/script UIErrorsFrame:Hide()
/cast Inner Focus
/stopcasting
/cast [target=hbtarget] Greater Heal
/script UIErrorsFrame:Clear(); UIErrorsFrame:Show()


Example #2: Power Infusion

#show Power Infusion
/script UIErrorsFrame:Hide()
/console Sound_EnableSFX 0
/use >>>A TRINKET TO SAVE MANA<<<
/console Sound_EnableSFX 1
/stopcasting
/cast [target=hbtarget] Power Infusion
/stopcasting
/cast [target=hbtarget] Power Word: Shield
/script UIErrorsFrame:Clear(); UIErrorsFrame:Show()


Example #3: Pain Suppression

#show Pain Suppression
/script UIErrorsFrame:Hide()
/console Sound_EnableSFX 0
/use >>>A TRINKET TO SAVE MANA<<<
/console Sound_EnableSFX 1
/stopcasting
/cast [target=hbtarget] Pain Suppression
/script UIErrorsFrame:Clear(); UIErrorsFrame:Show()


Example #4: Power Word: Shield

#show Power Word: Shield
/script UIErrorsFrame:Hide()
/console Sound_EnableSFX 0
/use >>>A TRINKET TO SAVE MANA<<<
/console Sound_EnableSFX 1
/stopcasting
/cast [target=hbtarget] Power Word: Shield
/script UIErrorsFrame:Clear(); UIErrorsFrame:Show()


==============================================================================


Change log:

v2.3.2.0
=================
* Added Shaman macro examples to the readme file
* Minor change to DE localizations


v2.3.0.8
=================
* Fixed major bug when macros used with smartcast and/or different spells for disabled/enabled bars
* Added Druid macro examples to this file


v2.3.0.7
=================
* Minor update to incoming comms
* Minor update to handling of macros
* Updated tooltips to include macros
* Stopped a few events from running when healbot is disabled


v2.3.0.6
=================
* Updated macros, in the rare case of a macro having a spell name, the spell takes priority


v2.3.0.5
=================
* Added macros, simply create a normal WoW macro and put the macro name in the key/click combo


v2.3.0.4
=================
* Updated Spanish localizations
* Pre defined combo Ctrl+Alt+Any (enable/disable) has been changed to Ctrl+Alt+Left
* New pre defined combo Ctrl+Alt+Middle added to allow BlackListing by name.


v2.3.0.3
=================
* Fix for taint when player dies in combat with auto close switched on


v2.3.0.2
=================
* Improved visibility of names when dead.
* SmartCast is now off by default 
	

v2.3.0.1
=================
* Possible fix for German inc heals


v2.3.0.0
=================
* Change to version numbers to sync with WoW
* Fix for German client localization
* Update toc


v3.0
=================
* Major change to unit tracking on bars to enable updates during combat
* Defaults and  /hb show  should now move HB to the center of the screen
* Added reset and info buttons for commands  /hb ui  /hb ri  /hb info
* Improved performance of SmartCast
* Healbot still syncs heals when disabled, added for friends of Healbot uses who are healers and non Healbot users.
* Improved opening options
* Bug Fixes


v2.5
=================
* Bug fixes for targets
* Added Paladin aura's and Hunter aspects
* bar for pets only shown if the pets owner has a bar 
* Added Alt+Ctrl+AnyButton to toggle state of each bar (enabled/disabled)


v2.47
=================
* Fixed nil bug that rarely happens when another healbot user DC's while casting an incoming heal
* Complete change to aggro monitor, nice performance improvement


v2.46
=================
* Fixed Troll Shadowguard racial talent in en client
* Fixed bug to correctly update buffs/debuffs when setting Self/Party/Raid/Class for the same spell
* Fix for /hb show


v2.45
=================
* /hb show : now unchecks Auto Close, then reset HB to the default location and shows the healing panel
* Fixed nil bug that rarely happens on logon while in a raid
* Improvements to incoming heal amount and tooltip info
* Fixed text colour when in/out of range, inc rez.


v2.44
=================
* Bug fixes to 2.4 including Paladin Cleanse out of range bug


v2.43
=================
* Bug fixes to 2.4
* Replaced /hb ver with /hb info


v2.42
=================
* Bug fixes to 2.4


v2.41
=================
* Bug fixes to 2.4


v2.4
=================
* Major performance increase when players join/leave the raid
* Major performance increase to bar updates and range checking
* Default range checking time dropped from 0.8 to 0.2
* Added Aggro Monitor
* Added Fluid Bars
* Replaced Always Enabled with Always use Enabled Settings
* Removed slider Max. Minor wounded members per range check


v2.3
=================
* Performance increases to bar updates


v2.21
=================
* Fixed targetting bug


v2.2
=================
* Updated for WoW 2.1
* Added some buffs


v2.1
=================
* Added options to move HoT icons
* Added rez only option for chat notify


V2.0
=================
* Major changes for The Burning Crusade
* Added buff monitor
* Added SmartCast to cast an appropriate spell when out of combat
* Added skin options for headers
* Removed Shift+Ctrl+Click from enabled spells
* Removed Abort button
* Range is now 100% accurate in and out of instances.
* Significant performance increase
* Additional options and bug fixes


v1.1262
=================
* Setting columns to 0 sorts columns by headers
* When casting, enabled bars remain enabled with only the text disabled.
* All localization bugs should now be fixed.
* A number of performance tweaks
* Added target to enabled bars, now possible to target while in combat.


v1.1261
=================
* Fixed dispell debuffs while targeting hostile unit
* Fixed incoming heals indicator while targeting unit being healed
* Changes to res monitor and incoming heal reporting, preparing for BC.


v1.126
=================
* Added new options to target and cast on disabled bars.
* Added res indicators.
* Added more options to tooltips and information on the bars.
* Updated tooltips included tips for disabled bars.
* Updated all localizations.
* Registered Healbot with TitanPanel under category Interface.
* Extra bars can be filtered by group.
* Improved performance
* Compatible with CTRA, CTRA is no longer required to obtain tanks.
* Some minor options and changes.


v1.1256
=================
* More updated French localizations.
* Added a few beneficial spells to defaults.
* Change to tooltips to avoid interference.


v1.1255
=================
* Updated French localizations.


v1.1254
=================
* Updated text on bars to scale with bar size and font size.
* Added Alteric Valley skin to defaults.
* Added option to show headers above the bars.
* Fixed a few bugs
* Updated Korean localizations.


v1.1253
=================
* Fix for debuffs.
* Fix for skins with options fontsize, abortsize, abort colour and disabled bar opacity
* Updated opacity code for bars and text.
* Added German localizations
* Fixed startup errors for none healers.


v1.1252
=================
* Changed range checking for debuffs, bars will now change colour but no warnings issued. (if known to be out of range)
* Fix to catch charmed raid members.
* Fixed font scaling bug
* Cleaned up tooltips
* Fixed the window popup bug when player dies in combat


v1.1251
=================
* Fixed checked box issues
* Fixed out of combat when leaving a zone while in combat. 
* Added latest Korean localizations


v1.125
=================
* Added skin options to change and save the appearance of Healbot.
* Added decursive options compliant with BC.
* Added tooltip options and only refreshing when required.
* Fixed German localization issues. Big thank you to Corillian on cursed.
* Cleaned up error reporting, mainly for localizations.
* Updated Unit bars ready for BC.
* Significant performance increase


Change log:
v1.1242
=================
* Minor changes for performance.


Change log:
v1.1241
=================
* Updated Korean localizations


v1.124
=================
* Removed Hunter class from using HealBot.
* Added Middle and Right mouse buttons to combo keys.
NOTE: I recommend removing HealBot.lua and HealBot.lua.bak (if it exists) from your SavedVariables directory.
It can be found in: <World of Warcraft>\WTF\Account\<Account Name>\SavedVariables
This will remove some old config data no longer used but it will also reset the options to defaults.


v1.1232
=================
* Fixed spam issue with non healing classes.
-- Thanks to hitekredneck13 on cursed for reporting this bug.


v1.1231
=================
* Any spell can be used with combo keys
-- Thanks to Jerenn and solorider on cursed for reporting this bug.


v1.123
=================
* Communication between healers using healbot to show incoming heals
* Number of checked targets back to 5 without original bug
* Added to CT_MOD Control Panel and fixed integration with CTRA. 
* Split localizations into separate files.
* Delayed initialize spell data when talents.
-- Thanks to Abbevillian of PG (CUK) for reporting this bug.
* HBmsg is now the debug channel.
* Improved performance, removed talent lookups, redundant code and hardcoded spell data
* Fixed tooltips for old style buttons and fixed abort button bug with old style buttons.
-- Thanks to spenster on cursed for reporting this bugs.
* Loading spell data by scanning spellbook.
* Changed appearance of abort button to make it more visible.
* Added opacity setting for HealBot bars and opacity setting for incoming heal indicators
* Updated range checking function
* Cleaned up HealBot_config
--
NOTE: I recommend removing HealBot.lua and HealBot.lua.bak (if it exists) from your SavedVariables directory.
It can be found in: <World of Warcraft>\WTF\Account\<Account Name>\SavedVariables
This will remove a lot of old config data no longer used but it will also reset the options to defaults.


v1.122
=================
* Changed the Buttons to Bars. NOTE: to switch between buttons and bars, run switch.bat in the Healbot directory.
* Added zone change event to reset scale for range checking.
* Cache data and reduced amount of code for tooltip, to much code was being scanned for this.
* Updated talent and equipment bonus lookups to only lookup when needed.
* Removed dependency on BonusScanner and added a cut version to only scan for heal bonus when needed.
* Fixed tooltip bug for spells not checked on use tab but included in combo keys
* Fixed Priest Spirit bonus mod which was ~+1 out
* Fixed ComboKey spell usage to use highest spell unless rank is included
-- Thanks to Astranius on cursed for reporting this bug.
* Added Priest's Improved Power Word Shield to talent modifiers
* Removed all moving checks, it is not accurate and causes bugs


v1.121
=================
* Removed MT's from MT buttons when MT is in players party and players group buttons shown.
* Removed emergency buttons when the target is in the players party and players group buttons shown.
* Merged Option tabs Chat and Keys into Misc
* Added new Options tab Emerg
* Added filter to emergency buttons to only display for a type of Class(es) as setup in emergency options.
* Added option range check to hide emergency buttons for targets out of range.
* Overlapping Options and Abort button bug fixed.
-- Thanks to Thoril on cursed for reporting this bug
* Bug fix for Shaman not being able to cast a new rank10 spell and for any new future healing spells. 
-- Thanks to Kaplar on curse for reporting this bug


v1.12 (Note: this version resets the options to defaults)
=================
* Added PvP and PvE profiles and allow for different settings in each profile.
* Added an abort button which will display if your current spell is going to heal the target for more than the Overheal percentage * 4 as set in the options using the Overheal Alert slider.
* Changes to the options for overheals and added an Overheal Alert slider.
* Updated background not to change colour when player stops casting.
* Removed some redundant code
* Spell preference values raised, the preferences are weighted against the targets DPS and time to live, if the target is about to die and the preference is for faster casts then healbot will perform 
a faster cast. If your target has 0 DPS and more than ~20 secs to live then the preferences are only slightly considered.
* Reduced score of HoT's when the target is about to die.
* Updated the code for healthstones and healthpots. 


v1.11
=================
* Fix a bug introduced in V1.1 where range checks cause a nul error to spam in BG's.


v1.1
=================
* Update spell selection to only choose instant cast spell when the player is moving.
* Improved range checks to check the range for each spell, some channel spells only have a 20yards range.


v1.01
=================
* Fix more bugs with talent modifiers applied to mana cost and cast time. Healbot is now performing as expected.


v1.0
=================
* Fixed all data for spells with current patch 1.12 data.


v1.0 rc2
=================
* 40yard range check does not work in instances. Outside in normal zones the 40yards check still works. Inside instances there is a choice of 28yards or 100 yards, to set at 28yards check the option Exact 28yard range check, for 100yards uncheck it.
* Brought back cast time modifier with reduced penalty to scale depending on users preference as set in the options.
* Moved most register events to fire after addon loads, this is for faster loading and zone in.


v1.0rc1
=================
* Added Ranged checking function and tied into existing can cast checks, currently set to 40yards for all.


v0.998
=================
* Fixed bug where if you have 5 extra people checked and then select a 6th, it errors with a null value to index local check.
Note: you can now only check 4 people.
* From this release I will start to maintain a change log. Can still remember major changes in .996 and .997 but the 10 version before .996 are now a blur, it was mostly testing and tuning heals with some other bug fixes.


v0.997
=================
* Healbot is now performing better, put back the item bonus and talent modifiers, these were reduced due to the lesser heals bugs.
* Reduced price of HealthStones, healbot should use these when you mana is starting to drop and health low, needs more tuning and feedback welcome.


v0.996
=================
* Removed cast time from calculating best spell, with the introduction of item bonuses and talents, the +heals made spells with higher cast times score badly which resulted in them not being used.
* Removed a number of function calls when not needed, significantly reduced the amount of code being consistently parsed, this means healbot is now far more efficient.
* Removed the flashing red background, although this is a good way to indicate that the heal will overheal and it is best to abort, it annoys me and I can't be bothered to abort half the time anyway.


v0.95 - v0.995
=================
* Generally debugging and tuning with the introduction of item bonuses and talents being applied to amount healed.
* Updated duration and amount healed for priests greater heal spells, this change in patch 1.10 was not updated in healbot.
* Increased price of HealthPots and HealthStones, to reduce usage of these items.


v0.94
=================
* Picked up healbot with some changes from the original, which fixes a serious bug where the game freezes after a DC but added bugs where small spells are being selected.
* Making some changes to the code and testing.