Ammo-matique
Ammo-matique provides automated ammo handling. It can automatically select the suitable ammo type in any particular situation. Additionally, it can alert you when you're running low or out of ammo, in a variety of ways including voice feedback.
The WoW 3.3 upgrade removed the ability for add-ons to switch weapons and ammo automatically when in combat. Because of this, Ammo-matique is no longer able to auto-switch ammo while in combat. It still attempts to switch ammo while out of combat and it can provide a warning if the ammo should be changed but you're in combat, and prompt you to do it manually.
Currently supported features
- Automatic discovery and ranking of ammo. The best ammo is referred to as the "premium", and the worst the "low-grade".
- Automatic out-of-combat switching of ammo type (premium vs low-grade) depending on mob type and location, or PvP situation.
- Warns if you are using the wrong ammo type and Ammo-matique is unable to swap it automatically (i.e. in-combat).
- Warnings when the current ammo drops below a configured threshold, runs out, and when all ammo runs out.
- Warning in the default chat window.
- Warning in the standard error frame.
- Warning by voice over (male and female voice sets available).
- Automatic ammo restocking. This add-on can automatically buy ammo from vendors and keep you topped up to a configurable level.
- Ammo bag designation. Keep all your ammo in the bag you specify, even when it's not a quiver/ammo pouch.
- Integration with any LibDataBroker (LDB) display add-on, such as TitanPanel and ChocolateBar.
- All features configurable via the standard menu (Esc -> Interface -> AddOns)
- Keybinds for the common operations.
- /ammo slash-command for macro access to Ammo-matique.
Localization support
- enUS: full support
- others: possible, but need translators
- Full functionality should be available across all locales, starting with version 1.4beta2. Prior to this the auto-reloading would not work in non-US locales.
LDB support
Ammo-matique now has LDB support, meaning it integrates with display addons like Titan Panel, ChocolateBar, etc. It provides the current ammo count (color coded based on ammo quality) and ammo icon, as well as list of the available ammo as a tooltip. Left-clicking toggles equipped premium/lowgrade. Right-clicking brings up the configuration dialog. FuBar users can use the Broker2FuBar plugin to enable Ammo-matique and other LDB plugins in FuBar.
Planned features
- Depends on where Blizzard decides to go with ammo... I have built this add-on as platform to build on once we know the details of the changes. Things such as per-boss ammo selection have been considered while designing this add-on, and will be easy to add on, should that become reality.
- Improved ammo bag. Ideally it should be configurable whether you want your ammo first or last in the bag.
- Allowing overriding of ammo type based on the name of a mob, instead of just its class (non-elite/elite/boss) and setting (instance/raid/etc).
- Allow the auto-switching to be enabled/disabled on a per-instance basis.
Known issues
- On zoning/logging in it can sometimes issue the "all ammo exhausted" warning, even though you have ammo. This seems to be due to the game not providing all bag contents for inspection by the addon at that stage. As it is, the warning is harmless (though somewhat annoying). I'm looking into possible fixes for it.
- At least two bosses is Icecrown Citadel (Lady Deathwhisper and Prof. Putricide) are tagged by the game as being only "elite" rather than "bosses". For this reason Ammo-matique might pick the wrong ammo.
- Should you manage to find a (new) bug, please use the ticket system to provide feedback.
Status
Other
- If you like this add-on, you might want to look at Track-o-Matique as well.
------------------------------------------------------------------------
r49 | anyia3 | 2010-01-31 06:58:27 +0000 (Sun, 31 Jan 2010) | 1 line
Changed paths:
A /tags/1.9 (from /trunk:48)
Tagging as 1.9.
------------------------------------------------------------------------
r48 | Anyia3 | 2010-01-31 06:56:36 +0000 (Sun, 31 Jan 2010) | 3 lines
Changed paths:
M /trunk/Ammo-matique.lua
* Fix to now only warn about using the wrong ammo once per fight.
------------------------------------------------------------------------
r46 | Anyia3 | 2010-01-27 13:11:27 +0000 (Wed, 27 Jan 2010) | 4 lines
Changed paths:
M /trunk/Ammo-matique.lua
* Fixed brokeness that was jamming up the choosing of low-grade ammo once
premium had been picked (bug introduced in 1.9beta1).
------------------------------------------------------------------------
r44 | Anyia3 | 2010-01-27 07:07:53 +0000 (Wed, 27 Jan 2010) | 4 lines
Changed paths:
M /trunk/Ammo-matique.lua
* Prevent running SetAttribute while in combat lockdown, as that seems to
cause taint.
------------------------------------------------------------------------
r42 | Anyia3 | 2010-01-23 07:43:54 +0000 (Sat, 23 Jan 2010) | 15 lines
Changed paths:
M /trunk/Ammo-matique.lua
M /trunk/Ammo-matique.toc
A /trunk/Voices/wasm_female1.mp3
A /trunk/Voices/wasm_male1.mp3
M /trunk/bindings.xml
M /trunk/config.lua
M /trunk/locale.enUS.lua
M /trunk/locale.lua
A /trunk/secure.xml
* Removed "auto-reload" feature since it's no longer possible to implement
given the new 3.3 constraints Blizzard imposes.
* Stop trying to switch ammo while in combat - getting ammo on the cursor while
in combat is highly annoying.
* Warn if in combat and using the wrong ammo due to Ammo-matique not being able
to switch for you.
* Changed the implementation of the "equip premium" and "equip low-grade" key
bindings. They now use a SecureActionButton and can hence be used in-combat
again. Unfortunately I can't migrate the previous key-binds across, so it
is necessary to re-set the keybinds (Esc -> Key Bindings -> Ammo-matique).
------------------------------------------------------------------------
r41 | Anyia3 | 2010-01-23 02:00:31 +0000 (Sat, 23 Jan 2010) | 3 lines
Changed paths:
M /trunk/Ammo-matique.lua
* Don't even try to equip ammo if we're in combat lock-down...
------------------------------------------------------------------------
r40 | Anyia3 | 2010-01-20 04:09:06 +0000 (Wed, 20 Jan 2010) | 3 lines
Changed paths:
M /trunk/Ammo-matique.lua
* Fixed broken "/ammo config" command.
------------------------------------------------------------------------
Installation Guide
- Exit "World of Warcraft" completely
- Download the mod you want to install
- Make a folder on your desktop called "My Mods"
- Save the .zip/.rar files to this folder.
- If, when you try to download the file, it automatically "opens" it... you need to RIGHT click on the link and "save as..." or "Save Target As".
- Extract the file - commonly known as 'unzipping'
Do this ONE FILE AT A TIME!
- Windows
- Windows XP has a built in ZIP extractor. Double click on the file to open it, inside should be the file or folders needed. Copy these outside to the "My Mods" folder.
- WinRAR: Right click the file, select "Extract Here"
- WinZip: You MUST make sure the option to "Use Folder Names" is CHECKED or it will just extract the files and not make the proper folders how the Authors designed
- Mac Users
- StuffitExpander: Double click the archive to extract it to a folder in the current directory.
- Verify your WoW Installation Path
That is where you are running WoW from and THAT is where you need to install your mods.
- Move to the Addon folder
- Open your World of Warcraft folder. (default is C:\Program Files\World of Warcraft\)
- Go into the "Interface" folder.
- Go into the "AddOns" folder.
- In a new window, open the "My Mods" folder.
- The "My Mods" folder should have the "Addonname" folder in it.
- Move the "Addonname" folder into the "AddOns" folder
- Start World of Warcraft
- Make sure AddOns are installed
- Log in
- At the Character Select screen, look in lower left corner for the "addons" button.
- If button is there: make sure all the mods you installed are listed and make sure "load out of date addons" is checked.
- If the button is NOT there: means you did not install the addons properly. Look at the above screenshots. Try repeating the steps or getting someone who knows more about computers than you do to help.
Translations
When you download a mod, please be sure that the mod is compatible with your translation of wow. Some mods only work on the US versions, while some only work on some of the various European versions. These variations are called "Localizations".
TOC Numbers (Out of Date Mods)
When Blizzard patches WoW, they change the Interface number. This means that all mods will be "out of date" unless or until the author releases a new version for that interface. Some people go into the .toc files and update the numbers themselves, but this is STRONGLY advised against as it will cause problems locating possible incompatibilities addons. When you log into WoW after a patch, you DO NOT have to delete your interface directory. All you have to do is simply tell WoW to ignore the interface numbers and load all the mods anyway. All you have to do is, while at the "character select" screen, look in the lower left corner and click on the "addons" button. A window will pop up listing all your installed mods.
If you look in the upper left corner of that window there should be a box that says "Load Out of Date AddOns". You want to CHECK this box. Now simply go into WoW normally and all your mods should load. As of the 1.9 patch, you will have to do this after EVERY patch/update that Blizzard posts! If you encounter any problems with a mod after a patch, please be sure to let the author of the mod know so they can fix it.
See also: About "Out Of Date AddOns"
Mac Support
WoW addons are not platformed based. As such, they can be used on either Mac or PC. You can extract both .zip and .rar files on a Mac using StuffitExpander.
Directory Structure
World of Warcraft
|_ Interface
|_AddOns
|_*AddonName*
|_ *AddonName*.toc
|_ *AddonName*.xml
|_ *AddonName*.lua
|_ (possibly others as well)...
