Announce: JASpellHelper Addon v1.1

Forum for mod & macro requests and discussion

Moderator: Demon Hunters

Post Reply
User avatar
Lealla
Class Leader
Posts: 3797
Location: Orefield, PA
WoW character race: Night Elf
WoW character class: Druid
WoW character gender: Female
WoW character level: 100
WoW character guild: You and Whose Army
Contact:

Announce: JASpellHelper Addon v1.1

Post by Lealla » Fri Dec 28, 2007 8:02 am

JASpellHelper
Contributed by Lealla
Download


INTRODUCTION
Have you ever wanted to announce your spellcasts to the world, but hate the way macros always say the message regardless of whether the spell was cast or not? Have you ever wanted to have a set of random messages instead of just one or two? Are you aching for a creative outlet with no relief in sight?

Well, JASpellHelper is here to help. It's a spell announce addon. In the current version, it allows you to store messages to be broadcast for specific spells. When it detects that spell being cast, it picks a random message from the list and sends it to a channel based on whether you are in a raid, party, or just soloing. It supports an unlimited number of spells and an unlimited number of messages per spell. It's also smart enough to know not to announce stuff when you're mind controlled. (I'm working on the PvP aspect.) See below for complete instructions.


INSTALLATION
This addon utilizes the same installation method as virtually any other Warcraft addon. Simply extract the .ZIP file into your /interface/addons folder.


COMMANDS
After logging in, use the "/jash" command to control the addon.

Commands are as follows. All settings are persistent through sessions.
Command List wrote:/jash on|enable
Turn JASH on. (default)

/jash off|disable
Turn JASH off. Stops event processing, but you may still change settings.

/jash debug
Toggle debug mode. This will print all events that JASH handles to your primary chat window. Not for the faint of heart.

/jash announceself
Toggle self-announce mode. If this is off, messages will not be sent when you cast a spell on yourself. Default is off.

/jash raidchannel=X
Set raid channel to X. Messages will be sent to this channel while you are in a raid.

/jash partychannel=X
Set party channel to X. Messages will be sent to this channel while you are in a party.

/jash defaultchannel=X
Set default channel to X. Currently, messages are only sent in a party or raid; I plan to support a configuration option for this later.

/jash add spell=X message=Y
Add message Y to the list for spell X. "%t" in message will be substituted with the target's name.
Spell names with multiple words must be enclosed in quotes. The message should also be enclosed in quotes.

/jash delete spell=X [id=Y]
Delete message Y from the list for spell X. Without ID, delete all messages for spell X. Use "list" to find the ID of a message.

/jash list [spell=X]
List messages for spell X. Without X, list all spell messages.

/jash send spell=X [target=Y]
Send a random message for spell X with target Y.
USAGE
To use the addon, you add messages for each spell that will be randomly broadcast when that spell is cast. Let's say that you want to announce your Holy Light spell to the world. You would type:

Code: Select all

/jash add spell="Holy Light" message="Healing %t with the holy light of the gods."
After doing this, when you begin casting Holy Light, that message will be displayed. You can add as many messages to each spell as you want and they will be randomly selected.

To see all messages for Holy Light, type:

Code: Select all

/jash list spell="Holy Light"
Messages will be shown with their ID number in case you want to delete them later. To delete a specific message, use:

Code: Select all

/jash delete spell="Holy Light" id=1
To delete all messages for Holy Light, use:

Code: Select all

/jash delete spell="Holy Light"
No confirmation is given, so be sure you want to do it.

Although the addon will automatically send messages in response to spell events unless you turn it off, you can forcibly send a message in a macro by using /jash send, such as:

Code: Select all

/jash send spell="Holy Light"
Instant, channeled and non-targeted spells are also supported, as are items, mounts, etc. You can use this as a CC announce, too. For example:

Code: Select all

/jash add spell="Hibernate" message="%t is about to take a long nap.  If you hit it, you tank it."
NOTE: In order to avoid unnecessary spam, the option to announce spellcasts when the target is the player is off by default. However, you can turn it on with /jash announceself. Also, the addon is silent when you are not in a party or raid.


UPDATES
  • December 27, 2007
  • Updated "debug" mode.
  • Updated TOC for 20300.
  • Improved logical handling of spellcast events, and removed all traces of the old pre-2.0 coding.
  • Finally fixed issue with announcing non-targeted spells.
  • The addon will not attempt to broadcast messages if you are mind controlled or otherwise not in control of your character.

    April 25, 2007
  • Now correctly announces non-targeted spells, such as AoEs.
  • Now properly determines when you are in a party.
  • Additional notes: Removed extraneous debugging code, so "debug" option won't do anything.
ADDITIONAL INFORMATION
  • The default raid channel is "RAID".
  • The default party channel is "PARTY".
  • The default "default" channel is "SAY", although this is unused at present.
  • Supported channels are: "SAY", "PARTY", "RAID", "GUILD", and "WHISPER". I can add custom channel support if there's enough interest.
  • If "WHISPER" is set as the channel, the message will be sent only to the spell's target. If the spell does not have a target, no message will be sent.
NOTICE wrote:If you would like any additional information on this addon or have any comments or concerns pertaining to this addon, please either direct them to the addon's creator, Lealla, or in a reply to this thread.

All replies to this thread must remain strictly on-topic of this addon in order to help address any questions/comments and/or concerns about this addon. Any replies that are off-topic may be deleted without notice.
Last edited by Lealla on Fri Dec 28, 2007 5:11 pm, edited 1 time in total.

Stask
Posts: 1804

Post by Stask » Fri Dec 28, 2007 4:17 pm

So for those of us who speak English, what does this mod do and how is it useful? :-P
"I am unworthy of any respect. True story." -Brulan

Recorded for posterity. He had no idea how right he was.

User avatar
Lealla
Class Leader
Posts: 3797
Location: Orefield, PA
WoW character race: Night Elf
WoW character class: Druid
WoW character gender: Female
WoW character level: 100
WoW character guild: You and Whose Army
Contact:

Post by Lealla » Fri Dec 28, 2007 5:03 pm

You know how I announce rezzes and Innervates with random messages when I'm in groups? This is what does it.

Maybe I should put that in the post... yeah hmm...
Image
Image

User avatar
Lealla
Class Leader
Posts: 3797
Location: Orefield, PA
WoW character race: Night Elf
WoW character class: Druid
WoW character gender: Female
WoW character level: 100
WoW character guild: You and Whose Army
Contact:

Post by Lealla » Thu Jan 17, 2008 9:21 am

I'm curious if anyone besides me uses this addon. I've got another major upgrade ready to upload, after extensively testing it.
Image
Image

User avatar
Palehorse
Posts: 2031

Post by Palehorse » Mon May 19, 2008 11:48 pm

I guess I'm going to be using it since you haven't told me how to create .lua files /ToC folders O_o

Stask
Posts: 1804

Post by Stask » Tue May 20, 2008 12:37 pm

Now that I got Laivindil to 70 and decently geared for Kara runs, this is going to be worth using for me.

Hell, I gotta think up some worthy one-liners for Stask's Battle Rez and Laiv's Ressurection now.
"I am unworthy of any respect. True story." -Brulan

Recorded for posterity. He had no idea how right he was.

User avatar
Lealla
Class Leader
Posts: 3797
Location: Orefield, PA
WoW character race: Night Elf
WoW character class: Druid
WoW character gender: Female
WoW character level: 100
WoW character guild: You and Whose Army
Contact:

Post by Lealla » Tue May 20, 2008 1:18 pm

I'm going to upload the 1.2 version of JASH soon, since it adds some extra features.

Pale, if you're going to learn how to code your own addons, I recommend you visit http://www.wowwiki.com/ and hit up the Interface section. It has "Howto" articles on this sort of thing, replete with examples.
Last edited by Lealla on Tue May 20, 2008 1:39 pm, edited 1 time in total.
Image
Image

Kendalh
Demon Hunter
Posts: 738

Post by Kendalh » Tue May 20, 2008 1:31 pm

Pale, not Polar Lealla.

User avatar
Lealla
Class Leader
Posts: 3797
Location: Orefield, PA
WoW character race: Night Elf
WoW character class: Druid
WoW character gender: Female
WoW character level: 100
WoW character guild: You and Whose Army
Contact:

Post by Lealla » Tue May 20, 2008 1:39 pm

Oops
Image
Image

Stask
Posts: 1804

Post by Stask » Tue May 20, 2008 5:45 pm

Zomg, JASH 1.2!

And I just DL'ed 1.1. Lealla, when you're in-game, hit me with a tell, I got some questions about this mod and getting it to use messages in /say chat like you do it with your rezzes.
"I am unworthy of any respect. True story." -Brulan

Recorded for posterity. He had no idea how right he was.

Post Reply