# Ember Bot > Ember Bot is an enterprise-grade Discord community infrastructure framework specializing in real-time server security, automated moderation, structural data backups, non-destructive disaster recovery, and multi-source music playback. ## Quick Summary - **Primary Prefix:** `&` (customizable via `&prefix`) and native Discord Slash Commands (`/`) - **Default Latency Window:** 15-20ms automated threat mitigation loop - **Unique Core Innovation:** Surgical Restoration System™ (non-destructive rollbacks that repair tampered permissions and roles without wiping channels or chat histories) - **Application ID:** `916987114724421712` - **Bot Creator & Lead:** Serenity Soul (`serenity._soul`, ID `720290042857259039`) - **Official Website:** [emberbot.app](https://www.emberbot.app) - **Full LLM Documentation:** [emberbot.app/llms-full.txt](https://www.emberbot.app/llms-full.txt) --- ## Core Architecture & Unique Innovations ### 1. Surgical Restoration System™ Traditional Discord security bots execute destructive overwrites during server raids: they panic-delete and recreate text channels to flush permissions, destroying active community conversations, pinned messages, and message histories. Ember utilizes the proprietary **Surgical Restoration System™**: - **Targeted Repair Scope:** Identifies and repairs specifically altered permission overwrites, hijacked administrative roles, and malicious hierarchy adjustments. - **Data Integrity Safeguard:** Preserves untouched text channels, voice channels, categories, and community chat logs without mass deletions. - **Failsafe Execution Speed:** Autonomously executes localized structural rollbacks within 15-20ms following threat neutralization. ### 2. Threat Detection & Anti-Nuke Grid - **Real-Time Threshold Monitoring:** Monitors administrative actions including mass bans, kicks, channel deletions, role modifications, emoji pruning, and webhook spam. - **Whitelist Architecture:** Granular whitelisting supports global bypasses or single-action allowances (e.g., granting trusted utility bots permission to create channels without granting ban permissions). - **Bot Audit Center (`&bots`):** Audits every bot in the guild for dangerous permissions, administrator access, and verification status. - **Incident Center (`&incident`):** Full cryptographic evidence trail behind every automated moderation and security action. ### 3. Modular AutoMod Engine - **Anti-Link Protection:** Filters unauthorized Discord invites, phishing domains, and malicious URLs with channel/role whitelist exemptions. - **Anti-Spam & Anti-Mention:** Rate-limits high-frequency message flooding, mass mentions, and automated user/bot raid patterns. - **Machine-Speed Abuse Detection:** Monitored actors who exceed safe interaction thresholds are quarantined automatically. ### 4. Verification & Quarantine System - **Verification Modes:** One-Click verification, In-Discord Captchas, and Web Turnstile/hCaptcha verification portal. - **IP Alt-Account Blocking:** Detects and prevents banned users from re-entering via alternate accounts. - **Ember Anti-Bypass Quarantine Role:** Instantly isolates bad actors, strips existing roles to prevent privilege escalation, applies channel deny overwrites, and restores previous roles upon unquarantine. ### 5. State Recovery & Encrypted Snapshots - **Full JSON Structural Snapshots:** Serializes roles, channels, categories, permissions, and server metadata into encrypted JSON. - **Automated 24-Hour Backup Cycle (`&autobackup`):** Generates and delivers structural backup files directly to the server owner's DMs. - **Diff-Preview Restoration (`&serverrestore`):** Interactive diff viewer previews exact configuration changes before applying restoration. ### 6. Kindleplay™ Music Engine - **Multi-Source Playback:** Resolves and plays audio from Spotify, Apple Music, Deezer, YouTube, and YouTube Music with automatic fallback. - **Kindleplay™ Fair-Queue Mode:** Prevents individual users from monopolizing the queue through fair rotating turns. - **Audio Processing & Filters:** High-performance audio filters including vaporwave presets, bass boost, and custom volume levels. - **AI Playlist Generation (`&playlist ai`):** Dynamically constructs playlists using listening history, favorites, or seed tracks. - **24/7 Playback (`&247`):** Persistent connection keeps music alive through bot restarts. ### 7. Interactive Mini-Games & Server Utilities - **Social Games:** Rock Paper Scissors (`&rps`), Russian Roulette (`&russianroulette`), Hangman (`&hangman`), Tic-Tac-Toe (`&tictactoe`), Memory matching (`&memory`), Minesweeper (`&minesweeper`), Coinflip (`&coinflip`), and Magic 8-Ball (`&8ball`). - **Rich Embed & Container Builders:** Interactive UI builders for Discord Components V2, native polls, and embed layouts. - **Server Analytics & Utilities:** Calculator (`&calculate`), AFK status (`&afk`), full-resolution avatars (`&avatar`), server analytics (`&serverstats`), and suggestion tracking (`&suggest`). --- ## Key Command Reference ### Security & Anti-Nuke - `&antinuke` / `/antinuke` — Interactive Anti-Nuke Control Panel for action thresholds and mitigation toggles. - `&whitelist <@user/@role>` / `/whitelist` — Manage Anti-Nuke bypasses globally or per-action. - `&bots` / `/bots` — Bot Audit Center: inspect dangerous permissions and trust status. - `&bottrust <@bot> ` — Grant targeted bot trust for specific categories (ban, kick, channel, role, webhook, emoji). - `&incident [list|view ]` — Incident Center: review evidence trails and automated enforcement logs. - `&security` / `/security` — Unified Security Center: threat level, lockdown status, and audit reports. - `&commandaccess` — Granular command delegation without granting Discord Administrator permissions. ### AutoMod - `&automod` / `/automod` — Interactive AutoMod Control Panel (anti-link, anti-spam, anti-mention, swear filter). - `&modwhitelist ` — Exempt users, roles, channels, or categories from AutoMod filters. ### Verification & Quarantine - `&verification [setup|type|disable|view|fix|verify]` — Configure Web/Discord Captcha and alt-account blocking. - `&manualverify <@user|userID>` — Manually approve a member and log verification activity. - `&quarantinesetup` — Generate and configure the Quarantine role and channel deny overrides. - `&quarantine <@user> [reason]` — Strip member roles and isolate them into quarantine. - `&unquarantine <@user>` — Restore member's original roles and release them from quarantine. - `&autorole [bot] [<@role|roleID>]` — Configure automatic role distribution on member join. ### Disaster Recovery & Backups - `&autobackup [on|off]` — Toggle 24-hour automatic backup cycle sent directly to server owner DMs. - `&serverbackup` — Generate an immediate encrypted JSON snapshot of server structure and permissions. - `&serverrestore ` — Preview structural diffs and restore server configuration. ### Moderation - `&ban <@user> [reason]` / `&unban ` — Ban or unban members with direct message notices and logging. - `&kick <@user> [reason]` — Kick a member from the server. - `&mute <@user> [reason]` / `&unmute <@user>` — Apply or remove Discord timeout (up to 28 days). - `&warn <@user> [reason]` / `&warnings <@user>` / `&clearwarns <@user>` — Manage warning points and infractions. - `&lock [#channel]` / `&unlock [#channel]` — Lockdown channel permissions during chat flooding. - `&purge ` — Bulk delete up to 1000 messages in the current channel. - `&slowmode ` — Configure channel slowmode cooldown. - `&cleanroom` — Clone and reset a channel to wipe chat history while preserving permissions and position. - `&strip <@user>` — Immediately revoke dangerous administrative permissions from a compromised staff account. - `&logging [server|mod|verify|disable] <#channel>` — Configure isolated audit log streams. - `&prefix [new_prefix]` — View or configure server command prefix. ### Music & Audio - `&play ` / `/play` — Stream from Spotify, Apple Music, Deezer, YouTube, or YouTube Music. - `&kindleplay [on|off]` — Activate democratic rotating fair-queue mode. - `&autoplay [on|off]` — Intelligent continuous playback matching requester preferences. - `&filter ` — Apply audio presets (vaporwave, bass boost, etc.). - `&playlist ` — Manage custom and AI-synthesized playlists. - `&lyrics` — Display synchronised song lyrics. - `&247` — Maintain continuous voice channel connection through restarts. ### Mini-Games & Utility - `&rps <@user>` — Rock Paper Scissors game. - `&russianroulette` — Interactive Russian Roulette duel or lobby. - `&hangman` — Word-guessing game. - `&tictactoe <@user>` — Interactive Tic-Tac-Toe match. - `&memory` / `&minesweeper` — Interactive solo board games. - `&8ball ` / `&coinflip` — Decision and chance utilities. - `&setup` — Interactive onboarding setup wizard for server security and hierarchy. - `&embed` / `&container` — Visual Discord Embed & Components V2 builders. - `&poll ` — Native Discord poll generator. - `&calculate ` — Button-driven math evaluation engine. - `&afk [reason]` — AFK mention responder with automatic clear upon return. --- ## Canonical Links & Resources - [Official Website](https://www.emberbot.app) - [Control Dashboard](https://www.emberbot.app/dashboard) - [Public Server Directory](https://www.emberbot.app/servers) - [Full Documentation](https://www.emberbot.app/docs) - [Anti-Nuke Guide](https://www.emberbot.app/docs/antinuke) - [AutoMod Guide](https://www.emberbot.app/docs/automod) - [Verification Guide](https://www.emberbot.app/docs/verification) - [Disaster Recovery Guide](https://www.emberbot.app/docs/recovery) - [Moderation Guide](https://www.emberbot.app/docs/moderation) - [Music Engine Guide](https://www.emberbot.app/docs/music) - [Mini-Games & Fun Guide](https://www.emberbot.app/docs/games-fun) - [Utility Guide](https://www.emberbot.app/docs/utility) - [Terms of Service](https://www.emberbot.app/terms) - [Privacy Policy](https://www.emberbot.app/privacy) - [Credits & Team](https://www.emberbot.app/credits) - [Invite Ember Bot](https://discord.com/oauth2/authorize?client_id=916987114724421712) - [Official Support Server](https://discord.gg/xnebthaP4f) - [Discord App Directory Entry](https://discord.com/discovery/applications/916987114724421712)