This Addon makes it easier and more fun to use the various "ball" items in
World of Warcraft. To start playing, you'll need to have a ball in your
inventory. Currently supported/known balls include:
- Heavy Leather Ball
http://wow.allakhazam.com/item.html?witem=18662
- Happy Fun Rock
http://wow.allakhazam.com/item.html?witem=18640
- Snowball
http://wow.allakhazam.com/item.html?witem=17202

(The snowball and rock haven't actually been tested yet because I haven't
been able to get my hands on either of them. If anyone on Windrunner
wants to send me one of either, I'd be most appreciative.)

Then, you have a variety of methods to actually throw it. You can:
- Bind a key to the throw type in key bindings
- Use the slash command, /bf throw, with a throw type argument
- Create a macro with the slash command and drag it to an action button.

There's also the concept of a throwing "mode". You can set the default
throwing mode with the slash command, /bf mode. Once a default mode has
been set, you can use the slash command, /bf throw, without any arguments
to throw the ball using that mode. You can also set a key binding to throw
using the default mode.

By default, all throwing methods will find and throw the first supported
ball type found. You can limit the ball type being used with the slash
command, /bf use.


---------------------------------------------------------------------------
Features

* Throw the ball to your current target
* Throw the ball to a random person in your group.
* Throw the ball to a random person in your guild.
* Throw the ball to a random person in your raid.
* Set or Get the default throwing mode
* Throw the ball using the default throwing mode
* Set or Get the ball type to use


---------------------------------------------------------------------------
Known Issues

* There's currently only minimal code to check for and/or deal with
situations where the chosen target isn't valid due to distance,
line-of-sight, death, lack of bag space, etc.
* The first attempt to throw to a random guild member may fail because
of a race condition in updating the guild info cache on the client.
* When throwing to random guild member, if you're currently attacking an
enemy, an attempt will be made to re-target the enemy after the
ball is thrown but melee attack will have been turned off due to the
target switch.


---------------------------------------------------------------------------
Future Plans (not necessarily in order of priority)

* Build a "team" and throw randomly to them.
* Usability checking? Distance, LoS, etc.
* Hot Potato game with other BallFun users
* Random ball-specific emotes/chat
(e.g. /em winds up and chucks the ball to Soandso)
* Localization
* React to catching a ball

There is no dependency information for this file.

* Updated for 1.8 Patch. My apologies that there was no update for 1.7, but
the only thing that technically would've changed was the toc number.
* Removed load spam.