------------------------------------------------------
Fizzwidget Disenchant Predictor
by Gazmik Fizzwidget
http://fizzwidget.com/disenchantpredictor
gazmik@fizzwidget.com
------------------------------------------------------

Enchanters: have you ever tried to accumulate reagents for your latest formula and come away feeling... well, disenchanted? Got Strange Dust when you really wanted Soul? Is that Brilliant Shard just not large enough to satisfy? Suffer no more! Through countless hours of research, I've discovered the scientific laws governing the mystic composition of enchanted items. I just *had* to build a gadget to make use of this knowledge.

My latest invention will help you make sure you always disenchant the right stuff to get the shards, dusts, or essences you need.  Simply point it at any such reagent -- or even the reagent requirements listed in your formula book -- and you'll see an instant readout showing what types of items it can be disenchanted from. No more guesswork!*

* Due to fluctuations in the astral plane, disenchanting an item of merely "uncommon" quality will still produce variable results. No one can predict for certain whether you'll get a pile of dust, an essence, or a shard, but thanks to my invention you'll at least know what variety of dust, kind and potency of essence, or luster and size of shard can be produced. 

------------------------------------------------------

INSTALLATION: Put the GFW_DisenchantPredictor and EnhTooltip folders into your World Of Warcraft/Interface/AddOns folder and launch WoW.

USAGE: 
	- By default, reagents produced by disenchanting items (a dust, essence, or shard) will show two new lines of information in their tooltips: the first shows which levels of items can be disenchanted to produce the reagent, and the second provides additional info on which types of items are more or less likely to produce the reagent.
	- Disenchantable items will also show information in their tooltip predicting which types of dust, essence, or shard they can disenchant into.
	- Also, you can use a chat command to check which types of dust, essence, and shard can be disenchanted from an item by inserting a chat link or typing its level requirement (see below). 

CHAT COMMANDS:
	/enchant (or /ench or /disenchant or /dis or /de or /dp) <command>
where <command> can be any of the following:
	help - Print this list.
	status - Check current settings.
	items on | off - add info to tooltips for disenchantable items (e.g. green weapons) showing what they can disenchant into.
	reagents on | off - add info to tooltips for enchanting reagents (e.g. Strange Dust) showing what they can disenchant from.
	verbose on | off - add a second line in the tooltip showing detailed disenchant info.
	tooltip on | off - enable/disable or disable this addon's tooltip modification entirely.
	<number> - Show disenchant info for level <number> in the chat window.

CAVEATS, KNOWN BUGS, ETC.: 
	- Not all disenchantable items have a level requirement -- quest rewards notably don't. It seems WoW's formula for determining disenchant results uses the level at which the quest first becomes available. For example, [Masons Fraternity Ring] disenchants into a Large Radiant Shard (which usually comes from level 41-45 items), even though "Divino-matic Rod" is listed as a level 47 quest. (Unfortunately, this information can't be readily indexed by an addon.)

------------------------------------------------------
VERSION HISTORY

v. 10900.2 - 2006/01/11
- Corrected info on [Nexus Crystal] disenchants; crystals always DE from level 51+ epics and have a small chance to DE from level 51+ Rares. (Epic items of level 50 and below still DE into shards appropriate to their level, though they tend to produce a greater quantity of shards per DE than a Rare.)

v. 10900.1 - 2006/01/03
- Updated for WoW patch 1.9 and its new disenchant reagent ([Nexus Crystal], which can disenchant from items of Epic quality).
- Now correctly recognizes more types of items that can't be disenchanted: items of Legendary or better quality and items with a duration.
- Fixed an error that could appear when automatic disenchant looting was turned on (which tended to appear if the client was lagged while looting).
- Fixed some cases where we could end up trying to make the WoW client display an illegal link (which disconnects you from the server).
- Includes refinements to code shared with other GFW mods.
- Knows its own version number -- it's present in startup and error messages and if you type `/dp help` or `/dp version`. Please include this version number when sending bug reports or help requests!

v. 1800.4 - 2005/10/21
- Fixed an error message that could appear when showing tooltips or using `/dp [item link]` if the WoW client hadn't cached enough info from the server yet.

v. 1800.3 - 2005/10/17
- The locale independence introduced in 1800.1 broke the checks that kept us from reporting recipes as disenchantable based on the stats for the items they produce. Fixed.
- Fixed some other cases of non-disenchantable items showing disenchant info. (The hidden tooltip we use to gather item info wasn't getting fully cleared between uses, so looking at a non-disenchantable item after looking at a disenchantable item was throwing us off.)

v. 1800.2 - 2005/10/12
- Updated our built-in tooltip hooking utility (GFWTooltip) to properly handle the new dynamic-load Auction UI; Disenchant Predictor tooltips should show in the Auction House again.

v. 1800.1 - 2005/10/11
- Updated for WoW patch 1.8.
- Now locale-independent! That is, it should be functional in all WoW languages, though the interface text isn't translated for all of them.
- Includes German localization by "the r@zor-blade". (Other translators are welcome to edit localization.lua and email it to gazmik@fizzwidget.com for inclusion in future releases.)
- Typing `/dp <item link>` now returns information for where to get enchanting reagents (the way the tooltip can) in addition to listing what reagents can come from disenchantable items.
- General improvements to utility code shared with other Fizzwidget addons (GFWUtils, GFWTable, and GFWTooltip).

v. 1700.5 - 2005/09/28
- Fixed some more errors in our built-in tooltip hooking utility.

v. 1700.4 - 2005/09/26
- Fixed some errors in our new tooltip hooking functions that appeared when looting or selling items at the AH.

v. 1700.3 - 2005/09/24
- EnhTooltip was becoming a pain to keep compatibility with, so now it's gone. (If you've still got EnhTooltip installed and aren't running any other mods that use it, such as Auctioneer or Enchantrix, feel free to delete it.) We now have our own (much simpler) built-in tooltip hooking code. (Mostly imported from GDI's Reagent Info, with a bit of guidance from EnhTooltip itself). This resolves the issues we were having if you upgraded to EnhTooltip 1.0.6 (or the Auctioneer 3.1 beta that includes it).
- Fixed an issue that prevented predictions for items from showing.
- Clearer info returned from `status` command.

v. 1700.2 - 2005/09/19 (Arrr!)
- Added options to independently enable / disable tooltip info for enchanting reagents or disenchantable items.
- Fixed a bug where tradeskill recipe scrolls would show as disenchantable.
- Updated included EnhTooltip with changes from its official 1.0.5 release.

v. 1700.1 - 2005/09/13
- Updated TOC for WoW patch 1.7.
- Can now directly predict disenchant results for most items (those with a level requirement). This info shows in the item's tooltip, or can be queried in the chat window with `/dp <item link>`. (In other words, Disenchant Predictor now behaves much like Enchantrix, just with a different basis for where its info comes from.) Items without a level requirement won't show tooltips, but will provide some information when queried in the chat window.
- Fixed an error that came up when getting a tooltip for items whose name is "<something> Dust" that aren't related to Enchanting.
- Patched included EnhTooltip to fix a bug where it was preventing access to the popup menu that appears when you right-click someone's name in chat.
- Cleaned up code shared with other Fizzwidget mods; should no longer produce cryptic error messages if you don't have the latest versions of everything (starting with version 1700.1 of all mods).

v. 1600.3 - 2005/08/27
- Patched included EnhTooltip with a fix (from Kaelten of Kael Cycle mods) for a bug involving the AH 'item to sell' slot.
- Code cleanup and standardization among Fizzwidget mods.
- Supports wowguru.com's UI updater utility (and potentially others).

v. 1600.2 - 2005/07/16
- Replaced LootLink dependency with bundled EnhTooltip (version 1.0.4).

v. 1600.1 - 2005/07/12
- Updated TOC for UI version 1600.

v. 1500.1 - 2005/07/07
- Initial release.
