Belphegor

Persistent addon diagnostics and performance monitor for WoW Midnight 12.0.x. Runs silently in the background catching errors, FPS drops, latency spikes, memory trends, taint violations, and combat performance data, then saves everything to a file you can share for troubleshooting.

Part of the Knowledge addon suite (KnowledgeDemon, Azazel, Bartended).

Why Use This

Most error-catching addons only show errors while you're playing. Belphegor persists across sessions. Errors, FPS spikes, and combat data survive logout and /reload. When something goes wrong, just type /bel export, log out, and send the file. No screenshots needed, no trying to reproduce the problem.

Always-On Monitors (zero configuration)

These run automatically from the moment you log in:

• Error Catcher - captures all Lua errors with source addon, stack trace, timestamp, and combat state. Deduplicates by signature so repeated errors don't spam.
• FPS Monitor - tracks FPS every 2 seconds, logs drops below 20 FPS as "spikes" with timestamp and zone.
• Latency Monitor - checks world latency every 10 seconds, logs spikes above 300ms.
• Memory Trend Tracker - periodic memory snapshots to identify addons with growing memory usage (leaks).
• Combat Logger - records combat session duration, FPS performance, event frequency, and top CPU consumers per fight. Uses targeted combat events by default (safe mode, zero taint).
• Taint Watcher - catches taint (protected function call) violations that cause "action blocked" errors.

Diagnostic Modes

Belphegor has two diagnostic modes for its combat logger and event sampler:

Safe Mode (default) - registers 28 specific combat-relevant events. Covers 95%+ of combat event volume. Zero taint. NPC dialogue, vendors, and mounting work normally for any session length.

Deep Diagnostics - registers ALL game events (RegisterAllEvents). Captures everything including events outside the combat list. Warning: causes taint accumulation over time, which can break NPC interaction, vendor windows, and mounting after extended play. Intended for short debugging sessions only. Toggle with /bel deepdiag, requires /reload to apply.

Commands

Always-On Logs

On-Demand Tools

Alerts

Data & Settings

How to Send Diagnostic Data

If you're experiencing issues with any Knowledge addon (KnowledgeDemon, Azazel, Bartended) or need performance help:

1. Play normally. Belphegor runs in the background automatically
2. When you encounter the problem, type /bel export in chat
3. Log out of WoW (or /reload)
4. Find the file at: WTF/Account/<YOUR_ACCOUNT>/SavedVariables/Belphegor.lua
5. Upload that file to the Knowledge Discord in the support channel

That single file contains all errors (with stack traces and source addon), FPS history, latency data, combat logs, and taint violations from your session. Tag DogGodFrogLog for support.

Installation

Download and extract into your Interface/AddOns/ folder. No configuration needed. All monitors start automatically on login.

Credits

Created by DogGodFrogLog / Sunya (Tichondrius)