Range Circle

[kpihuss]

RangeCircle 1.2.6 - Projected Range Overlay for Return of Reckoning

A lightweight visual helper to display projected range circles around your character.

Hi everyone,

We are releasing RangeCircle, a small UI addon for Return of Reckoning.

RangeCircle displays projected range circles around your character to help estimate distances such as aura range, guard range, short-range ability range and general positioning zones.

Download from https://tools.idrinth.de/addons/range-circle/

Unlike the earlier test versions, this release no longer uses a fixed 2D ellipse. RangeCircle now uses a projected circle system: it calculates a real horizontal circle around your character and projects the points to the screen. This means the shape adapts much better when you rotate or tilt the camera.

Important note: this is still not a true 3D ground decal. RoR addons cannot draw real terrain decals. RangeCircle uses projected UI points placed on screen from world-space calculations. It is a visual helper, not an official internal range-measuring tool.

Main features

• Projected range circles using world-to-screen projection.
• Camera-aware visual shape: the circle adapts much better when rotating the camera.
• Up to 3 active rings at the same time.
• Range presets:
  • 10 ft
  • 20 ft
  • 25 ft
  • 30 ft
  • 40 ft
  • 45 ft
• Custom range support in feet.
• In-game configuration menu.
• Nudge controls to fine-tune screen alignment.
• Ground height / Z offset calibration.
• Point size control.
• Opacity control.
• Quality presets: Low / Normal / High.
• Multiple colour presets.
• Default ranges button to restore the standard ring setup.

Creators

Gingerbel & Kpihuss

Installation

Extract the addon into:

Code: Select all

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

The folder structure should look like this:

Code: Select all

Interface\AddOns\RangeCircle\RangeCircle.mod
Interface\AddOns\RangeCircle\RangeCircle.lua
Interface\AddOns\RangeCircle\RangeCircle.xml
Interface\AddOns\RangeCircle\RangeCircleCamera.lua
Interface\AddOns\RangeCircle\RangeCircleZoneData.lua
Interface\AddOns\RangeCircle\textures\dot.dds

The addon requires LibSlash.

After installation, restart the game or reload the UI.

Opening the menu

Use:

Code: Select all

/rangecircle menu

Alternative commands:

Code: Select all

/rangecircle config
/rangecircle ui

The short alias

Code: Select all

/rc

may work, but it can conflict with other addons, so

Code: Select all

/rangecircle

is recommended.

Recommended first setup

After installing the addon:

1. Open the menu with:

   Code: Select all

   /rangecircle menu

2. Select Ring 1, Ring 2 or Ring 3.
3. Choose a range preset.
4. Set the quality to Normal or High.
5. Adjust point size if the circle is hard to see.
6. Use nudge controls if the circle is always slightly off-centre.
7. Use Z offset calibration if the circle shifts when rotating the camera.

Recommended starting calibration:

Code: Select all

/rangecircle zoffset 4

Default rings

The default ring setup is:

Code: Select all

Ring 1 = 20 ft
Ring 2 = 30 ft
Ring 3 = 10 ft

You can restore these default ranges with:

Code: Select all

/rangecircle defaultranges

Or by using the Default ranges button in the menu.

Range presets

Available presets:

Code: Select all

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

These apply to the currently selected active ring.

Custom range values

You can also set custom ranges in feet:

Code: Select all

/rangecircle range 17.5
/rangecircle feet 17.5
/rangecircle radius 17.5

Example:

Code: Select all

/rangecircle ring 1
/rangecircle range 35

This sets Ring 1 to 35 ft.

The menu also includes range adjustment buttons:

Code: Select all

Range -1 ft
Range +1 ft

Calibration guide

RangeCircle has two different types of alignment adjustment:

1. Nudge

Use nudge if the whole circle is always offset in the same direction on your screen.

Example:

Code: Select all

/rangecircle nudge 20 0

This moves the projected circle 20 pixels to the right.

Useful commands:

Code: Select all

/rangecircle nudge 10 0
/rangecircle nudge -10 0
/rangecircle nudge 0 10
/rangecircle nudge 0 -10

Use:

Code: Select all

/rangecircle center

to reset the screen offset.

2. Z offset / ground height

Use Z offset if the circle appears to move or slide over the ground when you rotate or tilt the camera while your character does not move.

Recommended starting value:

Code: Select all

/rangecircle zoffset 4

If the ring shifts when changing the camera angle, try small changes:

Code: Select all

/rangecircle zoffset 3
/rangecircle zoffset 4
/rangecircle zoffset 5

Rule of thumb:

• If the circle is always displaced in the same direction, use nudge.
• If the circle changes position relative to the ground when rotating the camera, adjust zoffset.

A flat area with visible floor tiles is ideal for calibration. In our tests, using a floor where each tile represents approximately 5 ft made it much easier to compare 10 ft, 20 ft, 25 ft, 30 ft, 40 ft and 45 ft circles.

Quality settings

RangeCircle can draw more or fewer points depending on quality.

Code: Select all

/rangecircle quality low
/rangecircle quality normal
/rangecircle quality high

Recommended:

• Low: better performance.
• Normal: good default.
• High: smoother circles, better for screenshots or calibration.

If large circles have visible gaps, use:

Code: Select all

/rangecircle quality high

Point size

If the points are too small or too large:

Code: Select all

/rangecircle pointsize 16
/rangecircle pointsize 20
/rangecircle pointsize 24

The menu also includes point size buttons.

Opacity

Adjust opacity with:

Code: Select all

/rangecircle alpha 70

Examples:

Code: Select all

/rangecircle alpha 50
/rangecircle alpha 80
/rangecircle alpha 100

Colours

You can select colours from the menu, or set RGB values manually:

Code: Select all

/rangecircle color 80 200 255

Available menu colour presets include:

• Blue
• Green
• Yellow
• Red
• White
• Cyan
• Purple
• Orange
• Pink
• Lime

Ring controls

Select active ring:

Code: Select all

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

Enable or disable the selected ring:

Code: Select all

/rangecircle enable
/rangecircle disable
/rangecircle ringtoggle

Show only the selected ring:

Code: Select all

/rangecircle one

Enable the standard three-ring layout:

Code: Select all

/rangecircle three

Restore default ranges:

Code: Select all

/rangecircle defaultranges

Show / hide

Code: Select all

/rangecircle show
/rangecircle hide
/rangecircle toggle

Status and reset

Show current settings:

Code: Select all

/rangecircle status

Reset all settings:

Code: Select all

/rangecircle reset

Resetting all settings is different from

Code: Select all

/rangecircle defaultranges

. Reset all restores the whole addon configuration. Default ranges only restores the standard ring ranges.

What RangeCircle can do

• Help estimate range visually.
• Help with aura positioning.
• Help tanks and healers understand spacing.
• Display multiple projected range circles at once.
• Adapt the projected circle shape when rotating the camera.
• Provide custom ranges in feet.

What RangeCircle cannot do

• It cannot draw a true 3D terrain decal.
• It cannot read the exact game ability range internally.
• It cannot perfectly follow uneven terrain, slopes or stairs.
• It cannot guarantee official distance accuracy in every situation.
• It still needs calibration for your camera, UI scale and character position.

Known limitations

RangeCircle projects points around the player using world-to-screen logic. This gives a much better result than a static 2D ellipse, but it is still an addon overlay.

On uneven terrain, stairs, bridges or sharp slopes, the circle may not perfectly match the ground because the addon is not reading the exact terrain height for every point.

For best results, calibrate on flat ground and keep your usual RvR camera angle.

Suggested uses

• Aura range reference.
• Guard and defensive positioning.
• Short-range ability awareness.
• Warband spacing.
• Scenario positioning.
• Learning distance awareness.
• Testing ability ranges in controlled areas.

Version 1.2.6 notes

• Projection-only version.
• Static 2D ellipse mode removed.
• Preset ranges: 10 / 20 / 25 / 30 / 40 / 45 ft.
• Custom range command added.
• Default ranges button and command added.
• Improved colour selection.
• Improved menu organisation.
• Recommended Z offset calibration: 4.

Feedback wanted

Feedback is welcome, especially regarding:

• Range calibration accuracy.
• Z offset calibration.
• Point distribution on large circles.
• Performance in RvR.
• Menu usability.
• Better default ring setups for different roles.

If you report a calibration issue, please include:

• Screenshot with the ring visible.
• Your selected range.
• Your Z offset.
• Your camera angle.
• Whether the issue happens on flat ground or uneven terrain.

[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

[kpihuss]

Updated original post with the 1.2.6 addon with 3d projection

[Omegus]

Updated original post with the 1.2.6 addon with 3d projection

That was quick! Nicely done . I've found the old demo project I made for drawing lines between points which might help speed things up rather than trying to work through the code in Tether/GuardPack. The code in this demo is what was then used by Sulle to speed up the lines in that pack so it's pretty efficient and also handles most (all?) UI scaling issues. I'll send you the link via DM.