MultiTool: A set of tools aimed at Multi Boxers and friends who group up and quest together.
NOTE: v0.3.02 is the official RELEASE version... it has been farily well tested in 3.1 and I've seen no major issues.
v0.3.04_beta has the newest features and fixes...
Patch 3.1 caused the auto accept group functionality to end up declining even when the settings were for acceptance. PLEASE update to the latest version on Curse.com if you're having troubles.
If you encounter any issues with v0.3.02, post a ticket on wowace and/or leave comments on the MultiTool page.
---------
There are quite a few Multi-boxer specific addons available, but I never liked having to rely on the master being party leader or having to specify a master in the options somewhere. It leads me to stuff like clicking quest gossip options on a "slave" and getting everyone out of sync. To solve this, I came up with a "masterless" way of sharing flight paths and quest gossip.
So, when you want to take a flight path, you just open the flightmaster with all your toons then pick path with whichever toon is handy. They will all follow. It even works if youre all in the same continent but at different flightmasters... as long as they can all get to the node you target, they will all fly even if they were in different zones. (but only on same continent)
As someone who dual / triple boxes all the time, I have found a lot of little bits and pieces in the addon world that help take some of the drudgery out of multiple invites, turnins, quest gossips, yada yada. Often times, I find I am installing a whole addon just for one small feature, leading to a lot of overhead.
Enough is enough. This addon was inspired by Smurfy's MultiBox v2 which has a great collection of really useful stuff. If MultiBoxer was Ace3 or used a more lightweight approach, I'd probably just contribute and/or make a fork. Instead, I've decided to try my hand at a ground-up, exactly-what-I-want, lightweight Ace3-based addon.
For full documentation and change log, please visit the project page at WowAce
I've got a LOT of little things I'd like to do with this addon over time. Some of these may be impractical or not really end up being what I wanted. They are listed here somewhat in the order I want to build them in.
PLANNED FEATURES
- Warn on losing autofollow - Implemented v0.3.5
Warns the person in the party who you were following if you lose / stop following. Both toons involved need to be running MultiTool for this to work, but it doesn't need to be told who is supposed to be following whom... it works that out for itself and warns the person being followed that the follower has stopped.
- Auto Accept Resurrection - Implemented v0.3.04
Auto accepts resurrections... can configure to only allow from whitelist. It even handles situations where you have a number of seconds to wait until being able to accept.
- BLIZ Addon Config compatible - Implemented v0.1.02
Will properly integrate into the new Blizard addon configuration pages
- Profile support - Implemented v0.2.04
Will use profile-type system to allow for easy customization per toon/account
- WhiteList - Implemented v0.2.04
define one or more toons in a list for use in invites, taxi following, auto trade, etc that require a high degree of trust (More than just general friends list)
Possibly define permissions (canAutoTrade, canChooseTaxi, canAutoInvite, etc...)
- Auto Deny duel requests - Implemented v0.1.02
Maybe MAYBE allow whitelist to request dual - though dueling dualboxers seems a bit Freudian to me
- Inviter - Not Started
Attempt to invite all those on your white list with one click
- Taxi Dispatcher - Implemented v0.1.03
Allows other toons in your group with the addon to automatically take the same taxi node as you
- Quest Log Full alert - Implemented v0.2.03
Some kind of sound/warning to other members of group with addon if a toon's quest log is close to full
- Bags full warning - Implemented v0.2.03
Some kind of sound/warning to other members of group with the addon that bag space is low/empty
- LootSetter - Not Started
Automatically set party loot to FFA when leader and party consists only of those on your ffa list. When adding members NOt on your list, switch to Group Loot
- Auto Accept Group Invite - Implemented v0.2.04
define a list of toons whose invites you will always accept
- Auto Repair - Implemented v0.2.00
When a toon with the addon opens a dialog with a repair vendor, it will attempt to repair all
- "Follow Me" - Not Started
Any toon in group with the addon can send a "follow me" command and the others will attempt to /follow them... this will probably ONLY work out of combat due to Blizz security
- AutoTrade - CANCELLED
IF a party member in your group with the addon AND in your white list clicks "accept trade", your toon will auto accept.
NOTE: Due to some abusive addons in the past, Blizz completely protected the AcceptTrade() function from addons being able to run it, so AutoTrade is dead in the water. Just bind a key to a macro with /script AcceptTrade();
- Triage - Not Started
Auto switch party lead to next in line in your whitelist when current leader dies
- Quest Gossip Share - Implemented v0.1.05
Allows other toons in your group with the addon to copy your choices on quest dialogs
- Auto Quest Completion - Not Started
Quests with simple turn-in-and-done dialogs will autocomplete when NPC dialog is opened
- Quest Progress Announcement - Not Started
Announces to others in your party who have the addon when you make progress on a quest(like the old cosmos-based Party Quests) used to do
- Auto Share quests - Not Started
when one toon picks up a quest, they will attempt to share with others in the group who have the addon
- Auto accept shared quests - Not Started
when a shared quest is offered by another in your group with the addon, you will attempt to accept
- Auto Accept Escort/Event quests = Implemented v0.2.04
When an event or escort type quest is started in your group, normally you get a confirmation dialog. MultiTool can be set to auto accept these events without intervention. GREAT for event chain quests like Circle of Blood.
- Auto Sell Gray/Junk - Implemented v0.2.00
When a toon with the addon opens a vendor dialog, it will attempt to auto-sell gray quality items... need a blacklist to stop selling of arbitrary desired items
- Auto restock reagents - Not Started
When a toon with the addon opens vendor dialog, will scan for desired reagents/items as well as current supply in toon's inventory and buy enough to return to preset supply
- Group Hearth - Not Started
Command to cause all in your group with MultiTool (in whitelist when I finally build that) to hearth
NOTES
There are probably many things I can't think of at the moment, but this is a good wish-list.
If I can figure out a way to do it, I may set this up as individual modules so that one can quickly enable/disable parts they want or don't want to save performance and to try and isolate the parts from each other as much as possible
MultiTool:ChangeLog v0.3.06 2009/05/23 DigitalSorceress
v0.3.06 - 2009/05/23
Added features to prevent situation where two MultiTool users in same party
have different available quests thus putting indexex out of sync
Translation of above: Makes sure you're accepting the same quest as other
MultiTool users.
Translation of the above translation: Made selecting quests more reliable
v0.3.05 - 2009/04/30
Added Auto Follow Lost Warning system at request of jst-one at
www.dual-boxing.com forums
I introduced a slight delay between detection of follow lost and when it
actually sends the alert. I found that without this delay, re-hitting follow
caused a very quick LOST and then FOLLOW sequence of events that resulted
in a bit of warning spam.
v0.3.04 - 2009/04/29
Added Auto Accept Ressurection
v0.3.03 - 2009/04/17
Minor fixes
v0.3.02 - 2009/04/15
Ok, this time, auto accept group really IS fixed.
BIG thank you to Borlox and Dridzt from the www.wowace.com community for the
help
v0.3.01 - 2009/04/15
Fixed Auto accept group functionality... apparently, the StaticPopup_HIDE was
happening too close to the AcceptGroup() call, causing the accept to be
aborted
Updated embedded ACE libs to the latest 3.1 safe versions just in case
v0.3.00 - 2009/04/15
updated TOC for Interface 3.1
v0.2.08 - 2008/12/02
Fixed missing library definition that caused config to not show if you didnt
have another addon that defined it - THANK YOU Stithis for the help!
Fixed formatting of repair warning
Fixed a couple of "can't concatenate nil" errors
v0.2.07 - 2008/12/02
Adding announcement of money spent on repairs - and configuration options
v0.2.06 - 2008/11/22
Added self-only option to quest log warn
Added a bunch of comments to source to try and begin the process of refactoring
Commented out a couple things that it looks like aren't going to fly:
specifically, things dealing with AcceptTrade() because it's protected by Bliz
and probably never going to be able to be worked around
v0.2.05 - 208/11/22
Added check for name == UnitName("player") to isInWhiteList to always be true for self
Built standard sound list and a way to handle picking sounds for various events
Added Pick Sound option to bag warn
Added Pick Sound option to quest log warn
Added Pick Sound option for auto accept summons
Added default warning sound setup
v0.2.04 - 2008/11/21
FINALLY worked out how to do the white list.
Added Profiles to options page (I LOVE YOU Ace3 !!! )
Added Auto Accept Summon (and config options for "only if in whitelist") - NEED TESTING
Added Auto Accept Party Invites (white list only)
Added Auto Reject Party Invites from strangers (if not in white list)
Added option to allow folks on whitelist to request duels
Added Auto Accept Escort/event quests... I think this one needs a little on-screen warning tho
Modified TakeTaxi to have option of only following whitelist
Stubbed out Auto Accept Trades, but this may not be possible the way I want to do it
v0.2.03 - 2008/11/20
Want to start working on white list
Fixed fencepost error in bag space alerts when using item_push
Changed config stuff from tree multiple submenus - MUCH cleaner
Added some better descriptions
Changed Bag space warning from BAG_UPDATE to ITEM_PUSH because ITEM_PUSH is
only when you gain an item from quest or vendor... much less spammy
Added sound to bag and quest log warnings
v0.2.02 - 2008/11/19
Massively cleaned up option set/get... using getConfigOptin and
setConfigOption for all get/set options instead of individual functions
v0.2.01 - 2008/11/18
Reorganized the options menu a bit
Fixed Bag space warnings
Changed option for bagWarn to slider
Changed option for questLogWarn to slider
Altered rpcCommandSender to turn PARTY/RAID distribution to WHISPER PLAYER if
called when not in group
Found bug with take Taxi indexing - added a fallback to name search if
index/name don't match up.
Added warning message if taxi node unavailable
Updated debugMe() to handle warn and error a bit differently than notice,
debug, and blather
v0.2.00 - 2008/11/17
Decided to call this 0.2.0 because 0.1.06 marks a fairly clean, almost release
and I want to kind of mentally bookmark before adding a bunch of new stuff
Bag space warnings built... does not seem to be properly warning - will continue
debugging and get it right
Quest log space warnings built... does not yet work properly either - will
continue debugging
Auto Vend Junk built. BE AWARE that this needs to be explicitly enabled in the
options panel (/mtool) and tat it has NO intelligence. If there are any gray
quality items in your bags and you open a dialog with a vendor, those items will
be sold. There is no "blacklist/whitelist" for this one. I wanted a simple
"sell my junk" feature, and this is it.
Auto Repair built. Works beautifully.
v0.1.06 - 2008/11/16
Found out why quest qompletion for non reward choice is not broadcasting ...
Hand't implemented GetQuestReward() because I didn't want it to exactly clone
reward choices in case you're like me and run different classes.
Took a peek at QuestGuru to see how they did autocomplete quests, and
implemented something similar.
Added an option to clone reward choices. So, for those who run all the same
classes, you can really quickly outfit your toons. For those who want to
pick manually, turn the clone option off. By default, cloning is off.
v0.1.05 - 2008/11/16
Continued refinement of remote procedure calls... trying to clean it up as
my concept of "masterless" actions seems to be working. To that end, I created
rpcCommandSend() to broker the messages
Started working on quest broadcast - starting with code from ZQB and adding my
message storm blocking so taht it safely shares gossip no matter which party
member does the dialog
Did a LOT of cleanup - took out some "turds" left over from when I was playing
with the Ace3 Tutorial
v0.1.04 - 2008/11/15
thoroughly testing the taxi follow functionality
Slightly redesigned the taxi mode follow function and made it a lot simpler in the process
v0.1.03 - 2008/11/13
Beginning work on it as I grind away in wotlk
Added config option for auto follow flight point
Got the auto follow taxi system working (flight points)
There were issues with creating "message storms" with the taxi, so use this
feature with care until I've tested it more extensively
v0.1.02 - 2008/11/12
Too many fixes to list - basically, debugging from the original "dry coding"
v0.1.01 - 2008/11/11
Initial Addon creation - dry-coded while wow was down
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)...
