Cursor Arcs

CursorArcs — Arc-Shaped Timers Around Your Cursor

CursorArcs displays customizable arc-shaped timers that follow your cursor (or sit at a fixed screen position). Track your GCD, spell casts, cooldowns, buffs, and more — all rendered with World of Warcraft's native cast bar textures for a polished, integrated look.

Every ring is fully configurable: radius, thickness, arc span, colors, direction, and more. Create as many rings as you want and arrange them however you like.

Ring Types

Each ring is tied to a data source that drives its fill animation:

• GCD — Tracks your Global Cooldown in real time.
• Cast — Shows spell cast and channel progress with optional completion flash and fade animations.
• Spell CD — Displays the cooldown of a specific spell. Supports multi-charge spells (e.g. Fire Blast, Chi Torpedo) with separate sub-arcs per charge.
• Buff — Monitors a buff or debuff timer. Supports multi-stack buffs with sub-arcs per stack.
• Static — A decorative ring with no data source — always full. Great for visual borders or cosmetic layering.

Geometry & Positioning

• Radius — Distance from the anchor point to the ring (10–200 px).
• Thickness — Width of the arc stroke (1–30 px).
• Arc Span — How much of the circle the ring covers (0–360°). A full 360° ring, a 180° half-circle, a small 45° notch — your choice.
• Start Angle — Where the arc begins (0° = 12 o'clock, increases clockwise).
• X / Y Offset — Shift each ring independently from the anchor point.
• Anchor Mode — Rings can follow your cursor or be locked to a fixed screen position.

Visual Customization

Rings use WoW's modern cast bar atlas textures, desaturated and re-colored with your chosen tint. This gives every ring a 3D, polished look that blends seamlessly with the default UI.

• Fill Color — Full RGBA color picker for the active fill.
• Show Track — Toggle the background (empty) portion of the ring on or off.
• Track Opacity — Control how visible the background ring is.
• Spark — A glowing indicator at the leading edge of the fill.
• Glow — Optional glow effect with adjustable radius.

Multi-Charge / Multi-Stack Colors

For Spell CD rings with multi-charge spells, you get additional color options:

• Partial Charges Color — Tint when at least one charge is available but not all.
• All Charges Color — Tint when every charge is ready.

Each charge gets its own sub-arc section with independent texture edges, so you can visually distinguish individual charges at a glance.

Animation

• Fill Direction — Clockwise or counter-clockwise.
• Fill Mode — Drain (starts full, empties as time passes) or Fill (starts empty, fills up).
• Smooth Interpolation — Enable frame-by-frame smoothing so the fill glides instead of jumping.

Cast Bar Animations (Cast rings only)

• Success Flash — A bright green pulse when a cast completes.
• Failure Flash — A red pulse when a cast is interrupted or fails.
• Fade Out — The ring gracefully fades after cast completion.

Visibility Controls

• Show in Combat / Out of Combat — Per-ring toggles.
• Combat Opacity / OOC Opacity — Separate alpha values for each state.
• Hide When Spell Ready (Spell CD) — Automatically hide the ring when the spell is off cooldown.
• Show Full When Ready (Spell CD) — Display a fully filled ring instead of hiding it.
• Hide When Buff Inactive (Buff / Cast) — Only show the ring when a buff is active or a cast is in progress.

Profile System

Save and swap between complete configuration sets:

• Multiple Profiles — Create as many profiles as you need.
• Per-Spec Binding — Automatically switch profiles when you change talent specialization.
• Copy From — Duplicate an existing profile as a starting point.
• Import / Export — Share your setup with others by pasting a profile string.

Settings Panel

A clean, built-in settings window with:

• Live Editing — Every change applies instantly. No "Apply" button needed.
• Spell Search — Type a spell name or ID and pick from an autocomplete dropdown with icons. Powered by a background spell cache that scans hundreds of thousands of spells.
• Color Pickers — Native WoW color picker with opacity support.
• Dropdown Menus — Clean selection for ring type, direction, fill mode, and more.
• Ring Management — Add, delete, enable/disable, and reorder rings from the left navigation panel.

Slash Commands

/ca or /cursorarcs

• /ca — Open settings panel
• /ca show / /ca hide / /ca toggle — Control ring visibility
• /ca profile <name> — Switch to a named profile
• /ca reset confirm — Reset all settings to defaults

Default Rings

CursorArcs ships with four pre-configured rings to get you started:

1. GCD Ring — 360° circle, radius 36
2. Cast Bar — 270° arc, radius 50, with cast completion animations
3. Spell CD — 270° arc, radius 50, hidden when spell is ready
4. Decorative — 360° static ring, radius 78, subtle background accent

All four are fully editable. Delete the ones you don't need, or add more.

Technical Details

• Rendered using WoW's SetVertexOffset trapezoid technique with ~12° segments for smooth arcs.
• Uses modern atlas textures (ui-castingbar-filling-standard, ui-castingbar-background) with 8-parameter UV mapping.
• Fill textures are desaturated then vertex-colored, preserving the 3D gradient shading while allowing any fill color.
• Efficient per-frame updates with geometry caching and change detection.
• Lightweight — minimal CPU overhead even with multiple rings active.

Feedback, bug reports, and feature requests are welcome in the comments!