📖 Documentation

🚀 Getting Started

1. Invite the bot using the invite link.
2. Run /setlog #channel to choose where violation alerts go.
3. Log in to this dashboard with Discord and open Config to tune features per server.

🛡️ Slur & Bypass Detection

Every message is scanned against the blocklist with a multi-layer bypass engine that defeats common evasion tricks:

• Normalization — leet-speak (n1gg3r), separators (n.i.g.g.e.r), unicode look-alikes, zero-width characters, emoji letters
• Fuzzy matching — catches misspellings within a configurable edit distance
• Phonetic matching — catches sound-alike spellings
• Encodings — ROT13, Caesar shifts, reversed text, pig latin
• Letter-stitch — letters spread across multiple messages
• Translation — non-English messages are translated and re-scanned (premium)
• Self-learning — new bypass variants are harvested and can be auto-promoted to the blocklist

Per-server custom words and whitelists are managed on the Blocked Words and Whitelist pages.

🔒 Locked terms: a small set of child-safety terms and hard racial slurs is permanently blocked and can never be exempted in any server — not by a server admin, not via the dashboard. Attempts to exempt them are rejected and reported to the bot owner.

🤖 AI Context Moderation (premium)

For borderline detections, the bot asks an AI how the flagged term is actually being used before acting — so a quote or a reclaimed word isn't punished like an attack.

• Attack — aimed at someone → punished as normal
• Quote / Reclaim / Discuss → logged for mods, but not punished
• Benign — false positive → vetoed silently

High-confidence exact matches skip the AI; every failure mode fails open so detection never gets weaker.

🖼️ Image Scanning

• OCR — text inside images and GIFs is extracted and scanned like a normal message (premium)
• NSFW detection — explicit nudity in images is detected and deleted automatically when enabled (premium)
• Profile pictures — avatars are OCR-scanned on join and on avatar change; usernames, display names, and nicknames are scanned too

🔐 Verification Gate

Hold risky new joiners behind an unverified role until they pass a one-click Verify button. Set it up with /verification setup.

• Triggers — gate everyone, or only young accounts, accounts with no profile picture, or anyone joining during a raid burst
• One click — verifying swaps the unverified role for your member role and logs a case; the button keeps working after a bot restart
• Raid-aware — during a join-burst the gate automatically holds everyone

Set the unverified role's channel permissions to deny View/Send so gated users can't talk until verified.

🔥 Heat Escalation

Each violation adds heat to the offender (1–1.5 points, scaled by detection confidence). Heat decays over time — by default it halves every 60 minutes. Crossing a threshold triggers an automatic action:

• Timeout at 3 heat (default) — temporary mute
• Kick at 5 heat
• Ban at 7 heat

A user who slips up once cools off before ever reaching a threshold; someone spamming slurs crosses all three in minutes. Thresholds and decay rate are configurable per server.

Need to forgive someone early? Use /clearheat user:@member to reset one person's heat, or /clearheat with no user to cool down everyone in the server (requires Manage Server).

Heat is saved to the database, so repeat offenders keep their accumulated heat even if the bot restarts — no clean slate on every redeploy.

🚨 Anti-Raid & Mass-Mention

When a burst of members joins within the raid window, the bot can automatically slow down your public channels to break the raid's momentum, then lift the slowmode on its own once the configured duration passes (it even restores correctly if the bot restarts mid-raid).

Mass-mention protection deletes any message that pings more than your set limit of users/roles, or uses @everyone/@here. Choose whether it just deletes the message or also times the sender out.

Configure both in the dashboard's Alt & Raid Detection and Mass-Mention Protection sections — per server.

🧹 Filtered Purge

/purge bulk-deletes recent messages with optional filters you can combine: by user, by keyword (contains), or by type — invites, links, bots, or embeds.

Example: /purge amount:50 filter:invites clears the last 50 messages that contain Discord invites, leaving everything else untouched.

🚨 Server Protection

• Anti-nuke — alerts when mass bans, kicks, or channel/role deletions happen within a short window (premium)
• Anti-spam — detects message floods, including cross-channel floods
• Alt detection — flags (or kicks) accounts younger than a configurable age on join
• Raid alerts — warns when an unusual number of members join within seconds
• Invite filter — auto-deletes Discord invite links
• Phishing filter — auto-deletes Discord-impersonating scam domains
• Ban sync — link your servers with /bansync link so a ban in one mirrors to the others (opt-in, admin in both servers required)

📨 Ban Appeals

When someone is banned, the bot DMs them a private appeal link. Their appeal lands in your log channel with Approve / Reject buttons and on the dashboard's Appeals page. Approving unbans the user and DMs them a one-use invite back. One pending appeal per user per server. Toggle per server under Config → Ban Appeals.

🎫 Tickets

Run /ticketpanel in a channel to post an Open Ticket button. Each ticket becomes a private thread visible only to the opener and moderators, with a close button that posts a full transcript to your log channel. Use it for reports, questions, and partner applications.

⌨️ Key Commands

Command	What it does
/setlog #channel	Set the violation log channel (admin)
/setreport #channel	Set the report channel (admin)
/settranslation	Toggle translation scanning (admin)
/premium	Check this server's premium status
/history @user	Full mod record: cases, violations, heat (mod)
/note @user text	Add a private mod note to a user's record (mod)
/ticketpanel	Post a ticket panel in this channel (admin)
/ticketclose	Close the current ticket thread
/bansync link id	Mirror bans with another server you admin
!warn @user [reason]	Issue a formal warning (mod)
!history @user	View a user's violation history (mod)

★ Premium

Premium unlocks OCR scanning, NSFW image detection, translation scanning, anti-nuke, self-learning, and unlimited custom words & violation history. Check /premium in your server for current status. Get premium →