MTarget is an addon that (primarily) assists in targeting through the replacement of tokens in macros. It announces the variables to the raid/party to allow synchronization of targets.
Through the replacement of tokens with values macros can be rewritten on the fly as group and situations dictate.
Note: Given that this is working with macros the updating of the macros can only occur when out of combat.
Commands
To view the command line commands run /mtarget. For a more detailed description of the commands and menu actions have a look at the Commands page.
Options
There are a number of configurable options for MTarget available in the addon tab of the Interface options. Go to Options for a description of the options.
I would recommend having the following options turned on:
- Auto Write Macros
- Auto update on party/raid change
- Show Minimap
Examples
The following are two example macros that I use (for more go to Examples):
Hunter Misdirection Macro Template
/cast [target=$tank,help,nodead][target=pet] Misdirection
Paladin Beacon of Light Macro Template
/cast [target=$tank,help,nodead][help,nodead] Beacon of Light
When joining a party I assign the value tank to the unitid of the tank (e.g. party1) and the macro gets rewritten to replace $tank with party1. In this way it can free up focus from tradition focus macros to be used for other uses.
So after assigning the value of $tank you end up with the following macros:
Hunter Misdirection Macro
/cast [target=party1,help,nodead][target=pet] Misdirection
Paladin Beacon of Light Macro
/cast [target=party1,help,nodead][help,nodead] Beacon of Light
Tutorial
For a quick tutorial on using this addon have a look at the Getting Started page
------------------------------------------------------------------------
r23 | gameldar | 2009-02-11 12:37:47 +0000 (Wed, 11 Feb 2009) | 1 line
Changed paths:
A /tags/beta2 (from /trunk:22)
MTarget:
------------------------------------------------------------------------
r22 | gameldar | 2009-02-11 12:37:20 +0000 (Wed, 11 Feb 2009) | 1 line
Changed paths:
M /trunk/MTarget.lua
MTarget: fixed up the initialisation error and added more output for the broadcast setting.
------------------------------------------------------------------------
r21 | gameldar | 2009-02-10 11:08:08 +0000 (Tue, 10 Feb 2009) | 3 lines
Changed paths:
M /trunk/MTarget.lua
MTarget:
Fix up a variable mismatch for the Broadcast acceptance.
Set up the ShowMinimap option to be on by default and to hide the minimap button if it isn't on in the Enabled code.
------------------------------------------------------------------------
r19 | gameldar | 2009-02-02 15:13:11 +0000 (Mon, 02 Feb 2009) | 1 line
Changed paths:
M /trunk/MTarget.lua
MTarget:all seems working - haven't tested broadcasting though.
------------------------------------------------------------------------
r18 | gameldar | 2009-02-02 03:19:33 +0000 (Mon, 02 Feb 2009) | 2 lines
Changed paths:
M /trunk/locales/MTarget-enUS.lua
Protect against printing errors because of nil values by always using a wrapper function to get the value or "nil" if it isn't set.
------------------------------------------------------------------------
r17 | gameldar | 2009-02-01 15:08:56 +0000 (Sun, 01 Feb 2009) | 1 line
Changed paths:
M /trunk/MTarget.lua
MTarget:Looks like most of it is working (haven't tested broadcasting yet though)
------------------------------------------------------------------------
r16 | gameldar | 2009-01-29 14:59:15 +0000 (Thu, 29 Jan 2009) | 1 line
Changed paths:
M /trunk/MTarget.lua
MTarget:menus working - still a bit ugly
------------------------------------------------------------------------
r15 | gameldar | 2009-01-29 12:25:00 +0000 (Thu, 29 Jan 2009) | 1 line
Changed paths:
M /trunk/MTarget.lua
M /trunk/MTarget.xml
MTarget:About to rip some stuff out
------------------------------------------------------------------------
r14 | gameldar | 2009-01-27 13:34:38 +0000 (Tue, 27 Jan 2009) | 1 line
Changed paths:
M /trunk/MTarget.lua
M /trunk/locales/MTarget-enUS.lua
MTarget:Another test to get the menus working. Changing the handling of the Set Target Menu... item so that it grabs the target via the UnitPopup_ShowMenu function instead.
------------------------------------------------------------------------
r13 | gameldar | 2009-01-24 15:22:55 +0000 (Sat, 24 Jan 2009) | 1 line
Changed paths:
M /trunk/MTarget.lua
M /trunk/MTarget.xml
MTarget:everything but the menu text working... still need to test stuff though
------------------------------------------------------------------------
r12 | gameldar | 2009-01-19 07:12:28 +0000 (Mon, 19 Jan 2009) | 5 lines
Changed paths:
M /trunk/.pkgmeta
M /trunk/MTarget.lua
M /trunk/embeds.xml
M /trunk/locales/MTarget-enUS.lua
- Changed the broadcast comms to use AceSerializer (and added dependencies)
- Changed the way the minimap button menu items are generated and displayed
- allowed broadcasting a single variable by name
- added a new function (and auto-update options) to update the variables where a valid unitid exists.
------------------------------------------------------------------------
r11 | gameldar | 2009-01-16 07:51:26 +0000 (Fri, 16 Jan 2009) | 2 lines
Changed paths:
M /trunk/.pkgmeta
M /trunk/MTarget.lua
M /trunk/MTarget.toc
M /trunk/embeds.xml
A /trunk/locales
A /trunk/locales/MTarget-enUS.lua
Implemented Locale support
------------------------------------------------------------------------
r10 | gameldar | 2009-01-16 04:56:23 +0000 (Fri, 16 Jan 2009) | 5 lines
Changed paths:
M /trunk/MTarget.lua
Added command to reset/delete templates.
Added command to broadcast variables (manually rather than automatically)
Added support for batch sending of variables (so only one write of the macros)
Changed the text on the Create Template button to just template since it was too long.
------------------------------------------------------------------------
r9 | gameldar | 2009-01-15 15:21:16 +0000 (Thu, 15 Jan 2009) | 1 line
Changed paths:
M /trunk/MTarget.lua
M /trunk/MTarget.xml
MTarget: fix up no working stuff!
------------------------------------------------------------------------
r8 | gameldar | 2009-01-15 07:50:55 +0000 (Thu, 15 Jan 2009) | 2 lines
Changed paths:
M /trunk/MTarget.lua
Trying another method for getting the button added to the MacroFrame.
------------------------------------------------------------------------
r7 | gameldar | 2009-01-15 06:31:50 +0000 (Thu, 15 Jan 2009) | 5 lines
Changed paths:
M /trunk/MTarget.lua
M /trunk/embeds.xml
Changed over to using the StaticPopup for the input windows.
Added support for setting raid icons.
Finished the implementation for setting from broadcasts.
Reworked the menu initialisation a bit.
------------------------------------------------------------------------
r6 | gameldar | 2009-01-13 15:10:12 +0000 (Tue, 13 Jan 2009) | 3 lines
Changed paths:
M /trunk/MTarget.lua
M /trunk/MTarget.xml
more work on the comms - and accepting the changes via dialog window. Another attempt at getting the create template button onto the macro ui.
------------------------------------------------------------------------
r5 | gameldar | 2009-01-13 13:22:39 +0000 (Tue, 13 Jan 2009) | 3 lines
Changed paths:
M /trunk/MTarget.lua
M /trunk/MTarget.xml
M /trunk/embeds.xml
Implemented minimap button and start of comms
------------------------------------------------------------------------
r4 | gameldar | 2009-01-10 00:47:41 +0000 (Sat, 10 Jan 2009) | 1 line
Changed paths:
M /trunk/MTarget.lua
M /trunk/MTarget.xml
MTarget: Fix up the command parsing and fixed conflict from XML and function names.
------------------------------------------------------------------------
r3 | gameldar | 2009-01-09 04:15:32 +0000 (Fri, 09 Jan 2009) | 3 lines
Changed paths:
M /trunk
M /trunk/MTarget.lua
* Added in the svn:externals for the ace libraries.
* Rewrote the command parsing for the main command function
------------------------------------------------------------------------
r2 | gameldar | 2009-01-09 03:11:48 +0000 (Fri, 09 Jan 2009) | 2 lines
Changed paths:
A /trunk/.pkgmeta
A /trunk/MTarget.lua
A /trunk/MTarget.toc
A /trunk/MTarget.xml
A /trunk/embeds.xml
Initial commit of the package. Works with slash commands - but the UI is not there yet.
------------------------------------------------------------------------
r1 | root | 2009-01-07 06:38:30 +0000 (Wed, 07 Jan 2009) | 1 line
Changed paths:
A /branches
A /tags
A /trunk
"mtarget/mainline: Initial Import"
------------------------------------------------------------------------
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)...
