Komo Melee Range Ring
=====================

A lightweight range indicator: a ring (or square/diamond/text label) that
sits on your screen and tells you, at a glance, whether your current
target is inside melee range.

It checks range against a spell you choose (the "Range-check spell"
option in settings) -- by default Spear Hand Strike (Monk interrupt),
since that only lands at true melee range. If you're not playing a
Monk, change that option to any melee-range-only ability from your own
class/spec (spell ID or exact spell name both work).

INSTALL
-------
1. Copy the whole "KomoMeleeRing" folder into:
   World of Warcraft\_retail_\Interface\AddOns\
   (so you end up with .../AddOns/KomoMeleeRing/KomoMeleeRing.toc)
2. Restart WoW or reload the UI (/reload) if it's already running.
3. If the addon shows greyed out or "Incompatible" in the AddOns list
   after a patch, either tick "Load out of date AddOns" in
   Options -> AddOns, or let me know your interface number
   (/run print(select(4, GetBuildInfo()))) and I'll update the .toc.

USING IT
--------
The ring appears once you have a target: green(ish) by default when the
target is in melee range, red(ish) when it isn't. Colors, shape, size,
label text, position and the range-check spell are all yours to change.

Slash commands:
  /kmr unlock    - unlock the ring: drag it anywhere on screen, and drag
                    the small grip in its corner to resize it
  /kmr lock      - lock it back down (click-through, out of your way)
  /kmr options   - open the settings window (its own draggable window --
                    click and drag anywhere on it to move it)
  /kmr reset     - reset everything back to defaults
  /kmr           - same as /kmr options

OPTIONS PANEL
-------------
  - Locked / click-through toggle
  - Show when you have no target
  - Only show while in combat
  - Range-check spell (ID or name -- default: Spear Hand Strike)
  - Shape: Circle / Square / Diamond / Text
  - Font (used when Shape = Text) -- cycles through the client's
    built-in fonts: Friz Quadrata, Arial Narrow, Skurri, Morpheus
  - Three self-contained state groups, each bundling its own text,
    color, class-color button, and opacity together: In Range,
    Out of Range, No Target
  - Texture style: Outline / Filled
  - Behavior when out of range: change color / dim / hide entirely
  - Size slider
  - Separate color + opacity pickers for: in-range, out-of-range, and
    no-target states -- each with a "Class" button that instantly sets
    that color to your current class color (see the state groups above)

FILES
-----
KomoMeleeRing.toc    - addon manifest
Core.lua             - the ring frame, drag/resize, range detection
Options.lua          - the in-game settings panel
media/*.tga          - hand-generated shape textures (white silhouettes,
                        tinted at runtime to whatever color you pick)

NOTES
-----
This was written and reasoned through carefully against the current WoW
addon API, but I wasn't able to load it in a live client to test it
before handing it to you. If you hit a Lua error, install BugSack +
BugGrabber (or just note the red error text) and let me know what it
says -- happy to patch it.
