Aegis

Automated threat detection and mitigation for Discord servers, built as a plugin for Advanced Discord Bot.

Modules

| Module | Description | Default | |--------|-------------|---------| | Anti-Raid | Detects mass joins and auto-locks the server | Off | | Anti-Spam | Detects duplicate messages and mass mentions | Off | | Anti-Link | Deletes messages containing URLs or Discord invites | Off | | Anti-Alt | Blocks or flags accounts below a minimum age | Off |

All modules are off by default. Enable each one independently per guild.

Installation

# In your ADB plugins directory
npm install adb-plugin-aegis

Then add "adb-plugin-aegis" to your ADB plugin list.

Required Bot Permissions

• Manage Channels (for lockdown)
• Kick Members / Ban Members (for anti-alt/spam enforcement)
• Moderate Members (timeout, for spam mute)
• Manage Messages (to delete spam/links)
• Set Verification Level (for raid lockdown)
• Send Messages + Embed Links (for log channel output)

Configuration Commands

All /antimod subcommands require Administrator permission.
/antiraid lockdown requires Moderate Members permission.

Setup

/antimod setup          Show overview and module list
/antimod status         Show all module states and current settings
/antimod log #channel   Set the channel for Aegis log embeds

Anti-Raid

/antimod raid on
/antimod raid off
/antimod raid threshold <joins> <seconds>
  — e.g. /antimod raid threshold 10 10  (10 joins in 10s)

When the threshold is hit, Aegis automatically:

1. Sets server verification to HIGH
2. Denies SendMessages for @everyone in all text channels
3. Logs to the configured log channel

To lift manually:

/antiraid lockdown

Anti-Spam

/antimod spam on
/antimod spam off
/antimod spam action <warn|mute|kick|ban>
  — "mute" applies a 10-minute timeout (default)

Triggers on N identical messages in a window, or a single message with N+ mentions.

Anti-Link

/antimod link on
/antimod link off
/antimod link whitelist <domain>
  — e.g. /antimod link whitelist github.com

Discord invite links (discord.gg/...) are always blocked when the module is on, regardless of the whitelist.
Whitelisted domains are stored per guild and persist across restarts.

Anti-Alt

/antimod alt on
/antimod alt off
/antimod alt age <days>   — minimum account age (default: 7 days)

Actions:

• flag (default) — logs the join to the log channel; member is not removed
• kick — immediately kicks the member with a reason

Development / Testing

npm install
npm test

Tests run without a real Discord connection or database (in-memory mocks).

License

This project is licensed under the GNU Affero General Public License v3.0. See the LICENSE file for details.

This repository follows the policies of the main ADB project.

• Contribution Guidelines: CONTRIBUTING.md
• Code of Conduct: CODE_OF_CONDUCT.md
• Security Policy: SECURITY.md