Eloquence is a chat mod which attempts to filter as much of the stupidity out of the chat window as it can. PLEASE READ THE FULL DESCRIPTION, IT WILL ANSWER MOST QUESTIONS YOU MIGHT HAVE.
June 20 '09
UPDATE: Guess I spoke too soon. There is more than one code that controls the filter's link skip abilities. Still working on it. I actually went and spent the 40 bucks on the World of Warcraft Programming book lol, so I am serious about getting this fixed and maybe even recoded someday. I'm trying really hard to fix this at the same time I update for the next patch. Not promising anything though. I'm still trying to figure out what the undescribed variables actually are so that I'll better understand how the function works.
Also, I've been adding things to the spam filters . I've added stuff like an*l, lolumad(for any Sargeras Alliance players XD), Sulfuron Ingot and Thunderfury to the spam filters, the last 2 mainly cause 100% of the time I've seen them in chat it's being spammed. Been fiddling with the classcolor/level codes. I've (hopefully) managed to get them straightened out, I haven't had any "DKs not filtering correctly" issues with my copy. Thanks to everyone for being patient with me!
-----
CURRENT RELEASE: In my own testing all characters EXCEPT DEATH KNIGHTS are being caught and filtered correctly, up to level 80 :) *I should note that the DKs actual chat is being filtered, just for some reason at the moment Elo will not always update the level/class color for them, at least in my testing. I don't know why* Now, for you RP players, the update to the level cap SHOULD correct the dialect problems. If not, please feel free to notify me here and I'll see what I can do to fix that.
I'm still working on the Profession and Achievement link "bug". So far the only way I've gotten it to work is to add all the profession names (including specialization names such as Transmutation Master) and the word achievement into the Elo Skipword category detailed at the bottom of this description.
It should be noted that this is still NOT, I repeat NOT a FULLY functional version. I have updated the TOC file and fixed the XML so the addon stops throwing errors. I've even added in most, I repeat MOST of the Northrend abbreviations, the ones that were easiest to get done anyway. Certain ones such as AN for Azjol Nerub or UP for Utgarde Pinnacle I haven't quite figured out how to get to work only when in LFG context as yet. /Shrug I'm working with heirloom code here, and I'm still fairly new to Lua, sorry.
I welcome anyone that can/wants to help me with any of these issues to contact me here. Just please keep in mind, I do play, I do have a life, and this isn't the only project I'm working on. I will do what I can to keep this as functional as it currently is and work on bringing it to fully functional status, if possible. Thank you and enjoy.
________________________________
What Is It?
Eloquence is a linguistic mod that gives you control over communication. You can apply different levels of chat filters for yourself and others, trim long messages into clickable links, modify channel headers, apply colors to players' names, and manage spam in lots of ways.
I. Filters
Eloquence's biggest feature is the selectable filter settings. Anyone can appreciate its spell-checking and caps-squashing filters, while roleplayers will enjoy the various dialects. You can filter your own chat to other players, or you can keep your filtered experience totally private.
AVAILABLE FILTERS
Spell Book
The most basic yet important filter. Corrects common spelling and grammatical errors, reduces out-of-control repetition, and keeps people from shouting with all caps.
Decompression Engine
Expands Warcraft and MMO acronyms. Translates cryptic expressions like "288 lw lfw!" and "LF1M SMA PREF TANK!!!" into plain English
Emote Whiz
Verbalizes smilies, emoticons, and other ideogrammatic expressions.
Mouthwash
Replaces profanity and offensive words with more acceptable euphemisms.
Fantasy Writer
Rewrites many modern, out-of-character expressions with those found in fantasy literature.
Dialectician
Each speaker will speak in an accent or dialect based on his or her race. Eloquence detects player's races through a variety of means, but sometimes this isn't possible. Players of an unknown race are filtered using Fantasy Writer.
ALLIANCE DIALECTS
Human: In-character speech with some phrases like "King's honor, friend."
Dwarf: Everything's in Scots! "Ah'm no' shuir if that wull wirk, laddie."
Night Elf: Some Darnassian like "Asha'falah" and slightly formal language (few contractions).
Gnome: Quirky, brainy vocabulary and folksy cliches.
Draenei: Few contractions and some Draenei words.
HORDE DIALECTS
Orc: A few Orcish words and phrases like "Lok'tar" and "Zug zug".
Tauren: Formal language with some race-specific sayings like "Winds be at your back!"
Troll: Thick Jamaican basilectic patois with some Trollish like "Tas'dingo!"
Undead: A slight hiss that intensifies when they get excited. Several Forsaken sayings.
Blood Elf: Proud and cocky, with some phrases in Thelassian.
II. Chat Links
Eloquence offers two styles of Clickable Chat Links that trims long messages and tags them at the end. Clicking them will reveal the original (long) message. This way you can keep enchanters and guild recruiters from clogging your chat window! (Due to the way links are handled, it doesn't work on messages that contain linked items).
III. Headers
a. Eloquence can shorten common channel headers like "[1. General]" into a number "[4.]" or letter "[G.]". Several display styles are available.
b. Eloquence can color players' names based on their class and add their level, if Eloquence knows them. You can have players whose classes are unknown are assigned a random color if you wish. Eloquence can also color player's names inside chat messages for easy recognition.
IV. Display Options
Eloquence features multiple miscellaneous display options to give you more control over what you see in your chat window. The options window has checkboxes for suppressing chat spam, duel announcements, drunk/sober messages, coin spam, brackets, and PvP ranks.
V. Player Data
Some features need Eloquence to know something about a player speaking. These are the race-specific Level 4 filter and the "Names of Known Players" setting. If these options are enabled, Eloquence will passively gather info on your friends, party/raid/guild members, and players you mouse-over. You can also have Eloquence actively gather data when you change zones and talk to NPCs. A slider lets you choose how long to keep data. You can see how many player entries Eloquence has gathered, and purge the list if you wish.
VI. Text Commands
You can apply custom filters. For example, typing "/elo add gz = grats" (without quotes) will tell Eloquence to turn "gz" (as a whole word) into "grats". Custom filters are applied before Eloquence's are, so you can override the defaults this way too. For example, type "/elo add woot = woot" to keep Eloquence from altering the word "woot".
You can tell Eloquence to not filter certain players or channels. Type "/elo skip Thrakzor" (without quotes) to let Thrakzor's chat appear normally. Type "/elo channel Addon" to keep the custom channel "Addon" from being filtered at all.
You can also tell Eloquence to skip specific words. Type "/elo skipword (X)" (without quotes) to let any chat with word X appear unfiltered. EX: "/elo skipword achievement" will tell Eloquence NOT to filter any messages that appear in the chat frame with the word achievement in them. You will have to do this for every toon you have for now, I will work on getting profiles into the code in the future
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)...
