Range Circle

[kpihuss]

RangeCircle 1.0.2 - User Manual

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 or 30 ft.

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

It is not a real 3D ground decal and it does not measure actual world distance.

Warning: As this is not a true 3D ground decal, but a 2D overlay, distances may not be accurate depending on the camera's tilt angle and zoom level. You will need to adjust the ellipses according to your usual camera position for best results.

2. Download
You can Download from Idrinth website

3. Opening the menu

Use:

Code: Select all

/rangecircle menu

Alternative commands:

Code: Select all

/rangecircle config
/rangecircle ui

The alias

Code: Select all

/rc

may work if no other addon is already using it.

4. Basic setup

Recommended first setup:

1. Type

   Code: Select all

   /rangecircle menu

   .
2. Select Ring 1.
3. Choose a preset: 10 ft, 20 ft, 25 ft or 30 ft.
4. Adjust height/depth until the ellipse matches your usual camera angle.
5. Set line thickness to Auto or Thin if the ring is too large or intrusive.
6. Adjust opacity.
7. Lock the overlay.

5. Presets

Current presets:

Code: Select all

10 ft = 380 px radius
20 ft = 720 px radius
25 ft = 900 px radius
30 ft = 1050 px radius
45 ft = 1400 px radius

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

6. Rings

RangeCircle supports up to 3 rings.

You can select the active ring with:

Code: Select all

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

Enable or disable the active ring:

Code: Select all

/rangecircle enable
/rangecircle disable
/rangecircle ringtoggle

Show only the active ring:

Code: Select all

/rangecircle one

Show three default rings:

Code: Select all

/rangecircle three

7. Size controls

Set width and height:

Code: Select all

/rangecircle size 760 287

Set width only:

Code: Select all

/rangecircle width 760

Set height only:

Code: Select all

/rangecircle height 287

Set radius:

Code: Select all

/rangecircle radius 380

Set flatten/depth percentage:

Code: Select all

/rangecircle flatten 38

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

8. Position controls

Unlock the overlay:

Code: Select all

/rangecircle unlock

Lock it again:

Code: Select all

/rangecircle lock

Reset the screen anchor:

Code: Select all

/rangecircle center

Move the full overlay from screen centre:

Code: Select all

/rangecircle move 0 150

Move the active ring inside the overlay:

Code: Select all

/rangecircle offset 0 110

Vertical offset only:

Code: Select all

/rangecircle voffset 110

Horizontal offset only:

Code: Select all

/rangecircle hoffset 0

9. Visual controls

Set opacity:

Code: Select all

/rangecircle alpha 70

Set colour:

Code: Select all

/rangecircle color 80 200 255

Line thickness:

Code: Select all

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

Show or hide helper label:

Code: Select all

/rangecircle label

Show or hide centre dot:

Code: Select all

/rangecircle dot

10. Modes

Screen mode:

Code: Select all

/rangecircle mode screen

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

Self mode:

Code: Select all

/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

Reset all settings:

Code: Select all

/rangecircle reset

Check current status:

Code: Select all

/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.

13. Limitations

RangeCircle cannot draw real ground geometry. It cannot read the camera angle dynamically and cannot measure actual distance in the world.

It is a visual aid designed to improve range awareness, not a precision measurement tool.

14. Tips for Calibrating Ellipses


Go to Altdorf, to the target area, and position yourself at a corner of the chessboard. Each square represents 5 feet.

Set up your camera for your usual playing style, load a distance preset, and adjust it according to your desired depth and width, keeping in mind that each square is 5 feet.



In this picture, you can see two configured ellipses. The blue one, with a 25-foot range, is designed for Martyr's Blessing, and the red one, with a 30-foot area, is for Atone (AOE Detaunt).

Enjoy it!

[Omegus]

Just FYI, it's possible to do this addon with proper 3D projection based on the camera. I made it for someone years ago but have since lost the code. Some tips to remake it:

1) Use https://tools.idrinth.de/addons/compass3d/ as a base (looks like you've already made some changes to it!)
2) Instead of generating 4 points using the cardinal positions, generate points on a circle (simple sin and cos math, google the formulas) around the player in world space. You can add an option to configure the number of point/segments as a performance optimisation
3) Convert those points to screen space as done within Compass3d
4) Draw a bunch of thin line windows between the points to make a ring (the line drawing code from Tether can be used as an example, as to my knowledge Tether is using the improved/faster line calculation code I worked out). If one or both of the points are off the screen then hide that line segment instead.

That should give you everything you need to do this addon "properly"

[lemao]

Does not seem really useful

[Bankei]

Many new players struggle to understand the range of their abilities and how to use them better. Even veterans can struggle with understanding where/how to drop their channeled abilities. This addon is amazing, keep up the great work!

[kpihuss]

Just FYI, it's possible to do this addon with proper 3D projection based on the camera. I made it for someone years ago but have since lost the code. Some tips to remake it:

1) Use https://tools.idrinth.de/addons/compass3d/ as a base (looks like you've already made some changes to it!)
2) Instead of generating 4 points using the cardinal positions, generate points on a circle (simple sin and cos math, google the formulas) around the player in world space. You can add an option to configure the number of point/segments as a performance optimisation
3) Convert those points to screen space as done within Compass3d
4) Draw a bunch of thin line windows between the points to make a ring (the line drawing code from Tether can be used as an example, as to my knowledge Tether is using the improved/faster line calculation code I worked out). If one or both of the points are off the screen then hide that line segment instead.

That should give you everything you need to do this addon "properly"

I got it!!! need fix an issue and i will upload ASAP