QUICK RECAP

Quick Recap

The whole library in about a minute, for when you've read the full docs before and just need your memory jogged.

What this is

A Discord.js security library, not a bot - it attaches to a Client you already have running. Four independent layers share one threat-scoring and punishment pipeline, so the same incident never gets double-punished by two layers reacting separately.

Layer Watches for
AntiRaid Join floods, alt accounts, slow-trickle raids
AntiNuke Mass deletes/bans/webhook abuse, plus dangerous role grants and @everyone permission-overwrite abuse - via the audit log
Basic Security Spam, scam/raid language, phishing links, @everyone/@here pings
AI Moderation A Groq call, only for messages the local classifier can't confidently score

A shared ThreatEngine turns every layer's signals into one decaying per-member score; a shared PunishmentEngine turns that score into an action, softened by the member's real trust level - a genuine admin gets flagged for human review, never auto-banned.

The per-server model

Everything above is per-server: one bot process can run this across many Discord servers, each with its own active layers, whitelist, and (v2.1.0+) its own command prefix, surviving a restart if you pass a stateStore. Two things stay shared across every server the process serves: the phishing blocklist and config.js itself. Full picture: State.

Want to add your own detection layer or punishment action instead of just configuring the built-in ones? frame.registerLayer() and frame.registerAction() - see Protocol Layers. Running the bot yourself and want a cross-server view? !gf engine - see Engine.

Get it running

npm install glassframe-protocol

Attach it once your client is ready, point it at a log channel, and either list layers in autoStart or arm them with !gf panel. Full walkthrough: Getting Started.

Commands that matter day to day

  • !gf panel - the 5-button control panel
  • !gf status / !gf metrics - this server's state and numbers
  • !gf whitelist add/remove <userId> - exempt someone, in this server
  • !gf prefix set/reset - this server's own command prefix
  • !gf phishing add/remove/list <domain> - the link blocklist (shared bot-wide)

Full reference: Commands.

Go deeper