discord-guardian

Simulate and protect Discord bot security with a modular plugin framework.

A modular alternative to building anti-nuke and security systems from scratch, with built-in simulation for safe testing.

Installation

npm install discord-guardian

Demo

import { createBot, antiNuke, logger } from "discord-guardian"

const app = createBot(client)

app.use(antiNuke())
app.use(logger())

app.start()

app.simulate({ type: "ban", count: 3 })

Output:

[guardian] ban threshold reached
  executor: 000000000000000000
  guild: Simulation Guild

Quick Start

Use only the plugins you need:

import { createBot } from "discord-guardian/core"
import { antiNuke } from "discord-guardian/anti-nuke"
import { logger } from "discord-guardian/logger"
import { automod } from "discord-guardian/automod"

const client = new Client({ intents: [...] })
const app = createBot(client)

app.use(antiNuke())
app.use(logger({ level: "minimal" }))
app.use(automod())

app.start()

Extension Power

Create custom plugins to extend the framework in seconds:

app.use({
  name: "alerts",
  init({ on }) {
    on("threatDetected", (data) => {
      console.log(`[ALERT] Blocked ${data.type} from ${data.executorId}`)
    })
  }
})

Framework API

Import Options

You can use subpath exports (recommended) for a cleaner architecture:

import { createBot } from "discord-guardian/core"
import { automod } from "discord-guardian/automod"

Or maintain convenience with root imports:

import { createBot, automod } from "discord-guardian"

Modules

anti-nuke

Detects and blocks mass bans, kicks, channel deletions, and bot additions. Supports full attack simulation.

logger

Tiered structured logging. Minimal mode focuses strictly on critical threshold events for clean production logs.

automod

Spam and mass-mention prevention with support for users, roles, and @everyone.

Planned plugins

• dashboard: Real-time web-based control panel.
• analytics: Track threat trends and bot performance.
• advanced-automod: AI-backed spam filtering.

Permissions

• View Audit Log
• Ban Members
• Kick Members
• Manage Roles
• Send Messages

MIT