Funny and/or Useful, SpeakinSpell will use random speeches in chat to announce when you use spells and other abilities, as well as items, procced effects, other events, and user-defined macros. Works with all classes. Configurable for many different situations.
Possible Uses
- Entertain yourself, your guild, and your PuGs
- Roleplay
- Tell your raid that you got an important debuff
- Tell your arena team that you're CC'd
- Whisper your target about a short term buff
- Congratulate your guild members on achievements
- Randomize your battle cries
- More
Main Features
- Can detect over 4000 "Events" and automatically announce them in the chat using a random selection from a list of user-defined speeches, including:
- Spells you cast
- All other abilities for any class (a warrior's Heroic Strike is also technically considered a "spell")
- Anything you can equip in your action bar
- Items
- Procced effects (buffs that you receive from yourself)
- Combat events (enter/exit combat, scored a crit, killing blow, etc)
- Talking to NPCs and other game objects like mailboxes
- Achievements
- Other events (Login, Changed Zone, etc)
- whenever you type "/ss macro something" (create your own event)
- Records more event hooks as it discovers more spells, buffs, and debuffs, etc the longer you use it.
- Each spells' random speeches can be directed to any chat channel you choose
- Supports different channel options (or silent) in different scenarios: solo, party, party leader, raid, raid leader, raid officer, BG, arena, and Wintergrasp.
- Also supports built-in emotes and most other slash commands (/cheer, /script, etc)
- Fully configurable through the interface options panel.
- Includes some default example speeches for at least a few spells for all classes.
- These are only meant to serve as examples. In general, very few default speeches are available for most classes, so you may not see it do anything for you right away. You should look at the list of possible event hooks under "/ss create" and write your own speeches.
Usage Instructions
How to setup SpeakinSpell in a few easy steps:
- Login and play your toon for a few minutes.
- Activate any abilities, trigger any procced effects, and encounter any other detectable events that you would like SpeakinSpell to announce.
- Type "/SpeakinSpell" ("/ss" also works) to access the interface options panel
- Click on "Create New..." or type "/ss create" to create settings for a new spell or other event
- Select the desired spell or event from the list and click the Create button. You will be taken to the settings page for that spell or event.
- Change the settings to your tastes and write as many speeches as you want. Now whenever you cast that spell or encounter that event, SpeakinSpell will say one of your random messages for that event, using the channels and other rules that you defined.
- Repeat until you run out of ideas for new announcements to write.
Type "/ss help" for the in-game user's manual for complete, thorough instructions for how to make the most of every feature SpeakinSpell has to offer. It's designed for maximum flexibility.
Additional Features
- Supports over 50 substitutions in your speeches, such as <caster>, <target>, <zone>, <spellname>, <party2pettarget> and many more.
- <spelllink> will create a clickable link to the spell or achievement (for applicable events)
- All of these substitutions also support first person pronoun forms (to say "me" instead of my own name), gender forms, and possessive forms, to make your automated macros sound less like macros and more like natural speech
- Also includes random substitutions like <randomfaction> (like Mad Libs™) and you can create your own random substitution word lists.
- Up to 100 speeches can be entered per spell.
- Never says the same message for a given spell twice in a row (unless you only have 1 message defined for that spell)
- Can be configured to limit your chat spam in several ways
- based on a cooldown between automated speeches in chat
- based on a random chance to speak or not
- optionally limited to once per combat
- optionally limited to once per target name
- Can whisper messages to the target of your spell (This can be useful for resurrect style spells, innervate, power infusion, etc.)
- When you get compliments on your "macros" use "/ss ad" to tell your friends about SpeakinSpell. Some of the random ads are funny. Yes, it's an addon that spams random text in chat, and it has a feature to spam random text to advertise it's ability to spam random text. "/ss help" in game for more advanced options for using /ss ad.
- Detection of "other events" such as Login, entering combat, changed zone, and more. Type "/ss help" in game for the complete list.
- Custom Defined User Macros. Type "/ss macro something" to make SpeakinSpell detect a pseudo spell event called "When I type: /ss macro something" which you can setup to be announced with random speeches like a spell. This can be used for randomized battlecries (/ss macro battlecry), greetings (/ss macro hi), farewells (/ss macro bye), or anything you want to define (/ss macro _blank_).
- Share your speeches with your friends through the Data Sharing system
- type "/ss import" to browse the shared content you collected from others and add it to your settings (works for copying from your alts too)
- type "/ss network" for options
- type "/ss help" for help.
- (easter egg) One day, Grand Warlock Wilfred Fizzlebang offered to help me add some features to SpeakinSpell... unfortunately, he tried to summon a demon to write some code for us, and, well, to make a long story short, the demon is still lurking around somewhere in the addon... Don't let him eat your soul!
Using SpeakinSpell in Non-English Versions
If SpeakinSpell has not yet been localized into your native language, don't worry, it can still work for you.
The core design concepts in SpeakinSpell which enable it to work on any spell for any class also enable it to work in any non-English version of the WoW game client. The slash commands and labels in the options interface will of course appear in English, as well as the default example spell settings and random speeches. However, the core functionality of detecting user-selected spells and events, and announcing them with user-defined speeches, will continue to function in any language.
How to Interpret the Version Number (i.e. why it starts at 3.0.3.01)
The SpeakinSpell version number is composed of the WoW client version number that SpeakinSpell was built and tested against, followed by an incremental SpeakinSpell version number
For example the last time I updated this description, SpeakinSpell version 3.2.2.25 was built against WoW client version 3.2.2, and is my 25th update to SpeakinSpell since that patch to WoW. When WoW 3.3.0 is released, the next versioin will be 3.3.0.01.
More Information
Type "/ss help" in game for the complete user's manual. SpeakinSpell has many more features than those listed above.
If you're a programmer interested in understanding more about how SpeakinSpell works, read the SDD.doc in the SpeakinSpell addon folder. It's a software design document in the (compatible) MS Word 97 file format.
If you have any questions, problems, comments, or concerns, please feel free to post here on the website or submit a ticket.
Credits
SpeakinSpell was created by...
- Stonarius of Antonidas
Primary Beta Testing, Arena Team Pwnage, Key Grip...
- Meneldill
Translators who help me in so many other ways...
- leXin for the German deDE
- troth75 for the Korean koKR
Many of the default speeches were blatantly stolen from...
- Cryolysis2
- Necrosis
- LunarSphere
- Ultimate Warcraft Battlecry Generator
Thanks for the open license guys! I hope you like what I did with it.
Additional Content Packs Written by...
- Stonarius
- Meneldill
- leXin
- troth75
- Folji
- Dire Lemming
Special thanks to the authors of these addons that I used for copy-paste... *Ahem* I mean example code...
- Titan
- Omen
- Recount
- Healbot
- Mountiful
- WinterTime
- the WowAce libs
Additional thanks to...
- Blizzard Entertainment for this great game! ... hire me??
- The community on the wowace forums
- curse.com
- Microsoft Visual Studio, SubVersioN, and TortoiseSVN
- Texas Instruments for enabling E.T. to phone home
- The Order of the Stick
- Mom and Dad
- YOU!!
SpeakinSpell is made from 83% Recycled Materials.
No animals were harmed in the making of this addon.
... Well, the hunter popped a sheep with his aoe, but I resheeped with my /cast [target=focus] macro, and automatically said "Baaah! sheeped again <target>?!" and it was all good...
Facts
- Date created
- 28 Nov 2008
- Categories
- Last update
- 18 Jan 2010
- Development stage
- Release
- Language
- deDE
- enUS
- koKR
- License
- Public Domain
- Curse link
- SpeakinSpell
- Recent files
- R: v3.3.0.07-release for 3.3.0 on 18 Jan 2010
- R: v3.3.0.06-release for 3.3.0 on 18 Dec 2009
- R: v3.3.0.05-release for 3.3.0 on 17 Dec 2009
- R: v3.3.0.04-release for 3.3.0 on 17 Dec 2009
- R: v3.3.0.03-release for 3.3.0 on 13 Dec 2009
- #47
rismisner Wed, 03 Feb 2010 08:56:29I like long posts ;) I understand what you're saying. It's not THAT useful considering the horde and alliance can't understand each other, but I know what you mean about confusing the enemy LOL.
It's not limited to the PvP scenarios for WG, BG, and Arena (at least not intentionally)
Those events are based on COMBAT_LOG_EVENT_UNFILTERED (http://www.wowwiki.com/API_COMBAT_LOG_EVENT) when it sends the events SPELL_DAMAGE (yellow damage) or SWING_DAMAGE (white damage).
IIRC, I tested those features in a duel, with a friend in my group, so it's possible that you only get this event for damage done by a player in your party (friendly fire). The difference between the pairs of events for "caused by me" vs."received" is determined by the name of who was doing the damage, but both use the same SPELL_DAMAGE and SWING_DAMAGE events, which may be limited to damage done by members of your party.
I will have to look into it more closely to see how those events are actually working.
If you saw it work in WG or BGs, then perhaps there is a limitation to the way the combat log events fire into addons in world pvp that's different from how the game behaves in BGs. I'm just rambling off speculation at this point... I'll have to look into it closer.
I'll add... I'm really not happy with the way I implemented those combat events. I had a few enthusiastic people asking me for more event hooks, so I thought this approach would handle the most possibilities in one broad stroke. Unfortunately, I find that waiting for the exact combination of combat flags for (absorbed, resisted, crit) makes it seem broken because all of the conditions have to apply, instead of just one of them. The only real interesting announcements in this area IMO are a critical strike and/or a killing blow, and the rest of the combat flag combinations (like absorbed+resisted) are basically only useful for a random chance to say something in the middle of combat, at a time when nobody is going to correlate what procced your macro. That may be good or bad, but IMO if the point is to announce something randomly (as opposed to triggered on a specific event that others will recognize) then the feature should be designed for that, as opposed to coerced into it by a creative end-user (as I somewhat regrettably coerced the "/ss macro stuff" feature into spell groups, for lack of a better idea at the time...). So I may pursue something like that, and I've been considering adding new separate event hooks for critical, killing blow, and both together, ignoring the other flags. (And I had to use it for a while to realize that the combat rules actually allow for a resisted+absorbed+critical+killing blow ... didn't realize at first that you could resist it, absorb some of it, and still take overkill damage and die... seems so obvious to me now)
Anyway... I think you're application of SpeakinSpell for world PvP and city raids is a great idea, and actually calls for a new feature to identify a new scenario with its own chat channel selection, separate from raid, raid leader, raid officer, BG, WG, and arena... perhaps I should call it "outdoor pvp" and it would use that scenario if you're flagged for pvp but not in WG, BG, or arena... and also in a raid group? Hmmm... I'll have to think about this more too because players on a pvp server would be in that scenario most of the time based on that definition.
Meanwhile, the latest version adds a feature designed to help with some of the odd cases, and you might find this useful: when you've turned off SS but want to spam a random macro manually, without re-enabling automatic announcements based on event detection, you can still type "/ss macro stuff" and it will still work, even if SS is otherwise disabled. So I made a macro (default UI /m) that calls out "/ss macro battlecry" to put a button on my action bar which I click at times like that during city raids.
- #46
Ayiano Fri, 29 Jan 2010 00:35:55Love the addon, and like below, replaced my old RPHelper too! I love putting RP taunts and quotes in combat....but there's a slight problem I can't figure out.
Most of the stuff is set up for random sayings and set to fire during parties, raids, battlegrounds & Wintergrasp battles, such as a random /emote or saying when I get hit or absorb something, etc. And I simply turn on or turn off SS if I don't want things said. I also use a few things in PvE raids, primarily to let someone know when I cast Power Infusion or Pain Suppression on them. Normally, to prevent chat spamming and non-RP server grouping, I turn off SS outside of WG and PvE raids (where everything is silent except for rezzes and PI/PS).
Problem is, I want to extend those random taunts and sayings into non-WG PvP; primarily city raids that my guild frequently runs; but I don't want to spam those sayings during PvE raids (ICC for example). I have different "/ss macro things you type" for different Combat Events ("I recieve/cause hit, crit, absorb"). I thought if I set each PvP Combat Event ("I recieved PvP White/Yellow damage") to /say for "In a Raid, Raid Officer, & Raid Leader" drop-downs, they would fire off in pvp battles and not in PvE (since I kept Raid, Raid Officer, & Raid Leader silent for PvE Combat Events ("I caused white/yellow damage")). Unfortunately, during a recent assault of Darnassus, none of those events fired, even though I was being attacked by enemy players. I really want to mess with my enemy's heads in city raids. :P
Does it just not work outside of WG & BGs (which I have turned on in case I care to RP in them)? Or am I doing something wrong? Any help would be appreciated.
Sorry for the long post, wanted to make my problem as clear as possible (and not entirely sure I succeeded :P )
- #45
LackeDragon Thu, 21 Jan 2010 10:53:34NICE! I finally found an addon to remplace my buggy RPHelper Thanks, I desesperate to use wow maccro to do RP in combat XD
By the way, it could be a great thing to translate it in french. The RP french community need a lot of addon RP in french, because it finally start to revive in our servor apparently :) So, it could help to not stop this wave xD Thanks again
- #44
rismisner Wed, 06 Jan 2010 04:02:06Ah-ha! That explains it! Thanks for the update. I'm glad you figured it out. I can understand where your confusion came from, and you've got me thinking over ways I could make that more obvious, or easier in some way. My gears are turning... I have a number of planned feature ideas already listed under the Tickets page actually, which I think will help with the situation you ran into (which I find regrettable, and I want to make it better and easier). If you have any other suggestions for improvements, I am always open to new ideas. :)
Thanks for using SpeakinSpell. I hope you continue to enjoy it :)
- #43
rahl66 Tue, 05 Jan 2010 22:43:58I figured it out, divine plea was categorized as both a buff and spell, so it had an entry under the "when I start casting" and the "when I buff myself with". Thanks for the help.
- #42
rismisner Tue, 05 Jan 2010 21:21:56Here is a link to the screenshot of the "What to Say?" area of the "/ss messages" GUI described in my previous post below: http://www.wowace.com/addons/speakinspell/images/29-what-to-say/
- #41
rismisner Tue, 05 Jan 2010 21:18:46OK hmmm... it's hard to explain something I think is obvious, so this is probably going to get unnecessarily wordy...
That much I think you got already, but I'm just making sure we're on the same page. Now...
Does that explanation fix your issue? If you're still having trouble, we could talk more about the Read-Only checkboxes if that's confusing you or causing you a problem, or you may have discovered a bug I was not aware of (because all of this works fine for me as described above) in which case I'd like to know how far you get through this process and what exactly goes wrong - for example, did you click the delete button for Random Speech 1, but the button had no effect? or the speech disappeared as expected,but then it came back later?
About this last sentence you wrote... Also, for the pre programmed ones, there is no actual entry for them, in the text box the spells appear to have no speeches entered for them...
"/ss messages" then scroll down to the bottom of the window... scroll way down... If you can't find it after that, make sure the checkbox for "show read-only speeches" is checked/enabled. If you marked the speeches as read-only, and then set it to hide read-only speeches, that would explain why they don't show up. It should not be set like that by default on a fresh install...
If you still can't find it, then something is bugged, and failing. Disable all other addons and try to run SS as the only addon. You may be having a conflict with another addon (?).
Otherwise, along those lines, I was told by someone else that the multi-line edit boxes did not work for them at all, which is what prompted me to add the checkbox that says "use multi-line edit boxes" (somewhere above the Random Speech 1, 2, 3 list, but inside the same larger group box labeled "What to Say?" - it's not in my latest screenshots so I'm describing it from memory). The single-line edit boxes have been reported to be more stable for some users, so that might help you, but I could never reproduce any problem with the multi-line edit boxes to know exactly what's wrong there, or whether this advice even applies to your situation.
Like I said... long wordy post about rambling guesses at your issue... I hope something in there helps. If not, well, we can keep talking about it /shrug.
I'm back from vacation now too, so I'll have time to implement bug fixes, and put out a new version soon too if needed.
- #40
rahl66 Sat, 02 Jan 2010 07:08:54I don't think that I was completely clear with what I needed help on. The mod comes with some funny speeches built in for certain actions. For example: When I use *Divine Plea* it says "Don't let me OOM, if the tank dies again I'll be gkicked" It's funny, but I'd like to use my own speeches. Now for some reason, if I enter my own speech for divine plea, it says mine, AND the pre-programmed one. My question is: Is there any way to delete the pre-programmed speeches for spells, or are we pretty much stuck with them. I've read over the instructions several times and the only thing I can find is that "many class abilities come with pre programmed speeches" and nothing about how to disable/overwrite them. Any help would be appreciated. Also, for the pre programmed ones, there is no actual entry for them, in the text box the spells appear to have no speeches entered for them.
- #39
rismisner Fri, 01 Jan 2010 22:59:24All I can think to tell you is to click Accept after making a change to a speech - there is a little "Accept" button that appears if you have a change entered into one of the Random Speech N boxes. Hitting Enter after typing in a change usually works too. Everything else should be obvious. /shrug.
- #38
rahl66 Wed, 30 Dec 2009 23:44:08Hey guys, just downloaded the add on. I am trying to get rid of the default speeches on some of my abilities, but for some reason, even if I try to add my own speech to the event, it just adds my speech to the default speech that's already there. I'd appreciate some help as I can;t figure out what to do.