DESCRIPTION
___________________________________________________________

Have you ever had trouble reading your combat chat? It isn't very configurable. The plain-text combat messages are difficult to scan through quickly. Other MMORPGs offer options to display only the damage, or to summarize your combat in other ways. World of Warcraft doesn't offer this!

Now you CAN configure your combat chat! This is the add-on to do it. HitsMode transforms your combat into really beautiful, super functional, fully colorized, highly configurable text!

Just look at the screenshots, and you'll see the amazing power of HitsMode.

(The name HitsMode comes from EverQuest's wonderful /hitsmode command, which does some of the same things this add-on does.)


LATEST NEWS
___________________________________________________________

HitsMode is now at v2.0 -- a major milestone! HitsMode has grown from a simple numerical display to many text variations in full color in many different windows. Now, with version 2, you have the ability to control everything down to the finest detail. Do you want a separate window that only shows when a monster evades your pet's instant spell damage? Now you can, with the 77+ options now available.


HITSMODE FAQ
___________________________________________________________

Q: Why are there four checkboxes next to everything?
A: That's how you configure multiwindows! An option with four checkboxes is letting you toggle it on and off for each chat window separately. So, to turn Capitalize Text on for only Window 3, just check the third checkbox from the left.

Q: So how do I pick which chat messages to put in which window?
A: Check the checkbox for each window you want the message to appear.

Q: Can one chat message appear in more than one window?
A: Yep. And each window gets it's own formatting.

Q: Can I change the color of the message in each window?
A: No, you can only customize one color per event.

Q: OK, I checked the boxes next to the messages, but they aren't showing up!
A: You have to "enable" the windows. This is done in the Windows tab. Also make sure HitsMode itself is enabled (under the general tab).

Q: The messages are formatted right, but they're all in the same window! What gives?
A: You also need to tell HitsMode which WoW chat window to use for each HitsMode window. WoW supports up to 7 chat windows. #1 is General Chat, and #2 is usually Combat. It's best to pick a window from 3 to 7 for the HitsMode windows. But you can use any of them.

Q: How do I tell it which window to use?
A: Right underneath the "Enable Chat Window X" option, there is a slider. That tells HitsMode which WoW chat window you want to use. I usually count backwards from 7 as I go.

Q: I want to put my combat in one window and my attacker's combat in another. Just tell me how!
A: Here's how to do it:
-- 1. Go to the Windows tab
-- 2. Enable windows 1 and 2, leaving the others disabled
-- 3. Set window 1 to chat window 7, and window 2 to chat window 6
-- 4. Setup the options you'd like for each window. For example, to display both windows in Verbose Mode A, just select the first two checkboxes next to Verbose Mode A.
-- 5. Go to the Events tab
-- 6. Check only the first box next to all the "You" events, and the second box next to all the "Attacker" events. For the rest, pick what you want.

Q: HitsMode won't display anything! Nothing works! (Or, things are behaving strangely.)
A: Your configuration has become corrupted. Press the Load Defaults button. That should clear the problems up.

Q: I've asked HitsMode to remove my scroll buttons. When I die, they come back! What do I do?
A: Until there is a workaround, just open the options window and close it. That'll get em!

Q: I was using 4 chat windows, but now I'm only using 2. When I close the options window, the other two windows don't disappear!
A: HitsMode will NEVER close a chat window for you. You can simply close them yourself. Every time you close the options window, HitsMode puts a "HitsMode is here!" message in each active window. Use that to help you see which windows you're using.

Q: My periodic spell damage (DoTs) don't display!
A: You need to turn on Periodic Damage in WoW's Interface Options window. If you turn this off, it disables it in all add-ons too.

Q: HitsMode won't let me resize my General Chat (window 1) below normal!
A: You are correct. If it did, WoW would crash immediately.

Q: HitsMode lets me turn on all the Verbose Modes at the same time! What does that do?
A: HitsMode will only use one Verbose Mode. It uses them in order, so if you check A and B, you'll get A. Feel free to choose different Verbose Modes for different windows.

Q: I'm still lost!
A: Post on the add-on home page at http://www.curse-gaming.com/mod.php?addid=467 or email me directly at allara.starmist [at] gmail.com.


NEW FAQS FOR VERSION 2.0
___________________________________________________________

Q: I just upgraded to version 2.0, and now I'm getting spammed with all these things I don't want to see!
A: Version 2.0 added a lot of new messages, and they are all turned on by default. For example, now you see a message when you gain a buff, when you kill a monster, and when buffs fade from other people/monsters. You need to go into the Messages tab on the Options window and turn off the ones you don't want to see.

Q: I don't like the default colors.
A: I agree, they could use some work. If anybody comes up with a really good configuration, email me your (compressed) SavedVariables.lua file and I'll put it into a Preset!

Q: HitsMode takes FOREVER to configure the way I like it! It's too hard to get started.
A: You're right! There are 77+ options in HitsMode v2.0. But don't worry, Presets will be coming very soon! These will greatly speed up the configuration process. See the above answer if you make a configuration that you think should be a preset!

Q: When I turn a message off, it doesn't seem to actually turn off. Am I missing something?
A: You've probably found a bug! Email me or post on the home page, and I'll get it fixed right away!

Q: The color I've set for dodge, miss, parry, etc. isn't working!
A: When you're in one of the Verbose Modes, the Verbose Mode color that you've configured overrides the individual messages colors (except for the actual damage amount). If you turn off all Verbose Modes, you'll see the right color for dodge, etc.


ADVANCED MULTIWINDOW USE
___________________________________________________________

Try doing this with HitsMode. It's possible!

- Put your spells and your melee text in the same window. Your spells are in verbose mode, but your melee shows just the damage.
- Your skills with names appear in Window 1, while only the skill damage appears in Window 2.
- All the melee (numbers only) scroll in big numbers up the side of the screen, while the full text of all the combat goes into another window in a smaller size.
- Your hits (number only) are in the first column. Your Attacker's hits (number only) are in the second column. All the skills (verbose mode) are in the third column. (This is how the screenshot is configured.)


WHAT'S NEXT
___________________________________________________________

The next feature I'm working on is programming the chat windows to fade in and out during combat. After that I'm doing presets, then (finally) a full localization.

Coming soon (in order):

- Chat window fading/clearing before and after combat
- Presets
- Full localization


INSTALLATION INSTRUCTIONS
___________________________________________________________

Unzip the HitsMode folder and put it in your AddOns folder.

HitsMode starts out turned on with one window active, so you should see a new chat window pop up when you log in next. Type /hitsmode or /hm to access the options window, where you can configure it. (Or, set a key binding to open the options window.) Hover your mouse over everything, and read the Information window. When in doubt, just experiment or ask other users what settings they use. It's possible to come up with some very powerful combinations.

Versions of HitsMode prior to v1.0 will have their options deleted and reset. From 1.0 on, HitsMode will attempt to migrate your options from one version to the next, so you won't have to reconfigure everything when you upgrade. IF YOU'RE UPGRADING FROM A VERSION PRIOR TO 1.2, YOU NEED TO PRESS THE LOAD DEFAULTS BUTTON.

Questions? Bugs? You can reach me by email directly at allara.starmist [at] gmail.com.


CHANGES
___________________________________________________________

2.0:
- HUGE options upgrade, for a total of 77 configurable options!
- New Verbose Mode C! Looks like: 12 - [You] hit [Wolf]
- Fixed a bug where rested experience wasn't always being displayed
- Added the old kill separator option (happens whenever something dies near you)
- Please read the new FAQs above

1.21: Minor revision that restricts users from resizing Window 1 too small. (Causes a crash.)

1.2:
- ADDED MULTIWINDOW SUPPORT!
- Please press Load Defaults if you're upgrading, or HitsMode won't display anything
- HitsMode is now disabled while you're in the options window (this is necessary)
- HitsMode now adds many more font sizes available from the standard font size menu
- Now you can remove the scroll buttons from HitsMode windows (with NO FrameXML code!)
- Now you can resize the HM windows smaller/larger than normal (with NO FrameXML code!)
- Fixed PvP spam where you could see hostile players fighting other things
- Periodic damage happening to you will now display more information
- Added an unsupported heal over time event

1.1:
- Removed the FrameXML file and the feature it provided
- Added PvP support (introduced some extra spam when hostile players fight other things)

1.0:
- Completely new options system designed to support upcoming features
- Added key binding to show/hide the options window (I use Ctrl-H)
- Versions after v1.0 will migrate your options instead of resetting them
- Added feature to save/load Global settings (to copy from one character to another)
- No parsing changes yet (PvP still disabled, but coming very soon)

Versions prior to 1.0 are only in the HitsMode-Readme file.

0.95a:
- Falling damage displayed under MONSTER MELEE (red)
- Added partial block support (not tested), under PLAYER PARRY
- Fixed the tooltips
- Removed all the HOSTILEPLAYER events - PvP does NOT work now

0.95:
- Added "You gain Mana"
- Added support for monster regenerating health
- Fixed spam problems (HOSTILEPLAYER events were being parsed on accident)
- Disabled all Fades messages (again)
- Fixed bug with "Your (spell) is parried by (mob)."
- Added color for Skill Name

0.94:
- This version spams some unwanted messages
- Color Picker fixed (and improved!)
- Pet name color bug fixed
- Pressing ESC will now close the options window
- Added "(spell) fades from (mob)"
- Added "(mob) gains (spell)"
- Added "(mob)'s (spell) is removed" (thanks Jexx!)

0.93:
- Color Picker does not work in this version
- Now supports myAddOns and Cosmos
- Now *really* supports pets (heals and being hit are in)
- Supports you healing others
- Some periodic damage/buff issues fixed
- The usual parser updates
- Falling damage works

0.92a - One letter changed. Now everything works. T_T
0.92:
- Completely rewrote the parsing and output engines
- Now supports pets (partially)
- Fixed docking and font size bugs
- Now you can put the chat into any window you like
- Brand new options window (pretty!)
- Introduced Verbose Mode B and Short Mode
- Introduced Color Overlays

0.91 - Committed many more fixes to parsing, including the falling damage and periodic heal bugs.
0.90b - Fixed several critical parse bugs.
0.90a - Initial release.