DeSync - Lag Monitor & Disconnect Alarm

DeSync - Lag Monitor & Disconnect Alarm | v1.0.8

Have you ever run halfway across a zone, only to realize the world has stopped moving?

We’ve all been there: You’re questing, traveling, or mid-pull when you realize your spells won't cast. You Alt+F4, restart, and log back in only to find yourself in a completely different position from minutes ago - usually surrounded by mobs or worse of all; at a graveyard. Blizzard's native latency display is often too slow to warn you of a "silent" or "ghost" disconnect until it's too late.

DeSync was built to solve this exact frustration.

Don't Just Guess - Know.

DeSync acts as a real-time heartbeat monitor for your connection. It sends a constant, lightweight "ping" between your client and the server. If the server stops responding for even a second beyond your safety threshold, DeSync alerts you instantly.

• Avoid that Hardcore Death: On a Hardcore or Soul of Iron realm, every second counts. DeSync gives you the warning you need to stop pulling and find a safe spot before the server officially drops you.
• Protect Your Group: Automatically broadcast a chat warning to your group the exact second your connection drops, and send an "All Clear!" message when you stabilize—preventing your tank from pulling while you are effectively a "ghost."
• Discord-Ready Alerts: Hear the alarm, tab out, and inform your teammates on Discord that you're lagging before they find out the hard way by watching your character run into a wall.
• Save Your Progress: By catching a desync immediately, you can stop, wait for a recovery, or restart the client before you've wandered into a dangerous area while "invisible" to the server.

Why DeSync is Essential:

• Detect "Ghosting" Instantly: The moment the server stops "talking" back to you, your status icon turns Red.
• Automated Chat Warnings: Automatically shout a customizable panic message (e.g., "[DeSync] Watch out! I'm having network issues!") and a follow-up recovery message when your connection is safe.
• Network Auto-Tune: Every connection is different. Use the built-in diagnostic tool to analyze your specific latency and set a custom "panic" threshold.
• Audio Panic Alarm: If you're tabbed out or flying, the customizable audio alarm will notify you the moment your connection drops.
• Lightweight Performance: Designed from the ground up to be ultra-lightweight, using a tiny footprint that won't lag your game—whether you're pushing Mythic+ in Retail or surviving in Classic Era Hardcore.

Core Features

Automated Chat Alerts

• Disconnect & Restore Alerts: Send a customizable panic warning the second you desync, and an automated "All Clear" message the moment your connection is restored. All broadcasts are automatically prefixed with [DeSync] so teammates instantly recognize the alert.
• Smart Channel Routing: Choose to send alerts to PARTY, RAID, or INSTANCE_CHAT. To comply with Blizzard's anti-spam API and prevent chat errors, DeSync intelligently verifies your group status and safely suppresses the broadcast if you are playing solo.
• Anti-Spam Throttle: A customizable cooldown timer (default 60 seconds) prevents you from spamming the chat if your connection is rapidly flickering.

Intelligent Network Monitoring

• Heartbeat Logic: Uses a dedicated addon-message prefix to verify the server is still processing your actions.
• Reactive UI: Use "Show Only on Desync" mode to keep the Pearl icon hidden during stable play. It only appears when things go wrong.
• Login/Zone Protection: An adjustable Grace Period ensures you don't get false alarms during loading screens or world transitions.
• Simulation Testing: Use /desync test to safely trigger a full mock-alert (audio, visual, and chat broadcast) to ensure your settings are configured exactly how you want them.

System Health Snapshot

• Dynamic Color Scaling: Latency numbers stay White when healthy, turn Orange when jittery, and Red when critical.
• Optional FPS Counter: View your frames alongside your latency to distinguish between hardware stutters and network lag.

The Interface & Customization

Designed to look like a native part of the Blizzard UI with professional Tooltip borders and classic gold text.

• Horizontal/Vertical Layouts: Stack your stats or lay them out in a single line.
• Flexible Anchoring: Place the text on the Left or Right of the icon for perfect edge-of-screen placement.
• Combat Smart-Hide: Keep your screen clear during fights, knowing the alarm will still fire if you lose sync mid-encounter.

Native Localization

The engine is fully localized in multiple languages. It automatically adapts to the client language of the user:

• Supported Languages: English, German (deDE), French (frFR), Spanish (esES), Portuguese (ptBR), Italian (itIT), Russian (ruRU).

Getting Started

1. Install: Drop the folder into your AddOns directory.
2. Calibrate: Type /desync and click "Run Network Auto-Tune" while in a major city.
3. Position: Drag the Pearl icon to a visible spot (like near your mini-map or action bars) and lock it.
4. Play with Confidence: You’ll never have to wonder if you’re lagging again.

Supported Commands

• /desync : Opens the Configuration Panel.
• /desync test : Triggers a simulated desync to test your visual, audio, and chat alert settings.

Known Limitations

Boss Encounter Restrictions: Blizzard's API restricts addon communication during boss fights to prevent automation, but the rules differ depending on which version of WoW you are playing:

• Modern Retail WoW: Addon communication is heavily rate-limited during all official boss encounters. To prevent false alarms, DeSync automatically pauses its heartbeat monitor while a boss is active. The UI will display "Paused" and monitoring will instantly resume the moment the boss dies or resets.
• Classic (Era, Hardcore, TBC, SoD, Wrath, Cataclysm, MoP): This restriction only applies to internal system self-whispers. DeSync will continue to protect you flawlessly during group/raid boss encounters! It will only pause monitoring if you are completely solo and engage a recognized boss (e.g., farming old dungeon bosses).

(Note: Across all versions of the game, you remain 100% protected during all trash pulls, open-world content, leveling, and PvP).

Automated Chat Alerts (Solo Play): Blizzard's API blocks automated SAY and YELL messages to prevent chat spam (they require a physical hardware click). Therefore, if you have Chat Alerts enabled but are not in a valid Party, Raid, or Instance group, DeSync will safely suppress the broadcast to prevent native system errors.

Frequently Asked Questions

• Q: Why is the icon green but I’m still lagging? DeSync monitors the server "heartbeat." You may experience local "input lag" or low FPS while the server connection itself is still perfectly synchronized.
• Q: Does this work on Hardcore/SoD/Retail? Yes! DeSync is built with a universal architecture that supports every official version of World of Warcraft from Classic Era to the latest Retail patch.
• Q: Will this slow down my game? No. DeSync uses an ultra-lightweight "ping" system and the Ace3 framework to ensure zero impact on your game performance.
• Q: How do I reset the position? If you lose the icon, type /desync to open the options and toggle the "Lock" or "Center" settings.

Compatibility

• WoW Classic Era / Hardcore / SoD: Fully Supported.
• Burning Crusade Classic (Anniversary): Fully Supported.
• Wrath of The Lich King / Cataclysm / Mists of Pandaria: Fully Supported.
• Retail / Mainline: Fully Supported.