WhichKey - Mythic+ Keystone Announcer

Automatically announce which keystone you're running when joining Mythic+ groups!

---

🗝️ What is WhichKey?

WhichKey is a smart, lightweight addon that automatically detects and announces the LFG queued keystone when you join a Mythic+ group or when someone joins your party. No more typing in chat, no more confusion about which key you're running!

✨ Key Features

🔔 Automatic Detection

• Reads keystone info directly from Group Finder queue
• Instant detection when joining or forming groups
• Works with cross-faction groups
• Announces when new members join your party

🎨 Fully Customizable

• Color Pickers - Choose custom colors for dungeon name and level
• Custom Message - Edit the announcement text to your liking
• Adjustable Delay - Configure timing (1-10 seconds) to prevent spam
• Live Preview - See exactly how your announcement will look

💬 Smart Chat Integration

• Posts to PARTY or RAID chat automatically
• Whispers to yourself when solo (for testing)
• Color-coded announcements for easy reading
• Professional format: Ara-Kara, City of Echoes (+15)
• !keys Trigger - Type !keys or !key in any chat to link your keystone instantly!

⚡ Easy to Use

• Works immediately after installation - zero configuration required
• Open settings with /wk c
• Quick commands for all functions
• Intuitive interface with helpful tooltips

📋 Slash Commands

Command	Action
/wk or /wk help	Show all commands
/wk c or /wk config	Open settings panel
/wk check	Manually announce current keystone
/wk toggle	Turn addon on/off
/wk status	Show addon status
/wk debug	Display debug information

⚙️ Settings Panel

Access via /wk c or ESC → Interface → AddOns → WhichKey

Available Options:

✅ Enable WhichKey
Turn automatic announcements on or off

🐛 Debug Mode
Shows detailed debug messages for troubleshooting

🗝️ Enable !keys Trigger
Allow party/raid/guild members to request your keystone by typing !keys or !key
Default: Enabled

💬 Announcement Message
Customize what text appears before the keystone
Default: "You joined for:"

⏱️ Announcement Delay
How long to wait before announcing (1-10 seconds)

• Prevents chat spam
• Allows time for LFG data to load
  Default: 5 seconds

🎨 Dungeon Name Color
Click to open color picker and choose your preferred color
Default: Epic Purple (like Mythic+ items)

🎨 Level Color
Click to open color picker for the (+15) level display
Default: Gold

👁️ Live Preview
See exactly how your announcement will appear in chat!

💡 How It Works

1. You join a group via Group Finder for a Mythic+ dungeon
2. WhichKey detects the group join event instantly
3. Waits briefly (configurable delay) for LFG data to load
4. Extracts keystone info from the LFG queue
5. Announces to party with your custom colors and message!

📊 Example Announcements

Default:

WhichKey: You joined for: Ara-Kara, City of Echoes (+15)

Custom Message:

WhichKey: Running: Mists of Tirna Scithe (+20)

With Custom Colors:

WhichKey: My key: [Bright Green]The Stonevault[/color] [Orange](+18)[/color]

🛠️ Troubleshooting

No announcement when joining groups?

1. Check if addon is enabled: /wk status
2. Verify you joined via Group Finder (not manual invite)
3. Try increasing Announcement Delay to 7-8 seconds
4. Enable Debug Mode to see what's happening

Wrong keystone shown?

• Only works with LFG queue data
• Manual party invites won't have keystone info
• The addon shows what's in the Group Finder listing

Want to see debug info?

1. Open settings: /wk c
2. Enable Debug Mode
3. Watch chat for detailed logs
4. Use /wk debug for instant debug output

🎯 Best Practices

• Keep Announcement Delay at 5+ seconds for reliable LFG data loading
• Enable Debug Mode when troubleshooting issues
• Customize colors to match your UI theme
• Use /wk check to test without joining a group

🔄 Version Information

Current Version: V2025
Author: Alvarín-Silvermoon
Interface: 10.2.7 (The War Within Compatible)

🎮 Perfect For

• PUG Runners - Professional keystone coordination
• Guild Groups - Quick key announcements
• Key Pushers - Never forget to announce your key
• Group Leaders - Know what everyone's running

📦 Technical Info

• No Dependencies - Works standalone
• Lightweight - Minimal memory footprint
• Event-Driven - Instant detection, no polling lag
• Safe & Secure - Only uses official Blizzard APIs

💖 Support Development

Enjoying WhichKey? Consider:

• ⭐ Rating the addon on CurseForge
• 💬 Leaving feedback and suggestions
• 🐛 Reporting bugs to help improve it
• 📢 Sharing with your guild and friends!

---

🔗 Quick Links

• Report bugs or request features on the project page
• Join discussions in the comments
• Check the changelog for latest updates

---

WhichKey - Making Mythic+ coordination effortless!

by Alvarín-Silvermoon - V2025