Macro Toolkit
Please share your macros and custom commands in our forum: wow.curseforge.com/addons/macro-toolkit/forum
Macro Toolkit is an enhanced macro frame that adds the following features to the default macro UI:
- Macro Shortening
- Key Binding and key bind only macros
- Extended Macros
- Condition Builder
- Extended, Searchable Icon Frame
- Syntax Highlighting
- Syntax Checking
- Drag and Drop Moving
- Movable Macro Frame
- Scalable Macro Frame
- Insert Special commands
- Easy Slot Selection
- Backup
- Restore
- Clear all Macros
- Share Macro
- Add Custom Slash Sommands
- Slash Commands for Common Lua Script Functions
- Copy macros between characters
- ElvUI Skin
Using Macro Toolkit
By default Macro Toolkit overrides the built in macro UI and can be accessed in the same way. If you chose to keep the default UI as well, Macro Toolkit can still be accessed using the following slash commands:
- /mac
- /mtoolkit
- /macrotoolkit
Be warned though that if you chose this option the two macro frames may not play well together .
Macro Shortening
Macro Toolkit will attempt to shorting your macros without affecting functionality. It does by looking for the shortest options for each command used, removing unnecessary spaces and optionally replacing known common Lua script functions with Macro Toolkit commands. This is more involved than it may sound, so it's worth checking that nothing has been removed that you kinda wanted left alone once you've used this function.
Key Binding and key bind only macros
Macros can be bound directly to keys without the need to place the macro on an action bar. Macro Toolkit also has a special tab that adds 18 keybind only macros - these macros can only be used with key binds, they cannot be put onto action bars.
Extended Macros
Macro Toolkit can extend macros beyond the 255 character limit.
Condition Builder
Macro Toolkit has a tool to help you build conditional statements for use in macros using dropdown boxes with easy to understand descriptions of the conditions.
Extended, Searchable Icon Frame
When creating a new macro or changing an existing one, the default macro UI offers you a small window showing 15 of the available icons for your macro at a time. As of version 5.1.0.1 Macro Toolkit uses LibAdvancedIconSelector to make more icons visibible at the same whilst also offering a search facility and icon filtering by means of options.
Syntax Highlighting
Macro Toolkit can optionally highlight commands, conditions and parameters in macros by changing the colour (yeah, I'm British :-)) of each keyword. These colours can adjusted using the in game options menu.
Syntax Checking
Basic syntax (which can be switched off if required) is performed on the macro as you type (or after they've been typed). Any errors found, along with suggestions for mistyped keywords are shown in an adjacent window.
Drag and Drop Moving
Macros can be moved from General to Character Specific, or vice versa by a simple drag and drop operation
Movable Macro Frame
Macro Toolkit's frame can be moved to anywhere you want it on your screen. The position will be remembered for future use.
Scalable Macro Frame
Macro Toolkit's scale can be adjusted. This allows you to increase or decrease the size of the frame in relation to the rest of the game UI which can help considerably in making your macros easier to read.
Insert Special Commands
Macro Toolkit contains a dropdown list of common Lua script functions used in macros that can be inserted into your macro. The scripts have been converted to slash commands - see below for an explanation of those commands
Easy Slot Selection
To make is easier to work out which slot number equates to which equipment slot on your character, Macro Toolkit includes a dropdown that list all available slots by name, and inserts the appropriate number into your macro.
Backup / Restore / Clear All
Macros can be backed up to your saved variables file and restored later. Macro backups are performed by group, so, if you have the character specific tab selected, then only those macros will be backed up. The same is true for restore. There is also a function to clear all your macros (subject to which tab is selected) if you just want to wipe them all and start again.
Share Macro
Macro Toolkit will print the selected macro to either the Guild, Raid or Party frame if required so that you can share you macros with other people. As of version 5.1.0.1 macros can also be sent directly to other Macro Toolkit users, either individually or to whole group.
Add Custom Slash Commands
If you have a Lua script function that you often use, or just want to shorten, you can create your own custom slash command and add the script to it. Parameters to your script can be accessed using the variables arg1, arg2, arg3 and arg4.
Copy macros between characters
When you log into a character with Macro Toolkit enabled, that character's macros will be recorded (with the right option set) so they can be used with other characters.
Slash Commands for Common Lua Script Functions
Macro Toolkit has the following built in slash commands designed to be used within macros:
- /mtce - Clears UI Errors
- /mtex - Stops errors being sent to the Errors Frame
- /mteo - Allows errors to be sent to the Errors Frame
- /mtrp - Summons a random non combat pet
- /mtso - Enable sound effects
- /mtsx - Disable sound effects
- /mtrt - Set raid target marker
- /mtev - Exit vehicle
- /mtmc - Print the player's map position
- /mttc - Toggle display of cloak
- /mtth - Toggle display of helm
- /mtep - Eject all passengers
- /mtsg - Sell all grey quality items at the vendor screen
- /mtdg - Destroy all grey quality items
- /mtnb - Print a list of all people in your raid with no food buff
- /mtnf - Print a list of all people in your raid with no flask buff
ElvUI Skin
For those of you that use the excellent ElvUI, MacroToolkit will skin itself to match. Note that this will only work for ElvUI users.
Bug Reports / Change Requests
If you find any bugs or have any suggestions for improvements, please use the ticketing system, accessible from the following link:
Locales
Macro Toolkit is currently localised for all WoW game client locales. If you would like to contribute to translating Macro Toolkit, please use the following link:
Please note that the quest names and NPC names are not included in the locale and will still appear in English.
Acknowledgements
- Dohram - for features and testing
- HOPE - for very helpful and patient testing.
- 9 comments
- 9 comments
Facts
- Date created
- Nov 11, 2012
- Categories
- Last update
- Jun 02, 2013
- Development stage
- Release
- Language
- deDE
- enUS
- esES
- esMX
- frFR
- itIT
- koKR
- ptBR
- ruRU
- zhCN
- zhTW
- License
- GNU General Public License version 2 (GPLv2)
- Curse link
- Macro Toolkit
- Downloads
- 36,211
- Recent files
Authors
-
- Manager
- Author
- Reply
- #10
Deepac May 09, 2013 at 06:57 UTC - 0 likesThere's a thread for Macro Toolkit on WoWLazyMacros.com
Members of that site have provided support for the development of Macro Toolkit and many of them use it. Thanks for the comments.
- Reply
- #9
Larnot May 09, 2013 at 04:13 UTC - 0 likesI noticed there aren't a lot of comments in the forum here. Could you please provide a link to the official (or otherwise) site where users of this (wonderful) addon can share current class/spec extended macros? I thought I saw one before, but can't find it now. Thanks!
- Reply
- #8
Deepac Feb 17, 2013 at 01:02 UTC - 0 likesNo worries - the important thing is your macros are ok now :-)
- Reply
- #7
ehrans Feb 17, 2013 at 01:00 UTC - 0 likesyeah!!!! there they are!!!!!!
i sucessfully recovered my macros looking into that file
but now i'm no able to send you the old file, the file contents changed after i restored my macross and reloged wow
- Reply
- #6
Deepac Feb 16, 2013 at 23:44 UTC - 0 likesehrans - the last update alters the way extended macros are stored, but it shouldn't have removed them. If you can PM me your saved variables file, I may be able to recover your macros for you and maybe figure what happened too.
World Of Warcraft/WTF/Account/YourAccountName/SavedVariables/MacroToolkit.lua
- Reply
- #5
ehrans Feb 16, 2013 at 23:17 UTC - 0 likesin the last macrotoolkit update by the curse client, all my macros gone empty. i can't find a text backup anyware.
sad!
- Reply
- #4
StanRyker Jan 17, 2013 at 08:11 UTC - 0 likes@Deepac: Go
I've been using character-specific ones.
- Reply
- #3
Deepac Jan 14, 2013 at 22:22 UTC - 0 likesThanks for raising a ticket for this. I'll get this sorted out. Is it just character specific macros this fails on or general ones too?
- Reply
- #2
StanRyker Jan 13, 2013 at 23:38 UTC - 0 likesI'm liking the addon, working great, except for one really annoying thing.
It only saves one extended macro per character. If I change one macro, it copies it to all other extended macros
all the macros read "/click MacroToolkitSecureButton1" It works if I change each to "/click MacroToolkitSecureButton2" and so forth, but it dosn't save this after a reload.
This is really annoying since I have multiple macros for different specs.