
🦅 Eagle Eye 20/20/20 - Eye Break Management
Protect your eyes without getting caught in the fire.
Eagle Eye 20/20/20 implements the optometrist-recommended 20-20-20 rule (every 20 minutes of screen time, look 20 feet away for 20 seconds) tailored specifically for World of Warcraft.
Unlike standard desktop timers that block your screen during a boss encounter or arena match, Eagle Eye is built around combat awareness and player safety: it holds until you are out of danger, auto-pauses when AFK, and immediately cancels if combat begins.
🛡️ Built for MMO Players
- Combat Safety Gate: When a break is due, the addon holds and displays
IN COMBAT - WAITING. It never blocks your screen during a pull. - Instant Combat Interrupt: If a patrol aggros or an enemy player jumps you during a rest, the overlay instantly disappears and restores your screen with zero delay.
- Emergency Escape: Double-click anywhere or tap
ESCto cancel the break at any second. - Smart Context Awareness:
- Flight Paths: Offers an early break prompt if you board a taxi with under 5 minutes left.
- AFK Detection: Pauses the timer when you step away, and resets after 60 seconds AFK.
- Resting Areas: Optional auto-start when break is due inside inns or capital cities.
⏱️ Flexible Timer Presets
Choose from standard ergonomic intervals or build your own:
- 20/20/20 (Default) — 20 min work, look 20 ft away, 20 sec rest
- 30/30/20 — 30 min work, look 30 ft away, 20 sec rest
- 45/45/20 — 45 min work, look 45 ft away, 20 sec rest
- 60/60/20 — 60 min work, look 60 ft away, 20 sec rest
- CUSTOM — Set your own work minutes, rest seconds, and target distance!
✨ Clean, Modern Interface
- Mini-Timer Widget: Compact, movable status bar showing time remaining, current status, pause/resume, and quick snooze buttons (
+1m/+2m). - Minimap & Addon Compartment: Clean circular minimap button and native Addon Compartment support.
- Event Log & Compliance Stats: Track your session and lifetime breaks completed, snoozes, combat interruptions, and overall compliance rate.
- Group Coordination: Optional polite announcements to Party or Raid so your team knows you're taking a quick 20s eye rest.
- Zero External Dependencies: Lightweight and efficient. No Ace3, no LibStub, and strictly throttled background updates.
⌨️ Slash Commands & Keybindings
Use any of /ee20, /eagleeye20, or /202020:
| Command | Action |
|---|---|
/ee20 |
Open the Settings panel |
/ee20 start / pause / reset |
Control the timer |
/ee20 safe or /ee20 confirm |
Confirm you are safe and begin your 20s rest |
/ee20 snooze [seconds] |
Push the break back (default: 60s) |
/ee20 preset [20|30|45|60|custom] |
Switch active timer scheme |
/ee20 log |
Toggle the event log and compliance statistics window |
/ee20 minimap |
Toggle the minimap button |
/ee20 test |
Run a 5-second quick test cycle |
/ee20 panic |
Emergency clear of the break screen |

