Action Ring v1.0.0

Part of the Ultima Suite • Radial Quick-Action Engine & Pie Menu Suite for World of Warcraft (Retail & Midnight-Ready)

---

🌟 Overview

Part of the Ultima Suite — engineered to operate 100% standalone with zero mandatory cross-addon dependencies, while providing seamless inter-addon synergies via UltimaBridge when other suite modules are installed.

Action Ring is a modern, ultra-responsive radial action engine and pie menu suite developed specifically for World of Warcraft Retail (Patch 12.1.0 / Midnight, Interface 120100). Serving as our in-house, zero-taint alternative to OPie, Action Ring enables players to bind unlimited abilities, items, raid markers, world flares, equipment sets, and macros to intuitive circular menus that expand around the cursor.

---

✨ Key Features

🎯 1. Zero-Taint & Secure Combat Execution

• Blizzard Sandbox Resilient: Operates through pre-configured SecureActionButtonTemplate buttons and restricted execution environments, guaranteeing zero UI taint.
• Combat Lockdown Safe: Ring layouts, attributes, and keybindings are pre-computed out-of-combat; any modifications made mid-fight are seamlessly buffered in an internal DeferredQueue and committed upon PLAYER_REGEN_ENABLED.
• Hardware Event Driven: Genuine hardware events trigger actions, fully compliant with Blizzard's protected action architecture.

📐 2. Fluid Circular Geometry & Deadzone Tracking

• Mouse Angle Math: Calculates precise radial angles (θ=atan2(dy,dx)θ=atan2(dy,dx)) to smoothly highlight the slice closest to your cursor.
• Anti-Twitch Deadzone: Configurable central deadzone (15–70px) where no slice is highlighted, preventing accidental misfires when tapping keys or moving near the center.
• Elastic Visuals: Sleek Ultima Modern Dark UI theme with glowing warm gold borders, smooth radial expansion animations, and high-contrast iconography.
• Dynamic Center HUD: The center ring displays the focused slice's high-resolution icon, title, description, and real-time cooldown countdowns.

📦 3. Ready-To-Use Out-of-the-Box Rings

• Raid Markers (ALT-R): Instantly place or clear all 8 raid target markers (Skull, Cross, Square, Moon, Triangle, Diamond, Circle, Star, Pass).
• World Flares (CTRL-ALT-R): Rapid ground smoke flares for tactical positioning and boss encounter strategies.
• Travel & Hearthstones (ALT-H): Fast access to standard Hearthstone, Dalaran, Garrison, Flight Master's Whistle, Warband Bank, and guild cloaks.
• Consumables & Combat (ALT-C): 1-click access to healing potions, mana draughts, healthstones, buff food, and flasks.
• Mounts & Flight (ALT-M): Skyriding favorites, repair mounts, water striders, and vendor mammoths.

🛠️ 4. Two-Tier Navigation Studio & Ring Editor

• Visual Ring Manager: Manage unlimited custom radial menus with Two-Tier gold tabs and navigation pills.
• Interactive Keybind Capture: Click any hotkey button and press any key combination (ALT-, CTRL-, SHIFT-) to bind or rebind instantly.
• Blizzard Keybindings Menu Integration: Native registration in Options -> Keybindings -> Action Ring with bidirectional synchronization.
• Slice Reordering: Reorder slices clockwise with 1-click [^] and [v] buttons.
• Sub-Ring Support: Nest rings within rings to create multi-tier hierarchical radial menus.

🌉 5. UltimaBridge Synergies

• Macro Maker Integration: Send macros created in Macro Maker directly into your custom radial rings with a single click.
• Raid Sentinel Hooks: Tactically triggers and syncs marker rings during raid leader encounter preparation.
• Menagerie Keeper Hooks: Auto-populates favorite mount and battle pet rings dynamically.

⌨️ Keybindings & Shortcuts

Action Ring is fully integrated into the official World of Warcraft Keybindings menu (Options -> Keybindings -> Ultima Suite):

Binding Name	Action	Type
Action Ring: Toggle Ring Studio	Toggle configuration and visual editor	Script Toggle
Action Ring: Raid Markers	Trigger Raid Markers radial ring	Secure Action (ALT-R)
Action Ring: World Markers	Trigger World Markers radial ring	Secure Action (CTRL-ALT-R)
Action Ring: Teleport & Utility	Trigger Teleport & Travel radial ring	Secure Action
Action Ring: Consumables	Trigger Potions & Consumables radial ring	Secure Action
Action Ring: Mounts	Trigger Ground & Skyriding Mounts radial ring	Secure Action
Action Ring: Open Ring 1–4	Custom slots for user-created radial rings	Secure Action

---

⌨️ Slash Commands

Command	Action
/ar / /actionring	Toggle the Action Ring Studio configuration window
/ar keybinds	Open the Blizzard Keybindings menu directly
/ar open <ringID>	Open a specific radial ring by ID (e.g. /ar open raid_markers)
/ar list	List all configured rings and their assigned hotkeys in chat
/ar reset	Reset all rings and options to factory defaults
/ar help	Print command usage instructions in chat

---

🌐 Supported Languages

Full localization across all 10 official World of Warcraft client languages:

• 🇬🇧 English (enUS)
• 🇩🇪 German (deDE)
• 🇪🇸 Spanish (esES / esMX)
• 🇫🇷 French (frFR)
• 🇮🇹 Italian (itIT)
• 🇧🇷 Portuguese (ptBR)
• 🇷🇺 Russian (ruRU)
• 🇰🇷 Korean (koKR)
• 🇨🇳 Simplified Chinese (zhCN)
• 🇹🇼 Traditional Chinese (zhTW)

---

📦 Installation

1. Download the latest release.
2. Extract into your World of Warcraft AddOns directory:
   World of Warcraft\_retail_\Interface\AddOns\ActionRing
3. Launch World of Warcraft and type /ar to open the studio or press ALT-R to open the Raid Markers ring.

---

📜 Credits & License

Developed with ❤️ by **Satyros**. Designed for World of Warcraft Retail (Patch 12.1.0 / *Midnight*).  
Licensed under the **MIT License**. Part of the **Ultima Suite**.

 Acknowledgements & Inspirations:
* Built for the **Ultima Suite** ecosystem (`UltimaBridge`).
* Special thanks to the trailblazers of the WoW addon community, especially **OPie** (by *foxlit / Tammalex*) for pioneering radial action ring menus in World of Warcraft.