This mod adds the /select macro command to use an ability among a list of items and spells. Right-clicking your macro from the bars will pop out a menu where you can change the macro to use a different item or spell.
__ New in 2.0.13 __
toc update for 5.3 patch
Flyout menus at the top 25% of the screen will grow downwards
__ New in 2.0.12 __
Support for the addon Select Favorite Mounts and /select mount:favorite
__ How to use __
Create a macro with this line: /select item or spell, item or spell, item or spell, etc
Drag the macro to your bars.
The first item or spell will be the default action when you hit the macro.
Right-click the macro on your bars to change it to a different item or spell.
For instance, warriors may find this useful:
/select Battle Shout, Commanding Shout
When you create that macro it will cast Battle Shout every time it's hit. If you join a group with a death knight and want to use Commanding Shout instead, right-click the macro on your bars and choose Commanding Shout. In combat or out the macro will now cast Commanding Shout.
You can also embed the /select within a larger macro. For instance hunters may find this useful:
Hit the macro to turn on Trap Launcher if it's not on already, and then use it to launch Freezing Trap. Or right-click the macro to choose a different trap to launch with the macro.
Or inscriptionologomists may find this useful:
Hit the macro to mill the currently loaded herb, or right-click to select a different herb to mill.
__ Search:Keywords __
To help add items and spells to your /select menus (especially since there's a ~30 character tax to macro space, discussed later), several search:keywords are added which users of the earlier version of Select may remember.
Note that all of the filter keywords are Case Sensitive.
item:id or partial name
Add an item by its item:id or all items in your bags and person that contain the partial name.
Examples: item:1234, item:Bandage, item:Ore
spell:id or partial name
Add a spell by its spell:id or all spells in your spellbook that contain the partial name.
Examples: spell:1234, spell:Teleport, spell:Polymorph
mount:flying, land, any, a partial name or favorite(*)
Add all flying mounts, land mounts, any mount, or all mounts that contain the partial name.
Examples: mount:flying, mount:Mechanostrider, mount:Drake
(*) mount:favorite requires the addon Select Favorite Mounts enabled.
profession:primary, secondary, any or partial name
Add primary, secondary or any profession. Supporting skills such as Survey for Archaeology will also be added.
Examples: profession:primary, profession:any, profession:Archaeology
Add all items that contain the search words in one of its type fields. See http://www.wowpedia.org/ItemType for a full list.
Examples: type:Quest, type:Herb, type:Food & Drink
You can use filters alongside item or spell names too. For instance:
The standard behavior of selecting an item or spell in the popout menu is to simply swap your macro to use that new item or spell. If you want to use it immediately, hold <Alt> as you select it.
If you want this behavior to happen all the time without holding <Alt>, there's an option to change it in the default interface options: ESC -> Interface -> AddOns -> Select -> check 'Use Item or Spell When Selecting'
Now selecting an item or spell will also use it, acting more like the default's flyout menus.
__ How it works __
The previous version of Select edited the macro itself when you changed to a different item or spell. This made the old version impossible to swap during combat.
This version only edits the macro when you create it, adding one line:
Behind the scenes, it creates the secure buttons "(macro name):Menu" to summon the menu, "(macro name):Action" to use the current action and "(macro name):Parent" which is the menu frame and all the buttons you see.
__ Limitations __
/select macros need to have unique macro names. All your other macros can share macro names as long as none share a name with a /select macro. The addon may pretend the world will end when it detects this, but the "unexpected" behavior isn't game breaking and renaming either macro will restore the /select macro to working order.
The /click automatically added when creating the macro means you have ~30 less characters to use in the macro. The longer the macro name, the less characters you'll have.
When you create or edit a macro in combat (you should be fighting!) it will wait until you leave combat to turn the macro on or make changes from your edit.
If you gain an item or spell that wasn't available as you entered combat, that item or spell won't be available until you leave combat.
If you change the 'Use Item or Spell When Selecting' option in combat, the change won't happen until you leave combat.
/select doesn't support macro [conditional]s (yet). But you can often work around it. Here's a mount macro that uses a flying mount and a selectable land mount depending on whether you're in an area you can fly or not:
I do intend to support this addon. However I'll be spending my free time playing Mists of Pandaria when the expansion launches, so some tough choices were made on what to cut before MoP launches. These will likely appear in future updates:
macro [conditional] support
pet:<name> or <species> search to add companion pets
slot:<number> search to implement swapping gear to a specific slot
allow /select macros can share names
a few minor options like the menu aspect ratio
planned optimizations like an item/spell cache for search filters
/select command option to exclude items from the list (ie /select item:Ink -Virtuoso Inking Set)
__ Known issues on radar to fix __
Hunter pets can be added with spell:Call but it does not name pets and the macro icon isn't updating to them.
Items with the same name but different item:id's (ie Tiny Green Ragdolls) will only attempt to use them by name.
Some worn quest items like the Sapphire Spectacles will not appear in a select menu while worn.
__ Frequently Asked Questions __
Q: What action bar addons does this support?
A: All of them! Default too, of course. If you can drop a Blizzard macro onto the button then it should work on that button. However, if the macros are outside of the game's 36 general/18 character-specific macro slots, Select won't be aware of them.
Q: Can I add companion pets to a /select?
A: Not yet, sorry. Working on it!
Q: Can I change the order that items or spells list in the menu?
A: If you want certain items to list before others, add them manually. ie: "/select x-51 nether-rocket x-treme, mount:flying" will list the x-51 rocket first.
Q: Tyrael's Charger is missing from my land mounts!
A: Tyrael's Charger can fly so it's grouped with the flying mounts. But if you want to add it to your land mounts you can add it manually: /select tyrael's charger, mount:land
Q: Can I use this to swap trinkets to equip and use?
A: You can! Try "/select type:INVTYPE_TRINKET". At present it will only equip the top trinket slot. A future update will have a slot:<number> filter to support swapping all slots.
Q: Can you make the popout menu align to the action/macro button?
A: No. The secure methods to get the menu working in combat prohibits anchoring willy nilly.
Q: I use spaces for macro names to hide the macro name on the buttons, but I can't have more than one /select macro share a name. Any way to get around this?
A: Use a different number of spaces for each /select macro. Select macros named "(space)(space)" and "(space)(space)(space)" will coexist fine with all your other macros named "(space)".
2.0.13, 5/19/13, toc update, summonpet works in combat, menus at top of screen grow downward
2.0.12, 5/5/13, added mount:favorites filter if Select Favorite Mounts loaded
2.0.11, 4/18/13, BAG_UPDATE unregistered if all menus populated, added Select_PerCharacter_Settings to restore initial actions to last attributes, removed profiling tools
2.0.10, 4/06/13, removed G_PetRoster, added profiling tools
2.0.9, 3/28/13, removed internal pet system, added G_PetRoster
2.0.8, 2/18/13, added macrotext support, centralized timer system, internal pet system
2.0.7, 1/26/13, added tooltips to /select macros
2.0.6, 9/23/12, added nil,1 to GetItemCount in parent:OnShow, added throttled UpdateMacroIcons on BAG_UPDATE, PLAYER_EQUIPMENT_CHANGED
2.0.5, 9/21/12, rewrite release
1.0.0, 11/08/08, initial release