Clean Start

!CleanStart - Clean Up Your Login Spam

Tired of login spam flooding your chat every time you enter the game?
!CleanStart automatically captures, filters, and organizes all chat messages that appear during login - giving you a clean, quiet start every time you play.

Whether it's addons printing debug text, system messages firing all at once, or random clutter you don’t care about, !CleanStart puts you in control.

You can finally filter out messages you’ve already seen hundreds of times, like:
“Remember to act responsibly, protect your personal information, and report anything offensive. View our In-Game Code of Conduct…”

⭐ Features

🔍 Smart Message Capture

• Captures all chat messages during a short, configurable login window
• Addon messages (no message ID) are automatically blocked during this window
• System messages are allowed through but can be individually managed

🖼️ GUI Review Window

Open the interface anytime with /cs to:

• Review every captured message in order
• See message type, ID, and full text
• Allow or block system messages with one click
• View addon messages (blocked by default) for reference

🎯 Text-Based Filtering

Filter types include:

• =text - Exact match
• ^text - Starts-with match
• text - Contains match

🛡️ Whitelist System

Protect important messages from ever being filtered:

• Text whitelist — Ensure specific lines always pass through
• Addon whitelist — Exempt an entire addon so none of its login messages are blocked
  • Useful for chat‑skinning addons (EllesmereUI, ElvUI etc) that reformat chat lines

🔧 Debug Mode

See detailed message processing info, including message IDs.

💾 Persistent Settings

All filters and preferences are saved account-wide.

⚡ Lightweight

Minimal performance impact and no unnecessary overhead.

🕹️ Commands

Use /cleanstart or /cs:

• /cs - Toggle the captured messages window
• /cs on | off - Enable or disable filtering
• /cs status - Show current status
• /cs window - Set capture window duration (default: 1s)
• /cs list - List all custom filters
• /cs add - Add a filter manually (^starts, =exact)
• /cs remove <#> - Remove a filter by number
• /cs clearfilters - Clear all filters
• /cs whitelist add | remove | list - Manage whitelist
• /cs whitelist addon add | remove | list <name> — Manage addon whitelist
• /cs debug - Toggle debug output

⚙️ How It Works

During login, !CleanStart captures all chat messages for a brief window.

• Addon messages are blocked by default
• System messages are shown normally
• Your Allow/Block choices are saved and applied on future logins

If you /reload inside a dungeon or raid, the capture window is skipped entirely to avoid interfering with live instance chat.

🔄 Filter Priority

1. CleanStart’s own messages (always allowed)
2. Text whitelist
3. Custom text filters / blocked IDs
4. Addon messages (blocked during login window)
5. Addon whitelist (exempts step 4)
6. System messages

❗ Compatibility

• Works best with the default Blizzard chat frames
• CleanStart restores its chat hook only if no other addon has replaced it, so it won’t overwrite chat‑skin handlers
• No known conflicts with other addons