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:

/cast !Trap Launcher
/select Freezing Trap, Ice Trap, Explosive Trap, Snake Trap

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:

/cast Milling
/select type:Herb

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

type:"GetItemInfo" type
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:

/select Mythical Healing Potion, item:Bandage, Healthstone, type:Food & Drink

__ Using stuff in the popout the menu __

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:

/click [btn:2](macro name):Menu;(macro name):Action

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:

/cast [flyable,nobtn:2] X-51 Nether-Rocket X-TREME
/select mount:land

__ Future plans __

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)".