ChatSpamRadar (CSR)

A dynamic chat filter, smart-shield quarantine, and alert tracker.

ChatSpamRadar (CSR) is a powerful command center designed to give you total control over your chat frames. Whether you are trying to block aggressive boosting spam, hunting for specific crafting orders, or tracking LFG keywords, CSR provides a robust suite of filtering and logging tools.

Featuring a fully interactive UI dashboard, it replaces basic filtering with a deeply customizable rule engine, an auto-quarantine system for rapid-fire spammers, and an alert tracker to ensure you never miss a message that matters to you.

🛡️ Smart Shield & Cleanse Engine

The Smart Shield: Automatically detects and quarantines players who send duplicate messages rapidly. You configure the strike limit and the time window, once they hit the threshold, their spam is silenced.
The Cleanse Engine: Spammers often try to bypass filters using hidden UI escape sequences, custom colors, or weird punctuation. CSR aggressively strips all of this data to find the raw text hash before evaluating it.
Bulletproof Whitelist: You will never accidentally block someone who matters. The engine inherently whitelists GMs, Battle.net friends, standard friends, and Party/Raid members.
Session Controls: Easily pause the Chat Filter or the Smart Shield for your current session directly from the Live Feed dashboard.

⚙️ Dynamic Rule Builder

Custom Rules Engine: Build rules based on "Contains" or "Exact Match" keywords.
Block or Alert Actions: Set rules to outright Block malicious spam, or set them to Alert to keep a log of messages you are interested in (e.g., "WTB", "Recraft").
Built-in CJK Filter: Includes a one-click rule keyword [ASIAN_CHARS] to quickly filter out foreign language spam often associated with boosting communities.
Audio Alerts: Bind specific Blizzard UI sounds (Map Ping, Raid Warning, Auction Bell) to your alerts, or load your own custom .ogg files for personalized notifications.
Export/Import: Easily share your rule lists with friends or alt accounts via copy-paste strings.

📊 Alerting Dashboard & Quarantine Monitor

Alerting Dashboard: When an Alert rule is triggered, the message is saved to your alerting dashboard tab (holds up to 500 leads). You can add custom text notes, track the time it was sent, and update the lead's status (Open, In Progress, Closed).
Quarantine Monitor: See exactly who the Smart Shield has caught, how many strikes they hit, and choose to manually release them or permanently block them.
Manual Blocklist: Manage your permanently blocked players in one place, or instantly wipe the list clean.

⚡ Quality of Life & Automation

Interactive Toasts: Receive sleek popup toasts (Top or Bottom of your screen) when an Alert is triggered. Left-click to instantly whisper the player, or Right-click to Target/Invite them.
Context Menu Integration: Right-click any player's name directly in the default chat frame to instantly add them to your CSR Blocklist without opening the dashboard.
4-State Settings Engine: Customize settings globally across your account, or apply character-specific overrides for granular control.
Auto-Pruning: Set an expiry timer (e.g., 30 days) to automatically clean out old alerting dashboard leads and keep your database lightweight.

🌍 Supported Languages

Features locale categories and support to ensure UI elements function across multiple regions:

English (US & British)

To come:

French, German, Italian
Spanish (EU & MX)
Portuguese, Russian
Chinese (Simplified & Traditional)
Korean

💻 Slash Commands

/csr or /chatspamradar (Opens the Dashboard)
Click the Minimap Icon to quickly toggle the interface!

📝 Credits

Author: Osiris the Kiwi (Discord: osirisnz)