EZOCursor

Beta addon for The Elder Scrolls Online that adds cursor-centered HUD aids from the EZO addon family.

¿Prefieres español? Lee el README en español. Support, bug reports, and suggestions: https://discord.gg/ekw8zUAcRm

Beta Status

EZOCursor is in public beta. The current scope is intentionally focused: it adds visual reticle, guide-line, block, and debug aids. It does not automate gameplay, input, targeting, combat decisions, or addon management.

Requirements

• The Elder Scrolls Online PC client.
• LibAddonMenu-2.0.
• Optional: LibChatMessage for cleaner addon chat output when available.
• Optional: EZOCore for the central Settings > EZO panel and shared language mode.
• An ESO API version supported by EZOCursor.txt.

Current manifest metadata:

• Addon version: 0.1.26
• AddOnVersion: 10026
• APIVersion: 101049 101050

Installation

1. Download or clone this repository.
2. Copy the EZOCursor folder into your ESO AddOns directory:
   • Live: Documents\Elder Scrolls Online\live\AddOns\EZOCursor
   • PTS: Documents\Elder Scrolls Online\pts\AddOns\EZOCursor
3. Install or enable LibAddonMenu-2.0.
4. Start ESO or run /reloadui.
5. Enable EZOCursor in the ESO Add-Ons menu.

Implemented Features

• Optional replacement of the base ESO reticle texture with ESO's circular reticle texture.
• A center target indicator and outer full-screen horizontal and vertical guide lines.
• Target and combat information use separate visual areas with no overlapping pixels:
  • the 64 px center cross shows the configured targetability color: no attackable target or attackable target
  • a separate blue marker surrounds the center cross whenever ESO reports a manually selected camera-preferred target through IsGameCameraPreferredTargetValid()
  • outside combat, visible outer lines use the same target color as the center
  • in combat, the outer lines use the configured combat color while the center continues to show target state
  • combat damage briefly flashes the outer lines with the configured recent-damage color for 600 ms
  • all segments use a neutral white source texture so the displayed tint matches the selected LibAddonMenu color
• HUD/HUD UI scene integration for visual overlays.
• Block shield overlay shown only when active blocking is detected.
• Low-stamina block warning when current stamina is below five times the Advanced Stats Block Cost.
• Debug panel for validating cursor, combat, block, stamina, and HUD scene state.
• English and Spanish localization.
• SavedVariables migration for older guide-color keys.

Settings Panel

EZOCursor registers its complete settings panel in Settings > EZO when EZOCore is available. Without EZOCore, the same controls remain available through the standard LibAddonMenu addon settings list.

Current visible options:

• Purple informational section headers with a 26 px info icon.
• General section help is attached to each section header tooltip.
• Field-specific help is attached to the tooltip of each control.
• Enable or disable the center indicator and outer screen guides together.
• Choose when the outer guide lines are shown; the center target indicator remains visible while cursor guides are enabled:
  • always
  • only in combat
• Enable or disable the cursor state debug panel.
• The debug panel follows its own visible setting and remains available even if an internal reticle master flag is disabled.
• Configure targetability colors used by the center indicator and, outside combat, by visible outer lines, plus the separate camera-preferred marker color:
  • no attackable target
  • attackable target
  • camera-preferred marker
• Configure combat colors used by the outer lines:
  • in combat
  • brief recent-combat-damage flash

Some internal/default reticle settings exist in SavedVariables, such as enabled, blockIndicatorEnabled, useCircularReticle, and idleAlpha, but they are not exposed as LibAddonMenu controls in the current beta.

State and Safety Limits

• camera-preferred marker uses ESO's IsGameCameraPreferredTargetValid() signal and is drawn separately from the targetability color. It does not guarantee exact target identity, attackability, or melee range.
• Attackable target state uses ESO attackability signals for reticleover; it is not a range check. The center indicator exposes target state independently from the outer combat colors.
• Recent combat damage follows real combat events involving the player. Each accepted event restarts the 600 ms outer-line flash.
• The block warning uses current stamina and Advanced Stats Block Cost; it is an alert threshold, not a prediction of every incoming hit.
• Visual controls are intended to appear only in normal HUD and HUD UI scenes.
• EZOCursor does not automate combat, movement, targeting, input, keybinds, blocking, attacks, menu navigation, or vanilla UI actions.
• EZOCursor does not publish to Discord, call webhooks, run external workflows, or send telemetry.

Recommended Testing

Please test these scenarios during beta:

• Login and /reloadui without Lua errors.
• Open EZOCursor from Settings > EZO, or from the LibAddonMenu fallback when EZOCore is disabled.
• Enable and disable the center indicator and outer guide lines together.
• Switch outer-guide mode between Always and In combat; confirm the center indicator remains visible in both modes.
• Change each target and combat color and confirm the corresponding visual area updates.
• Confirm each settings section shows the purple info icon and opens its general tooltip on hover.
• Confirm field-specific tooltips open from their controls.
• Outside combat, aim at no target and attackable targets; confirm the center and visible outer lines use gray and green by default. Select a camera-preferred target with ESO's configured control and confirm the separate blue marker appears without changing the center targetability color.
• Enter combat and confirm the outer lines turn red while the center continues to report gray or green target state without color blending, with the blue preferred marker remaining independent when active.
• Deal or receive damage and confirm the outer lines flash orange briefly before returning to red.
• Confirm overlays hide in inventory, map, Champion Points, crafting, Tales of Tribute, addon settings, and other non-HUD scenes.
• Confirm the block shield appears only while the character is actively blocking.
• Confirm the block shield changes to warning color when stamina is below Block Cost * 5.
• Enable the debug panel and confirm its values match visible behavior.
• Confirm English and Spanish strings load correctly.

Development Checks

Before release or commit:

.\tools\bump-version.ps1 -Check -ApiVersion "101049 101050"
git diff --check

Only update ## APIVersion after verifying the current ESO API version.

License

EZOCursor is released under the MIT License. See LICENSE.