Skip to content

AdvancedDiscordBot/adb-plugin-aegis

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

MIT

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors