NOTICE
I am aware there is a bug with deleting custom replacements, and a bug with some of the in-built replacements, but i'm currently working on a major update for this addon.
Description
EasyChat is an addon which adds more replacements to the chat system (like the "%t" one which is replaced for your target's name upon sending the message). EasyChat also allows the user to add their own custom replacement texts which work in exactly the same way.
Command List
"/ec help" - Shows this list of commands in-game.
"/ec enable" - Enables text replacement.
"/ec disable" - Disables text replacement.
"/ec toggle" - Toggles text replacement.
"/ec version" - Displays the version of the EasyChat addon you're using.
"/ec add <text> <message>" - Adds a custom text replacement ("/ec add test hello this is a test" would replace "%test" for "hello this is a test" whenever you type it in a message).
"/ec del <text>" - Deletes a custom text replacement ("/ec del test" would delete the "%test" replacement).
"/ec clear" - Deletes all custom replacements you have created.
"/ec view <text>" - Displays the message which is shown for the replacement called <text>. ("/ec view test" would show the message which EasyChat replaces "%test" for).
"/ec gadd <text> <message>" - Adds a global custom text replacement ("/ec gadd test hello this is a test" would replace "%test" for "hello this is a test" whenever you type it in a message if there is no individual replacement for "%test").
"/ec gdel <text>" - Deletes a global custom text replacement ("/ec gdel test" would delete the "%test" global replacement).
"/ec gclear" - Deletes all global custom replacements you have created.
"/ec gview <text>" - Displays the message which is shown for the global replacement called <text>. ("/ec gview test" would show the global message which EasyChat replaces "%test" for).
In-Built Replacements
General
"%s" - Replaces this for your character's name.
"%tt" - Replaces this for your target's target.
Pet
"%p" - Replaces this with your pet's name.
"%pt" - Replaces this with your pet's current target.
Focus
"%f" - Replaces this with your current focus.
"%ft" - Replaces this with your current focus's target.
Mouseover
"%m" - Replaces this with the name of the person/npc your mouse is currently over.
"%mt" - Replaces this with the target of the person/npc your mouse is currently over.
Party
"%p#" - Replaces this with the name of party member # (replace # with the number).
"%p#t" - Replaces this with the target of party member # (replace # with the number).
"%pp#" - Replaces this with the party member # pet name (replace # with the number).
"%pp#t" - Replaces this with the target of party member # pet (replace # with the number).
Raid
"%r#" - Same as party replacement, but for raid instead.
"%r#t" - Same as party replacement, but for raid instead.
"%rp#" - Same as party replacement, but for raid instead.
"%rp#t" - Same as party replacement, but for raid instead.
How It Works
Whenever you type a message, if you type "%" followed by the name of your custom replacement, EasyChat will replace "%" plus the word for the message stored.
When enabling/disabling EasyChat with "/ec enable/disable/toggle", the state of EasyChat is saved on that character (this means you may have EasyChat enabled on one character, and not on another). By Default, EasyChat is enabled on all characters.
Custom replacements ("/ec add/del/clear/view") are stored on each individual character. Global custom replacements on the other hand are stored across all your characters on that account. EasyChat will check if your characters have a custom replacement before checking global. It will only resort to a global replacement if no individual replacement is found (this means individual custom replacements override global ones).
If you add a custom (or global) replacement that has the same <text> as one of EasyChat's inbuilt replacements, then the custom replacement will take priority (inbuilt replacement will be ignored). You can easily use the inbuilt replacements again by deleting the custom replacement which has the same name as the inbuilt replacement you wish to use.
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)...
