This addon adds the /select macro command you can use instead of /use or /cast to use an item or spell among a list. Right-clicking your macro from the bars will pop out a menu where you can change the item or spell to use.
How to Use
Create a macro with this line: /select 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 to 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. Now the macro will display and cast Commanding Shout.
You can also embed the /select within a larger macro. For mages:
This is a standard focus-sheep macro. When you want to change what polymorph spell to use, right-click the macro on your bars and pick another. It will use that new polymorph until you decide to change it again.
To help add items and spells to your /select macros, search:keywords are usable in place of an item or spell name. These search through your bags and spellbooks to fill the flyout with items and spells that match the keyword(s).
The officially supported searches are item, spell, mount, type, profession and toy:
item:id or partial name
Add an item by its item:id or all items in your bags or worn that contain the partial name.
Examples: item:1234, item:Bandage, item:Ore
spell:id or partial name
Add a spell by its numerical id or all spells that contain the partial name.
Examples: spell:1234, spell:Shout, spell:Polymorph
mount:flying, land, favorite*, favflying*, favland* or partial name
Add all flying, land, favorite, favorite flying, favorite land mounts or mounts that contain the partial name.
Examples: mount:flying, mount:Raptor, mount:favflying
Add all items that contain the keyword in one of its type fields. See www.wowpedia.com/ItemType for a full list.
Examples: type:Quest, type:Food, type:Herb, type:Leather
profession:primary, secondary, any or partial name
Adds all primary professions, secondary professions or any professions.
Examples: profession:Primary, profession:Any, profession:Herb
toy:favorite, any or partial name
Adds favorite toys, all toys or toys that contain the partial name.
Examples: toy:Crash, toy:favorite, toy:any
Just like /cast and /castsequence, /select can use [conditions]. Every [condition] used by the macro system is supported. Some examples:
/select [flyable] Name of flying mount, Another flying mount; Name of land mount
/select [@focus,exists] spell:Polymorph
/select [combat] Master Healing Potion, Healthstone; [nocombat] item:Food & Drink
/select [spec:1] Conjured Mana Cake, Cobo Cola; Conjured Mana Cake, Frybread
/select [nopet] spell:Summon Demon; Grimoire of Sacrifice
Macro length "tax"
To do its magic, Select needs to add a line like this to all macros that contain a /select command:
It will do this on its own and it will recreate this line if it's accidentally deleted or altered. You don't need to worry about it except to remember that when writing your /select macros your macro needs at least 26 characters free for it to add this line (if it's not already there).
Only the first /select in a macro will be recognized. Any others in the same macro will be ignored.
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 in the flyout until you leave combat.
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 Select should work with that button. However, if the macros are outside the game's standard macro slots, Select won't be aware of them.
Q: Can I add companion pets to /select?
A: Yes and no. There's a game limitation that prevent changing the icon easily. That said, pet:name, pet:favorite and pet:any work. But be aware it uses one icon for all pets.
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 you make the popout menu align to the action/macro button?
A: No, sorry. The secure methods to get the menu working in combat prohibits anchoring willy nilly.
If you have any suggestions, comments or bugs to report, feel free to post them in comments here. Thanks!
2.3.6 10/31/14, fix for toy searches failing after zoning (removed cache wipe), removed checks for WoD client
2.3.5 10/14/14, 6.0 patch
2.3.4 9/30/14, flyouts removed from UISpecialFrames on entering combat, prohibited from joining UISpecialFrames during combat
2.3.3 9/30/14, moved copying of flyout->action attributes from unsecure OnAttributeChanged to secure state driver snippet
2.3.2 9/23/14, toybox item support toy:favorite,any,partial search:keyword
2.3.1, 9/4/14, fix for lua error when attempting to show tooltip of a spell no longer known
2.3.0, 8/29/14, rewrite, all /selects are state-driven, searches case insensitive, options panel reworked, full WoD mount support
2.2.0, 7/21/14, initial fixes for WoD beta
2.1.6, unreleased, made index,actionType local in Select_Menu.lua SetAction hooksecurefunc
2.1.5, 2/23/14, fix for handling of invalid/missing [condition]als
2.1.4, 2/20/14, fix for hyphenated item:searches
2.1.3, 1/14/14, fix for mounts not completely loading on login
2.1.2, 12/26/13, frames join UISpecialFrames only when they're shown (out of combat)
2.1.1, 9/11/13, toc update for 5.4
2.1.0, 6/22/13, semi-rewrite: state driver added, flyouts indexed by their list instead of their macro, DontSelectWithAlt option, item cache added,
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