Want to notify others in your group when you sheep a mob, but say nothing if you're not in a group? Want to tell your raid who you're summoning? Want an addon that says nothing if you have nothing targeted, so you don't look like a dork? Want an addon to fill in information about your location, target, or current pet? Want to add witty random sayings to any of this? GemSay may be your solution. GemSay gives you these commands:
/gs: Send a message to your raid, party, guild, etc. -- can also /whisper it to a player, /say the message, /emote it, and more.
/gsr: Opens a window that lets you define random message categories, each containing a list of messages that GemSay can choose one from at random. They can then be used in /gs in any combination.
/gst: Opens a window that lets you assign /gs and /gsw messages that will trigger automatically when certain events occur. You can adjust the chance that the message will trigger.
Example:
/gs rp Now sheeping %tt. You hit %to, you tank %to.
The "rp" means that GemSay will send the indicated message to your raid, or to your party if you're not in a raid. If you're soloing, it says nothing. If you have nothing targeted, it also says nothing. The "%tt" is filled in with the name of the targeted unit, and the "%to" is filled in with "him"/"her"/"it", as appropriate. You could bind this to a macro yourself, or you could use /gst and set it to trigger in response to your casting Polymorph without bothering with macros at all.
Read the ReadMe.txt file for lots more information, plus specific examples.
*** 1.8 ***
2009 Nov 1:
* Modified the emote change just slightly: if there is an emote in
the message and if there is an argument after it (any argument at
all), then GemSay will tell WoW to pay attention to whether you
have a target selected when issuing the emote. If there's no
argument, GemSay will tell WoW to ignore whatever target you may
have selected and issue the emote as if you have no target
selected. In other words, "/gs y /laugh xyz" will do "You laugh
at <target name>." if you have a target selected and "You laugh."
if you have no target; "/gs y /laugh" will always do "You laugh."
whether you have a target selected or not. You can't customize
the text that appears when the emote happens; that's a limitation
imposed by WoW (but on the other hand, the fact that the text is
standard means that opposite-faction players can read it too).
* I have merged Yltseirp of Cairne's suggestion and Renvan's first
suggestion into one unified system. Now when the outgoing message
begins with a /, GemSay will first see if it's a chat command and
act accordingly, then see if it's an emote command and act
accordingly, in both cases going through Blizzard's global
variables so there's no need for me to keep huge lists of all the
emotes or all the abbreviations for chat commands. This means
that the destination-overriding possibilities from v1.7 are still
there but slightly improved (every abbreviation allowed by WoW is
allowed by GemSay too, like /g, /gc and /gu for /guild), *plus*
you can have your character do any of the standard emotes as the
outgoing message. A side effect is that anything after an emote
is ignored, and of course you can't broadcast an emote to any chat
mode other than EMOTE, so "/gs y /laugh bob" works the same as
"/laugh" with no target selected: "You laugh." (Note that the
destination code "y" is completely ignored because of the emote,
as is the "bob" that comes after it.) You will do the animation
and sound, however, and the emote will be readable by the opposing
faction.
* Still frustrated about what event (if any) is generated if you
sit on a chair/bench, right-click on a feast, right-click on a
portal to participate in a ritual (like a meeting stone or warlock
summon, a mage table summoning spell, a warlock soulwell, etc.).
This is annoying me because I'd like to say something when I do
this, but so far I'm coming up empty. It seems to me as if no
event whatsoever goes out when you do these things. You can,
however, set a trigger for when you *start* a summon using a
meeting stone or warlock summoning portal, just not when you
assist in creating the warlock summoning portal or in summoning
somebody with it.
2009 Oct 31:
* Sending a message to destination "o" (guild officer chat) can
now check to see whether you have permission to do that. This
means that destination paths like "ogrps" would work (try guild
officer chat first, then guild chat, etc.).
2009 Oct 24:
* Added triggers for other types of spell/ability misses besides
RESIST -- ABSORB, BLOCK, DEFLECT, DODGE, EVADE, IMMUNE, MISS,
PARRY, and REFLECT. This is Renvan's second suggestion.
* Fixed a bug when you hit Cancel while creating a trigger, then
hit New Trigger -- it used to retain data from your canceled
trigger. Now it doesn't.
* Widened the trigger name box so you can see the whole event and
spell it triggers on.
2009 Oct 23:
* Added UNIT_SPELLCAST_CHANNEL_START to the capture -- apparently
things like summoning portals trigger this without triggering SENT
or START.
* Changed event handling code to still trigger on a CHANNEL_START
that arrives without a SENT.
* Still can't find what event, if any, fires when you sit on a
chair or right-click on a feast. Might it be PLAYER_CAMPING?
(Answer: No.)
2009 Oct 22:
* Fixed a bug when printing certain error messages -- they
attempted to call the message() function improperly, leading to
Lua errors.
* Fixed a bug: the button onto which to drag spells or items when
creating a trigger no longer toggles its border bright or dark
when clicked.
* Added the "Capture Next Cast" button in the spell panes of the
trigger editor window. A new way to enter spells that can also
capture a right-click on a world object! This can only trigger on
"Cast Button Pressed" (a.k.a. UNIT_SPELLCAST_SENT) events, though.
Unfortunately it only works so far on objects that actually show a
cast bar, like opening chests. I have not figured out how to make
this work for instant-cast channeled objects like the portals that
appear when mages cast Ritual of Refreshment or warlocks cast
Ritual of Summoning/Souls/Doom, or the portals that appear when
somebody uses a meeting stone or warlock summoning portal.
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)...