-Intro-

If your like me you sometimes forget that you are running low on ammo, and head out of town, only to run out or realize and have to run back to town, sometimes a great distance.

Well I started looking around and found a low ammo counter, tho it only warned you when you were already out hunting (by arrow use).  I took that and modified it to remind you on other in game events.  It also triggers the wood shield unsheath sound as an audio reminder.

[Adventuring Low Arrow Count]  
- Ammo usage - This amount is configurable for the warning that displays you are starting to run low on arrows (while you are hunting).


[Town reminders]
- Zone Boundaries(indoors and outdoors) - Changing Any part of your zone, Entering some buildings, anytime your zone changes in your mini-map this should 	trigger. This should always trigger when you exit a town, reminding you if your arrow count is below a user specified number to buy arrows.

- Opening a Vendor -  Any time you are opening a vendor, this will trigger if your arrow count is below number specified

[Critical Warning] 
Regardless of which of the above events are triggered, if the ammount of ammo you have is less than this number, the Critical Warning will trigger



-Quirks-

One quirk that I beleive is client related, the zone changes sometimes doesn't trigger.  I think this is related to the event (in the client) and not the script, this is similar to other bugs with pets, mobs and mounts that I have seen or heard of.  This is predominant when crossing a bridge or 'landing' when entering a zone.


-Credit- 

the guy who wrote the original mod Kugnar has it posted at
http://www.bizarreconcepts.com/wow give him all the credit, he did all the work, I just modified what he had done.  Neither one of us take any responsibility if this breaks you, your game, or any bodily part is injured while using this mod.  I have tested this on a lvl 39 hunter and it works very well, It should work with any Ammo using character, but I have not tested it.  I beleive it does require either a quiver or an ammo bag to work.  

-COSMOS AND OTHER MOD USERS-

Cosmo and GTmod and Gypsy are UI interface programs,  I use cosmo so I will only speak of it.  Cosmos does modify the UI but only to the extent that it adds menus for modification of other mods.  Most of the functionality that COMOS brings is brought in by other mods, and Comos organizes them for you, this MOD is no different, however if you use Cosmo's (and possibly others) there is a function of Cosmos that will delete ANY MOD that is not part of Cosmos.  I think this feature is turned on by defualt so you have 2 options here:

	1.  Remove the checkbox from "Keep Interface Directory Clean [deletes unused files] 
	2.  Back up any additional mods you have added to your interface directory that arent cosmos (everytime you run it).  

**Cosmos now has functionality to prevent the cleaning of unwanted directories see the cosmos docs
The first option is the most viable and easy to use one, however, on occasion you want to clean up your interface directory, perform option 2 and then turn that checkbox back on, just remember to turn it off again when you have cleaned the interface directory up.  Then restore your backed up files.


This addon will show up in the cosmos menu if it is installed.  Look for Ammo Warning, all of the configuration options are listed there.  If you don't have cosmo, you can run this addon as well

If you don't use comso, this addon should still work, you will just have to use the slash commands to configure it, type /ammo for help.

-Setup-

If you are using Winzip or a similar program, just expand this zip file to your <DRIVELETTER>:\World of Warcraft\Interface\AddOns  (DRIVELETTER is the drive you installed World of Warcraft on).  Make sure you have the 'USE PATHS' option turned on when you extract (should be on by defualt). Once you have done this you should have a directory called: <DRIVELETTER>:\World of Warcraft\Interface\AddOns\AmmoWarning\  if that directory exists, fire up WOW and follow the steps below.


In the character addons button this mod will be listed as 'Ammo Warning' and should be turned on by defualt (the next patch will probably disable this, but instructions are to change the TOC file to reflect the current build number (same thing you have to do with Cosmo to get it to work until they patch it).




Thats all there is (I think) please feel free to contact me in game for help.  



-Possible Additions- (to be added as I gain more experience with the LUA functions)
-- Revisions
--	1/8/2005	-This is done, this program now integrates with the cosmo menu and is listed as Ammo Warning
-- 	1/27/2005	-Added Thrown Weapon Support (man what a pain). 
--			-Rewrote the CheckForAmmo and CountAmmo functions.
-- 	1/29/2005	-Localization support added
-- 			-Changed Print and banner functions to use the Sea.IO function library
-- 			-Added some functionality to identify and display ranged weapons and ammo type on the /ammo help screen
--	1/30/2005	-Separated SLash commands from COSMOS Menu Functions 
--			-Cleaned up some functions and isolated the loading of variables from SavedVariables.LUA
--			-Added an /ammoauto function Auto determines the ammount of possible ammo for setting the warnings to appropriate values
--			 this function uses the TotalThrown as its base, or an argument (/ammoauto /ammoauto 2000)





-	Kalimoor
	Guild: Relic
	Server: Whisperwind
