Hammer of Justas
----------------
a World of Warcraft add-on for Paladins
by Justas ( paladin (dot) justas (at) gmail (dot) com )
version 0.93
Copyright (c) 2010-18 by Jonathan E. Wright

Summary
--------
Hammer of Justas is a utility add-on for Retribution and Protection paladins, providing:

- Rotation optimization
- A custom Holy Power meter.
- A large Templar's Verdict indicator.
- An Inquisition timer.
- Buff reminders.
- Cooldown reminders.
- Unique rules based on current paladin role (prot or ret).
- A chat ignore system that allows silent and stealth ignoring and keeps ignored messages in a special history that can be viewed later.

All meters and reminder windows are easy to move around (hold control and mouse over, click to drag) so that they can be placed wherever you wish, and easily adjusted for different scenarios (for instance raids vs. PvP).

NOTE: Protection mode is disabled right now because I haven't updated it for BFA.

Usage
-----
When the addon starts the first time, hold control and mouse over the windows in the center. Drag the windows to your desired locations while holding control. You can turn window on and off entirely in the addon settings.

It's a good idea to try a target using a target dummy when deciding where to place the windows.

You can toggle which skills are displayed in the bars in the addon settings. Note this does not affect if they are chosen in the rotation, so you might see rotation gaps if you disable rotation skills. For buffs and other skills that aren't part of the normal rotation, they just won't appear on the skill or buffs bar.

Caveats
-------
I make no claims about the fitness of this add-on for any particular purpose. I only decided to finally release it because some paladins may find it useful. It is unlikely I would put significant effort into adding feature requests, especially minor UI / usability stuff when it can be changed by modifying the .lua file, but comments and suggestions are welcome and you never know.


Features
--------
- Easy-to-move invisible windows (just hold control and mouse over a window to unhide it, then click to drag it anywhere).
- Highly visible holy power meter that can be placed anywhere.
- Highly visible Templar's Verdict indicator that can be placed anywhere and is only visible when you have enough HoPo to use TV.
- Highly visible Inquisition timer that can be placed anywhere and shows the exact time left on Inquisition. As Inquisition gets closer to running out, this window will fade in to become more visible.
- Skills that need to be refreshed are shown on a separate, clickable bar that can be placed anywhere. The add-on is smart enough to only show some of these skills when an enemy is targeted, so that it's not constantly nagging about them in towns, etc.
- Role specific functions for Protection and Retribution. As an example of a Prot specific behavior, when incoming damage is greater than 10% of the paladin's health per second the Avenging Wrath icon will show. When damage is greater than 20% of the paladin's health per second the Guardians of Ancient Kings icon will show.
- A custom chat ignore list. If you add a name to this list you will never get a message from that toon. Received messages from blocked toons are stored in a separate history that you can view at your leisure.
- Interoperable with OmniCC. If OmniCC is not available HoJ will show its own cooldown text in some places, otherwise it will let OmniCC do it.


Using the Ignore List
---------------------
The main reason for the ignore list was so that I could stealth ignore people -- not get any message from them at all, or even a message telling me I had received a message from them, and not have WoW tell them that I was ignoring them. I could not find any other add-on that would do exactly this and still keep a history of the ignored messages for later inspection.

This predates BattleTags and RealID -- it works with toon names only right now.

Commands (always preceded by /hoj):
/hoj ignore <player name>  - ignores the player with the specified name
/hoj add <player name> - same as /ignore
/hoj unignore <player name> - removes the specified player from the ignore list
/hoj remove <player name> - same as /unignore
/hoj list -- lists all player names in the ignore list
/hoj silent -- toggle silent mode, which, when enabled, stops HoJ from printing the "Whisper from <player name> blocked." message. The only way you will know you received a message from a blocked player is by checking the ignore history.
/hoj stealth -- toggles stealth ignore. With stealth ignore on, some innocuous message will be printed when you receive a text from an ignored player (currently something like "Isle of Quel'Danas is under attack!"). /silent will override this behavior. If silent is on you will never see anything when an incoming message arrives.
/hoj history -- show the history of ignored messages since logging on
/hoj clear -- clear the ignore history
/hoj - show command list help

Known Issues
------------
- Protection paladin is disabled. I haven't bothered to fix it for BFA yet.
- There is no Holy support and I have no plans to add it.
- You cannot reliably click on the skill and buff bars in combat. This is because these buttons are set up dynamically based on the current circumstances and some of the functions required to do this are protected in combat. If you haveeverything bound to keys or surfaced on other buttons this shouldn't matter. I am considering just making these bars non-clickable, but it is useful to click them outside of combat (which works reliably).
- You may see one of your blessings on the skill bar if you have some equivalent blessing from another class. I'm not sure if this is an issue with current class buffs, but it used to be in MoP / WoD.
- You may see one of your blessingso on the skill bar if you have it on another player. Probably the best that could be done here is remember when it was cast on someone else and set a timer, but that may be problematic in other ways since certain things can make the buff expire without the addon knowing. If this is annoying you can turn these buffs (or the buffs bar) off in the addon settings.
- If you are running something like the Swatter add-on you might see some very infrequent warnings about protected functions being called in combat. If you do, let me know the circumstances and error you see, preferably with a screenshot of the dialog.
- Can't currently turn off the Templar's Verdict, Holy Power and Inquisition windows. I will add this soon.
- If you happen to bind control to some skill, whoops! -- sorry. You can probably change that in the HammerOfJustas.lua file, too. :)