LiteAssist
==========
  - by Xodiv of Proudmoore


This is an addon for the computer game World of Warcraft.


About LiteAssist
----------------

LiteAssist is a very basic addon to replace the standard /assist macro.

It lets you set a unit (a player, pet or NPC) that the mod remembers.

When you push the assist key, it causes you to attack the same thing
as that unit.  That is, it changes your target (what you are attacking)
to be the same as their target.

LiteAssist provides extra key bindings to learn who to assist and to
assist them.  You can (and must to use this addon) set them up via the
WoW Keyboard Options menu.

LiteAssist really is lite. There are no /commands and no fancy GUIs,
just the 3 key bindings.


Installing LiteAssist
---------------------

Unzip the archive file inside the Interface\Addons folder inside
your World of Warcraft installation.  Usually this will mean
the files end up in this directory:

  C:\Program Files\World of Warcraft\Interface\Addons\LiteAssist\


Configuring LiteAssist
----------------------

After entering the World of Warcraft game, go to the Keyboard
Settings menu, scroll down to the LiteAssist section and set the
key bindings.  Then just use the keys to activate the learn and
assist functions.  See below for more details.


Key Bindings
------------

The three key bindings are:

  1. Learn unit to assist from your current target.
  2. Learn unit to assist from whatever your mouse is hovering over.
  3. Assist the previously learned unit (i.e., target its target).

You can find these under the 'LiteAssist' heading in the Keyboard
settings menu.

I use shift-F (learn target), ctrl-F (learn mouseover) and F (assist)
for the three functions.


Notification Messages
---------------------

When learning a new assist a message will pop up in the middle of the
screen to inform you.


Clearing Assist
---------------

Learn assist with no unit targeted/mouseovered to clear the assist. The
assist also starts out cleared before you first learn something.

When the assist is cleared, the assist key will assist your current target,
exactly like WoW's default assist function.  This makes it safe to override
your regular assist key ('F').


Advanced Macro Support
----------------------

When you assist the learned target, LiteAssist is really running a macro
with '/assist PlayerName' in it.

If you create a macro of your own named LiteAssistMacro AND include in it
the text {LiteAssistUnit} (just like that, including the curly brackets),
LiteAssist will use that macro instead with the text {LiteAssistUnit}
replaced with the name of the player you learned.

You can include {LiteAssistUnit} more than once and it will replace
all the occurrences.


Limitations
-----------

Due to Blizzard's disabling of many of the assist functions in WoW 2.0,
you can't learn a new assist or clear the assist in combat. You can
(obviously) still assist the learned unit.


Origins and Thanks
------------------

LiteAssist owes its inspiration to the addon SimpleAssist by Schnoggo.

The Target Frame indicator was inspired by, and the XML code partly
taken from, the addon CC Main Assist.


History
-------

See ChangeLog.txt for details.

