Advanced Hotkey Overlay System

Enhanced hotkey overlays for all action bar addons with intelligent UI detection and real-time customization

What does this addon do?

Advanced Hotkey Overlay System replaces the default hotkey text on your action buttons with fully customizable overlays. It currently has dedicated support for the default Blizzard interface, AzeriteUI, and Dominos, with conflict-aware handling for ElvUI.

Key Features

Universal Compatibility

Automatically detects Blizzard UI, AzeriteUI, Dominos, and ElvUI conflict state
Focused support for the action bar addons the codebase explicitly targets
Intelligent button detection for new and custom action bars

Real-Time Customization

All settings apply instantly—no UI reload needed
Live preview of font, color, position, and scale changes
ConsolePort-style hotkey abbreviations (e.g., Ctrl → C, Shift → S)

Complete Visual Control

Choose font family, size, color, and transparency
Text shadows and outlines for maximum readability
Pixel-perfect positioning and multiple anchor points

Smart Protection System

Lock settings to prevent accidental changes during gameplay
Confirmation dialogs for protected options
Master toggle to hide all overlays and options when disabled

Profile Management

Per-character and global profiles via Ace3
Effortless switching between configurations
Import/export settings for easy sharing

Advanced Tools

Comprehensive debug mode and in-game inspection commands
Smart refresh to re-detect UI changes
Temporary overlay clearing for screenshots
Minimap and Titan Panel integration

How to Use

Install and Enable: Extract to your AddOns folder and enable in-game.
Automatic Setup: The addon detects your UI and applies optimal defaults.
Configure: Use /ahos or click the minimap button to open settings.
Customize: Adjust position, appearance, and behavior to your liking.

Slash Commands

/ahos — Open configuration panel
/ahos toggle — Enable/disable overlays
/ahos lock — Lock settings to prevent changes
/ahos reset — Reset to default settings
/ahos debug — Enable debug mode for troubleshooting
/ahos help — Show all available commands

Troubleshooting

Overlays not appearing?

Check if the addon is enabled with /ahos toggle
Try /ahos reload to refresh detection
Use /ahos debug for detailed troubleshooting

Wrong UI detected?

Use /ahos detectui to manually re-detect your interface
Check debug output to see which addons were found

Settings not saving?

Ensure the addon loaded properly by testing /ahos
Make sure settings aren’t locked (unlock with /ahos unlock)

Requirements

World of Warcraft Retail or Classic (current patches)
Ace3 libraries (included)
LibSharedMedia-3.0 (included)
LibDBIcon-1.0 (included)

Recent Updates (v2.5.12)

Fixed Dominos binding resolution by preferring addon-provided command names and hotkey refresh hooks.
Modernized the in-game options layout around status, compatibility, support, and debugging.
Updated Retail, Mists, and Vanilla TOC targets for current client builds while keeping Retail 120000 compatibility.

Perfect for players who want readable, customizable hotkeys that work with any UI setup!