Debug Console v1.0.0

Part of the Ultima Suite • Lua Error Catcher, Call Stack Inspector & Development 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.

Debug Console is a modern, high-performance Lua error catcher, call stack inspector, and diagnostic suite engineered specifically for World of Warcraft Retail (Patch 12.1.0 / Midnight, Interface 120100). Serving as our proprietary, zero-taint replacement for BugSack and !BugGrabber, Debug Console replaces dated error popups with a sleek Midnight Dark UI Studio, intelligent error origin filtering (Ultima Suite vs. Third-Party vs. Blizzard UI), 1-click clipboard bug reports, and combat-safe acoustic alerts.

---

✨ Key Features

🛡️ 1. Bulletproof Zero-Recursion Error Interception

• Safe Error Trap (seterrorhandler): Hooks into the Lua error runtime with recursion protection and secret-value defensive wrappers (issecretvalue).
• Suppression of Blizzard Popups: Automatically suppresses disruptive native Blizzard ScriptErrorsFrame popups, capturing errors silently into an inspectable log.
• Taint & Warning Surveillance: Captures ADDON_ACTION_BLOCKED, ADDON_ACTION_FORBIDDEN, and non-fatal LUA_WARNING events.
• Token-Bucket Flood Protection: High-frequency error loops in hot frames (OnUpdate) are automatically throttled to eliminate client lag and audio stutter.

🧭 2. Two-Tier Origin & Session Filtering

• Tier 1 Categorization Tabs:
  • All Errors: Complete aggregate list of all captured errors.
  • Ultima Suite: Dedicated filter showing only errors originating from our proprietary 16 suite modules.
  • Third-Party: Errors originating from external community addons.
  • Blizzard UI: Errors originating from native Blizzard interface code (SharedXML, FrameXML, etc.).
• Quick Settings Cog (⚙️): Title bar shortcut next to the close button for instant access to the Blizzard AddOn Options dashboard.
• Tier 2 Quick-Filter Pills:
  • This Session vs. All Sessions: Quickly focus on new errors since last login or review persistent historical logs.
  • Errors Only vs. Errors & Warnings: Filter out non-fatal warnings with one click.
  • Live Search Filter: Real-time query search filtering across error messages, addon names, and call stack paths.

📋 3. 1-Click Clipboard Bug Reporting

• Instant Report Modal: Click "Copy Report" to generate an organized, formatted bug report containing:
  • Client Build & Interface version
  • AddOn Origin & Severity
  • Exact occurrence counter & first/last seen timestamps
  • Clean error message
  • Full call stack trace with line numbers
  • Local variables dump
• Pre-Selected for Ctrl+C: The report editbox is automatically focused and highlighted for immediate copy-pasting into issue trackers or chat.

🔊 4. Acoustic Alerts & Audio Customization

• Selectable Sound Effects: Choose between 6 distinct alert sound effects: Raid Warning, Alarm Clock, Whisper Message, Ready Check, Quest Failed, and Spell Failed.
• Dedicated Audio Channels: Output audio via Master (bypasses muted sound effects to ensure errors are never missed), SFX, or Dialog.
• Instant Sound Test: Test and preview the chosen sound effect with an immediate 1-click test button in the Blizzard Settings Panel.
• New-Error-Only Filter: Optionally restrict audible alarms to first-time unique errors, suppressing chimes for repeated occurrences.
• Combat Mute: Suppresses audible cues during combat lockdown to avoid distracting encounter gameplay.
• Auto-Open Mode: Optionally unfolds the console window outside combat whenever an unhandled error is trapped.

---

⌨️ Slash Commands

Command	Action
/dc / /debug / /bug	Toggle the Debug Console Studio window
/dc wipe / /dc clear	Wipe all saved error logs from the database
/dc reload / /dc rl	Instantly reload the user interface (/reload)
/dc config / /dc options	Open Debug Console in the Blizzard Settings Panel

---

🌐 Supported Languages

Fully localized across all 10 official World of Warcraft client languages with automatic metatable fallback:

• 🇺🇸 English (enUS) — Canonical Base
• 🇩🇪 Deutsch (deDE)
• 🇫🇷 Français (frFR)
• 🇪🇸 Español (EU) (esES)
• 🇲🇽 Español (AL) (esMX)
• 🇮🇹 Italiano (itIT)
• 🇧🇷 Português (BR) (ptBR)
• 🇷🇺 Русский (ruRU)
• 🇰🇷 한국어 (koKR)
• 🇨🇳 简体中文 (zhCN)
• 🇹🇼 繁體中文 (zhTW)

---

📦 Installation

1. Copy the DebugConsole folder into your World of Warcraft directory: World of Warcraft\_retail_\Interface\AddOns\DebugConsole
2. Restart World of Warcraft or type /reload in-game.
3. Access the console via /dc, /debug, the Addon Compartment, or the Ultima Master Dashboard (/ultima).

---

📜 Credits & License

* **Author:** Satyros
* **Suite:** Ultima Suite
* **Compatibility:** World of Warcraft Retail (Patch 12.1.0+ / Midnight, Interface `120100`)
* **License:** MIT License

Acknowledgements & Inspirations:
* Built for the **Ultima Suite** ecosystem (`UltimaBridge`).
* Special thanks to the trailblazers of Lua error handling and debugging tools in World of Warcraft: **BugSack** & **BugGrabber** (*Rowne, Funkydude*) and **!Swatter**.