RSwapper 3: Swaps main-hand weapon for a rogue, depending on stealth, stuns and other buffs - between daggers and other weapons.
Jousting (3.2.0.13)
RSwapper3 will no longer attempt to swap weapons if you have a Lance equipped, similar to the Fishing Pole functionality.
Off Hand Swapping (3.2.0.11)
See also the section titled: "Option - Offhand:"
First let me explain that for most normal circumstances, this feature is completely useless. The purpose of RSwapper3 to maximize damage only relies on the Main Hand to be a dagger at some times, and a higher damage weapon at others. Changing the Off Hand should not have any effect on this. The reason I added this feature, however, is for special cases where a weapon is Main Hand or Off Hand restricted. An example is if your Sword is Main Hand restricted, and you keep your Dagger in your Off Hand. Once you stealth, your Dagger would go to your Main Hand, and the Main Hand restricted weapon would be forced to your inventory; leaving you with no Off Hand.
Currently the Off Hand settings are only available from the GUI (/rswapperg or /rs3g). There are two item icons, similar to the ones in your paper doll frame, for your Sword and Dagger weapons. Just like the paper doll frame, the icons are for your Main Hand and Off Hand weapons from left to right. The Off Hand weapons are optional, and if left blank RSwapper3 will not attempt to change that slot. You can always clear the Off Hand weapon setting by Right Clicking the item icon.
Sound (3.1.1.4)
RSwapper3 now plays a sound when it swaps your weapons, as an audible confirmation. However, this sound can be disabled through the options menu (/rs3g or /rswapperg).
TRANSLATIONS NEEDED!! (3.1.1.4 changed and added some texts)
If you are interested in helping to translate RSwapper3 go to http://www.wowace.com/projects/rswapper3/localization/
Donations:
You may have noticed RSwapper3 now has a donation button. I will appeciate any donations as a form of your thanks for my time and effort on this add-on. Aside from this brief statement, I will not ask or beg for donations. I will NEVER threaten a cease to the project due to a lack of donations. You should NEVER feel like you have to donate.
Credits:
Progammers:
- x87Bliss (Dayofthedead - Retaliation)
Translators:
- French (69.2%)
- German (76.9%)
- Russian (88.5%)
- Hemathio
- s8095324
- Damieno
- Spanish (26.9%)
- Traditional Chinese (13.5%)
Based on the rswapper code by Shambarimen (Muradin), who rewrote the code for the original idea of RogueSwapper by Krax (Daggerspine) aka m0rfin.
About RSwapper3:
This mod will automatically switch your main-hand weapon to a specified dagger when you're stealthed, optionally if your target is stunned, and optionally if you have the Shadow Dance buff. It will also switch back to a different default weapon (sword) when the dagger is not needed. This will allow you to take advantage of using Ambush and Backstab in these situations, while using a higher damage output weapon in other circumstances.
RSwapper3 will not swap if the weapon to be swapped to is broken (0 durability). It will display a warning if this happens.
A note on dagger/sword combinations:
The dagger setting doesn't have to be a dagger, but it should be for the purpose of this add-on.
The sword setting doesn't have to be a sword, it can be any weapon you want.
Differences from RSwapper:
- Updated (Uses Ace-3.0 libs), and fully compatible with WoW 3.1.1
- Does not depend on WeaponQuickSwap
- Takes advantage of more of WoW's API to do things more efficiently
- Can be set to swap to dagger during Shadow Dance buff
- Can be set to announce when you cast Blind, via Say
- Added "enable" option to temporarily enable/disable per character
- Only registers events and slash commands if your character is a rogue
- Does not try to swap weapons when you're afflicted by certain stuns, or when you're channeling, to reduce error messages
- Data Broker support for use in add-ons like Titan Panel
- GUI Options menu (/rs3g or /rswapperg)
- Supports jousting and having a lance equipped
New Usage: (v3.1.1.4)
Use the following slash commands to bring up the RSwapper3 options interface: /rs3g or /rswapperg
Old Usage: Similar to rswapper by Shambarimen
Commands from either /rswapper or /rswapper3 (both work)
"/rswapper3" alone will explain all the commands, and their current setting
Example:
To toggle swapping when you have Shadow Dance buff
/rswapper3 dance
Option - Offhand: (Default: On)
The Offhand option toggles searching your Off Hand slot for weapons when attempting to swap them to your Main Hand, and searching your Main Hand slot for weapons when attempting to swap them to your Off Hand.. In most cases this option can be left on. However, if your Off-Hand weapon also happens to be the same as either your Dagger or Sword, you may want this option turned off so RSwapper looks in your bag, instead of taking it from your Off Hand slot.
Option - Blind: (Default: Off)
The "Blind" function basically automatically says "/s Casting Blind on %t, don't attack and break it." whenever you cast Blind. Most players probably won't pay attention to it, but it's worth a shot. As of 3.2.0.11 this feature has been greatly improved; it now the target reflects the actual target of blind, as opposed to your current target. This makes announcing when using macros like "/cast [target=mouseover] blind" accurate.
Data Broker: (Titan Panel) (v3.1.0.3)
If you have an add-on that supports showing Data Brokers, such as Titan Panel, you will notice that RSwapper3 now shows up in the list of Data Objects (it may be under the Combat category). This Data Broker displays seven different circumstances:
- [Sword] (in blue) - Your sword is equipped.
- [Sword] (in orange) - Your sword should be equipped, but isn't yet. (Stun possibly)
- [Dagger] (in purple) - Your dagger is equipped.
- [Dagger] (in red) - Your dagger should be equipped, but isn't yet.
- [Fishing] (in cyan) - You have a fishing pole equipped, so no swapping will be done.
- [Joust] (in silver) - You have a lance equipped, so no swapping will be done.
- [Disabled] (in red) - RSwapper3 is set to be disabled, or your character isn't a rogue.
In addition to this quick display, the Tool-tip for the Data Object will also tell you the above status along with additional info. For example if [Dagger] is red because it's broken, the tool-tip will tell you that it's broken.
The Tool-tip will also list the current setting of each option, so you don't have to use your chat pane to verify.
Lastly, clicking the Data Object will bring up a menu. Most of the options can be toggled in this menu.
Hopefully this Data Broker (if people have the add-on to see it) will make things much simpler.
Changes:
- v3.2.0.13
- Added support for Jousting. RSwapper3 will not swap weapons out if a Lance is equipped.
- Added compatibility for "Joust Do It!"
- v3.2.0.11
- Greatly improved Blind function and the Weapon GUI.
- Finally fixed the "Can not find weapon" error when zoning.
- Quite a few performance enhancements.
- ...And now hopefully curse will say it's for version 3.2.0 instead of "Unknown." I believe that happened since I updated too early.
------------------------------------------------------------------------
r78 | x87bliss | 2009-08-13 04:04:28 +0000 (Thu, 13 Aug 2009) | 1 line
Changed paths:
A /tags/v3.2.0.13 (from /trunk:77)
Tagging as v3.2.0.13
------------------------------------------------------------------------
r77 | x87bliss | 2009-08-13 04:03:21 +0000 (Thu, 13 Aug 2009) | 1 line
Changed paths:
M /trunk/RSwapper3.lua
M /trunk/RSwapper3.toc
M /trunk/core.lua
Bug fix: Added support for jousting, and compatibility with "Joust Do It!" - my new addon coming soon.
------------------------------------------------------------------------
r75 | x87bliss | 2009-08-10 02:27:10 +0000 (Mon, 10 Aug 2009) | 1 line
Changed paths:
M /trunk/RSwapper3.toc
Oops... accidentally went back to version 3.1 interface identifier. Fixed.
------------------------------------------------------------------------
r73 | x87bliss | 2009-08-10 02:10:35 +0000 (Mon, 10 Aug 2009) | 6 lines
Changed paths:
M /trunk/GUI/WeaponFrame.lua
M /trunk/Locale/RS3LocdeDE.lua
M /trunk/Locale/RS3LocenUS.lua
M /trunk/Locale/RS3LocesES.lua
M /trunk/Locale/RS3LocfrFR.lua
M /trunk/Locale/RS3LocruRU.lua
M /trunk/Locale/RS3LoczhTW.lua
M /trunk/RSwapper3.lua
M /trunk/RSwapper3.toc
M /trunk/core.lua
Greatly improved Blind function, uses combat log to determine the target to make /cast [target=mouseover] blind and other macros accurate.
Performance: Combat log is only watched if Blind is turned on.
Performance: Code used to determine player and target stuns has been improved for better performance.
Performance: Completely rewrote the Weapon GUI so it does not need to be updated nearly as often.
Ease of use: Completely rewrote the Weapon GUI to make it easier to use.
Bug fix: "Can not find weapon" while zoning now has a working fix. Although patch 3.2 may have fixed the circumstance anyway.
------------------------------------------------------------------------
r71 | x87bliss | 2009-08-04 22:15:50 +0000 (Tue, 04 Aug 2009) | 1 line
Changed paths:
M /trunk/RSwapper3.toc
Correctly updated version number. :-X
------------------------------------------------------------------------
r70 | x87bliss | 2009-08-04 22:13:52 +0000 (Tue, 04 Aug 2009) | 2 lines
Changed paths:
M /trunk/RSwapper3.toc
TOC Bump for 3.2; no changes seem to be needed, report bugs.
Certain bug fixes will be coming soon (not related to 3.2)
------------------------------------------------------------------------
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)...
