------------------------------------------------------
Fizzwidget Hunter's Helper
by Gazmik Fizzwidget
http://fizzwidget.com/huntershelper
gazmik@fizzwidget.com
------------------------------------------------------

Really, I'm not one to gallivant about the wilderness trying to make friends with beasts... at my size, it's a good way to get eaten! Besides, keeping a full stock of bits & bibbles for your critter can be terrible for your cash flow. But a Hunter friend of mine managed to convince me there'd be good money in outfitting such outdoorsy types, and before I knew it my workbench was cluttered with all sorts of animal-seeking, food-measuring, and pet-minding contraptions.

This gadget couldn't be any simpler to use: point it at a beast you see in the wild, and its zootropic neurowave scanner will analyze the critter's noggin and tell you what, if any, new tricks it can teach you.* Know what you're looking for, but not sure where to look? It'll help with that, too -- I've pre-programmed it with an extensive database on creature behavior (straight from the Encyclopedia Azerothica), easily indexed by skill.

* Not recommended for use by elderly gnolls.

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

INSTALLATION: Put this folder into your World Of Warcraft/Interface/AddOns folder and launch WoW.

USAGE: 
	- When you mouse over a beast in the world, the tooltip will show which abilities a Hunter could learn after taming it. (Or no additional info if the beast doesn't have any known abilities.)
	- If you're currently playing a hunter, the abilities will be colored according to whether you've already learned them: green for abilities you have yet to learn, and gray for those you already know. Hunter's Helper will notice when you learn new abilities and will automatically refresh its index whenever you open the Beast Training window. (If you already know a few abilities, you should open you Beast Training window the first time you play after installing Hunter's Helper.)
	- Need to know where to find new abilities for your pet? Type (for example) '/huntershelper find Bite 6' to get a list of beasts known to have that ability. Results are sorted by zone, with those areas closest to (or most accessible from) your current location first. (The list cuts off after four zones if you look for an ability found on a wide variety of beast types; typing `findall` instead of `find` will list everything applicable.)
	- Hunter's Helper also notifies you in chat if you tame a beast whose skillset isn't what was expected. Please contact me so I can update Hunter's Helper with corrected information! 

CHAT COMMANDS:
	/huntershelper (or /hh) <command>
where <command> can be any of the following:
	help - Print this list.
	status - Check current settings.
	on|off|onlyhunter - enable/disable display of pet abilities in beast tooltips. (Or enable only for Hunter characters.)
	find <ability> <rank> - Lists in the chat window which beasts have an ability and where they can be found. 

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

v. 1800.4 - 2005/11/06
- Includes a French localization by Corwin Whitehorn. (Still, only the names of abilities, beast families, and other basic information is currently localized. In order to localize the entire built-in beast ability database, I'll need mappings of English beast names to their localized equivalents. Users of WoW in other languages can help by emailing their SavedVariables/GFW_HuntersHelper.lua file once they've tamed or cast Beast Lore on a handful of critters.)
- Made some additions and corrections to beast ability tables.
- Includes refinements to code shared with other GFW mods.

v. 1800.3 - 2005/11/06
- You know, I'm pretty sure that back when I started on Hunter's Helper, you couldn't find out about a beast's tamed abilities using Beast Lore... but I recently noticed that you can now. So, some related improvements:
	- If you use Beast Lore on a beast which has tamed abilities, you won't see those abilities listed twice in the tooltip (once by Beast Lore and once by Hunter's Helper).
	- We parse the Beast Lore-enhanced tooltip, and can thus learn for future reference (in tooltips and `/hh find`) which skills a beast has without needing to tame it.
	- The text we add to tooltips matches the text you see when using Beast Lore (with an accordingly localized label).
	- We recolor the tooltip's "Tamed Abilities:" line when it's added by Beast Lore to show which abilities you already know and which you haven't learned yet.
- First steps towards localized releases:
	- If we don't recognize the name of the zone you're in when you use `/hh find`, we'll fall back to one of several default zones (chosen based on your race or faction if we can parse them) so that the search can proceed, instead of failing to search at all.
	- Our built-in tables are now indexed by locale-independent spell identifiers wherever possible, and we automatically reindex dynamically discovered info to match whenever we can. What does this mean? If you're running a non-English localization of WoW, Hunter's Helper might not show much in the tooltips or `/hh find` results at first... but once you've opened your Beast Training window and/or tamed a few mobs (enough for us to match English spell names to localized names), we'll be able to provide additional search results. Since we can't automatically map localized zone and mob names to their English equivalents, the additional results may be in English.
	- There's now a localization.lua file with keys for known pet ability names and beast families. Users of other WoW languages are welcome to edit this file to provide the localized equivalents of these names -- send back your edits and I'll include them in future releases. (The more Hunter's Helper knows about localized names, the better it can access its built-in database when running under other WoW languages.) 
	- Our built-in database of zone names is now (mostly) localized into French, German, and Korean, thanks to contributors who helped localize Fizzwidget AdSpace and the listings at WoWGuru.com.
- If we see new beast ability info that isn't in our static tables (which can now happen when mousing over a beast that has the Beast Lore "debuff", in addition to upon taming a beast), the message requesting that you email me about it will appear no more than once per minute.
- In the past, we could sometimes run into situations where we wouldn't notice we'd successfully tamed a beast with new skills, and then end up associating some other pet's skills with it later. Added some checks to prevent such situations.
- Added, updated, and corrected several database entries thanks to user contributions. (Notably, all three species of Wind Serpent in the Sunken Temple have Lightning Breath 5.)

See http://www.fizzwidget.com/huntershelper for older release notes.
