Quick Start

Unzip the contents of the zip archive into your WoW InterfaceAddOns directory. Make sure you 'Use folder names' so the files end up in the right place. You should end up with:
InterfaceAddOnsWeaponQuickSwapreadme.txt
InterfaceAddOnsWeaponQuickSwapWeaponQuickSwap.toc
InterfaceAddOnsWeaponQuickSwapWeaponQuickSwap.xml
InterfaceAddOnsWeaponQuickSwapWeaponQuickSwap.lua

Now log into your character and go to the Main Menu in-game. Select
macros and add a New macro. Give it a name and an icon and his has been reported to occur, but I have not been able to make the
macro text:

/script WeaponSwap('main1', 'off1', 'main2', 'off2', ...);

Parameters are CASE-SENSITIVE:

main1 - What weapon you want in your main hand for set 1.
off1 - What weapon you want in your off hand for set 1.

The following 2 parameters are optional:

main2 - What weapon you want in your main hand for set 2.
off2 - What weapon you want in your off hand for set 2.
(more sets can be specified if desired)

Mages wishing to wield a 2h in their main and a wand in the ranged slot should use MageWeaponSwap() instead of WeaponSwap().

Description

This Add-on adds two functions to the scripting namespace called:

WeaponSwap(...);
MageWeaponSwap(...);

The arguments are pairs of weapons to be held in the main hand and off
hand respectively. For example, if you want to put a 'Sword of the
Black Knight' in your main, and a 'Johnsonville Brat' in the off-hand,
that is:
/script WeaponSwap('Sword of the Black Knight',
'Johnsonville Brat');

But you're thinking. 'Bry, I could already do that pretty easily.'
The fun is that you can specify a second set of equipment to be swapped in if the first is already in place. This macro would switch between just holding a 'Sharpened Letter Opener' in the main hand (nothing off-hand) and two 'Mace of Ultimate Whompitude' in each hand.
/script WeaponSwap('Sharpened Letter Opener', '',
'Mace of Ultimate Whompitude', 'Mace of Ultimate Whompitude');

If you do not wish to change whatever is in that a slot, a wildcard
character '*' can be used.
/script WeaponSwap('Sword', 'Dagger1', 'Dagger2', '*');
Leaves Dagger1 in offhand when switching to set 2. Note that you can
get yourself in trouble if you use too many wildcards:
/script WeaponSwap('*', 'Dagger1', 'Sword', '*');
That probsbly won't do anything once the Sword is in the main and the
dagger is in the offhand. Think your wildcard usage through.

Note: As as design decision, the names are CASE SENSITIVE.
'Misspelled Swoard' and 'misspelled swoard' are not the same. Type it
exactly as it appears in your inventory. I did it this way to avoid
lowercasing a bunch of immutable strings every time you want to switch.

Interesting facts about this script:

-- Slot lock events are used to detect when it is safe to move a
weapon. Prevents hang ups found in other scripts and Add-ons.
-- Uses LinkText to detect item names rather that creating a
GameToolTip descendant. More efficient? Hells yeah.

If you get an error using this, make sure you report it with your macro line *as well as* the position of where the items where before you ran the macro.

More examples

Just a 2h:
/script WeaponSwap('2h');

2h to 1h/shield:
/script WeaponSwap('2h', '', '1h', 'shield');

To swap dual wield hands:
/script WeaponSwap('Hammer', 'Dagger', 'Dagger', 'Hammer');

2h to DW:
/script WeaponSwap('2h', '', 'Weap1', 'Weap2');

DW to Backstab/Ambush
/script WeaponSwap('Weap1', 'Weap2', 'Dagger', 'fish');

Switch between 3 sets of weapons (ss/dw/2h):
/script WeaponSwap('shortsword', 'shield', 'shortsword', 'knife', '2h Hammer');

Staff and Wand to Staff and another Wand:
/script MageWeaponSwap('Smackem Staff', 'Wand of the Fleeting',
'Smackem Staff', 'Tinkerbell's Fairy Wand');

Drunk to Billigerent:
/script WeaponSwap('Tankard of Ale', 'Tankard of Ale',
'Mace of Antioch', 'Sword of Barroom Brawl');

FAQ

Q1. How do I make a macro to switch to a dagger in my main hand,
backstab, then put my weapons back?
A. Short Answer: you cannot.
Long Answer: Switching weapons is not what we call a 'synchronous' rvent. When you say WeaponSwap() it *requests* that the weapons swap and returns to your macro. The actual weapons get in your hands at some point P in the future.
Can such a macro be written? Not since patch like 1.8 where cast actions can not be scripted from an event handler.

Q2. How do I use a weapon that has an apostrophe in the name? Such as a Tyr's Hand?
A. Just use double quotes around the item name instead of single:
/script WeaponSwap('Tyr's Hand', '');

Q3. WeaponSwap stopped working mid-game! What do I do?
A. This problem should be fixed, however if it does occur do any of the following:
/script WeaponSwap_Reset()
OR /console reloadui
OR /script ReloadUI()

Report this mod

Patch notes for WeaponQuickSwap
v35 and above should fix the problem with WQS suddenly not working after several swaps.

38 - Interface version 20003.
Removed support for old WeaponSetsExchange function.

No known issues at this time.