RangeCircle 1.0.2 - User Manual
=================================

Creators: Gingerbel and Kpihuss

1. What is RangeCircle?
-----------------------

RangeCircle is a lightweight visual overlay addon for Return of Reckoning.

It displays one or more configurable range ellipses on your screen. These ellipses are intended to approximate ground range areas such as 10 ft, 20 ft, 25 ft, 30 ft or 45 ft.

The addon is mainly useful for aura awareness, guard positioning, short-range abilities and general spacing in RvR or scenarios.

Important: RangeCircle is not a real 3D ground decal. It does not draw world geometry and it does not measure actual world distance. It is a calibrated screen-space overlay.

2. Installation
---------------

Extract the RangeCircle folder into:

Warhammer Online - Age of Reckoning\Interface\AddOns\RangeCircle

The final structure should look like this:

Interface\AddOns\RangeCircle\RangeCircle.mod
Interface\AddOns\RangeCircle\RangeCircle.lua
Interface\AddOns\RangeCircle\RangeCircle.xml
Interface\AddOns\RangeCircle\README.txt
Interface\AddOns\RangeCircle\MANUAL.txt
Interface\AddOns\RangeCircle\textures\ring.dds
Interface\AddOns\RangeCircle\textures\ring_thin.dds
Interface\AddOns\RangeCircle\textures\ring_normal.dds
Interface\AddOns\RangeCircle\textures\ring_bold.dds
Interface\AddOns\RangeCircle\textures\dot.dds

Restart the game or reload the UI.

RangeCircle requires LibSlash for slash commands.

3. Opening the menu
-------------------

Recommended command:

/rangecircle menu

Alternative commands:

/rangecircle config
/rangecircle ui

The shorter alias /rc is attempted, but it may conflict with other addons.

4. Recommended first setup
--------------------------

1. Type: /rangecircle menu
2. Select Ring 1.
3. Choose a preset: 10 ft, 20 ft, 25 ft, 30 ft or 45 ft.
4. Adjust Height/Depth until the ellipse matches your usual camera angle.
5. Use Auto or Thin line thickness for large rings.
6. Adjust opacity if the overlay is too visible.
7. Lock the overlay once it is positioned correctly.

RangeCircle works best if you keep a consistent camera zoom and camera angle.

5. Presets
----------

Current calibration presets:

10 ft = 380 px radius = 760 px diameter
20 ft = 720 px radius = 1440 px diameter
25 ft = 900 px radius = 1800 px diameter
30 ft = 1050 px radius = 2100 px diameter
45 ft = 1400 px radius = 2800 px width/diameter

These are visual calibration values, not real internal game measurements.

6. Ring system
--------------

RangeCircle supports up to 3 rings at the same time.

Select the active ring:

/rangecircle ring 1
/rangecircle ring 2
/rangecircle ring 3

Enable or disable the active ring:

/rangecircle enable
/rangecircle disable
/rangecircle ringtoggle

Show only the active ring:

/rangecircle one

Show three default rings:

/rangecircle three

7. Size and depth controls
--------------------------

Apply a preset:

/rangecircle preset 10
/rangecircle preset 20
/rangecircle preset 25
/rangecircle preset 30
/rangecircle preset 45

Set size manually:

/rangecircle size 760 287

Set width only:

/rangecircle width 760

Set height only:

/rangecircle height 287

Set radius:

/rangecircle radius 380

Set flatten/depth percentage:

/rangecircle flatten 38

Lower flatten values make the ellipse flatter. Higher values make it rounder.

8. Position controls
--------------------

Unlock the overlay:

/rangecircle unlock

Lock it again:

/rangecircle lock

Reset the screen anchor:

/rangecircle center

Move the full overlay from screen centre:

/rangecircle move 0 150

Move the active ring inside the overlay:

/rangecircle offset 0 110

Vertical offset only:

/rangecircle voffset 110

Horizontal offset only:

/rangecircle hoffset 0

9. Visual controls
------------------

Set opacity:

/rangecircle alpha 70

Set colour:

/rangecircle color 80 200 255

Line thickness:

/rangecircle line auto
/rangecircle line thin
/rangecircle line normal
/rangecircle line bold

Recommended setting for large rings:

/rangecircle line auto

If the ring still covers too much of the screen:

/rangecircle line thin

Show or hide helper label:

/rangecircle label

Show or hide centre dot:

/rangecircle dot

10. Modes
---------

Screen mode:

/rangecircle mode screen

This is the recommended mode. The ellipse stays fixed on your screen and can be calibrated to your camera.

Self mode:

/rangecircle mode self

This experimental mode attempts to attach the overlay to your character object, similar to how player markers work. It still remains a 2D overlay and is not a real ground decal.

11. Reset and status
--------------------

Reset all settings:

/rangecircle reset

Check current status:

/rangecircle status

12. Best practices
------------------

- Use a consistent camera zoom and angle.
- Calibrate the ellipse once for your usual RvR camera.
- Use Auto or Thin line thickness for large ranges.
- Use lower opacity when running several rings.
- Use different colours for different rings.
- Treat RangeCircle as a positioning aid, not as exact measurement.

13. Limitations
---------------

RangeCircle cannot draw real ground geometry.

RangeCircle cannot dynamically read the camera angle.

RangeCircle cannot measure actual distance in the world.

The visual match changes if you heavily change camera zoom or camera pitch.

14. Credits
-----------

Creators: Gingerbel and Kpihuss

Thanks to the RoR addon community and existing addons that demonstrated useful UI and marker techniques.
