KojinBots logoKojinBots
Bot Documentation

Gavel — Moderation

A complete enforcement suite for Discord: AutoMod with raid protection, AdminSaver impersonation defense, a unified modpanel, full case history, lockdown, and an analytics dashboard. Everything runs through slash commands and interactive panels.

Required permissions

On invite, grant Gavel the following so every feature works out of the box: Manage Server, Manage Roles, Manage Channels, Kick Members, Ban Members, Moderate Members (timeout), Manage Messages, View Audit Log, and Send Messages / Embed Links.

Setup

  1. 1

    Run /setup

    Launches the interactive setup wizard. Picks your mod-log channel, moderator role, and default thresholds in under a minute.

  2. 2

    Verify with /setup-status

    Confirms which subsystems are configured (logs, automod, adminsaver, modpanel) and what's still missing.

  3. 3

    Configure logs with /logs

    Sets per-event log channels — message edits/deletes, joins/leaves, role changes, mod actions. Each can be routed independently.

  4. 4

    Enable protection

    Run /basicprotection (free tier) for instant baseline coverage, or /automod and /adminsaver for the full premium suite.

AutoMod — /automod

Gavel's AutoMod combines a detection engine, configurable punishment ladder, and raid protection. Open the control panel with /automod to toggle rules: spam, mention-flood, link filtering, invite filtering, and content filters. Punishments escalate automatically (warn → timeout → kick → ban) based on the tier you set.

Raid protection auto-locks join flow if join velocity spikes past your threshold. It can also auto-engage /lockdown.

AdminSaver — /adminsaver

Impersonation and admin-takeover defense. AdminSaver monitors username and avatar changes against your staff roster and flags or auto-quarantines accounts that mimic a moderator. Open the configuration panel with /adminsaver to set the similarity threshold, monitored roles, and threat response (alert, strip roles, or quarantine).

Moderation commands

/modpanel

Unified moderation panel — warn, timeout, kick, ban, clear messages, and look up users from one interface.

/warn

Open the warn panel: issue warnings, remove warnings, or adjust escalation settings per user.

/timeout @user <duration>

Timeout a member. Accepts 10m, 1h, 1d, etc. Auto-creates a case.

/kick @user [reason]

Kick a member from the server with case logging.

/ban @user [reason]

Permanently ban a member. Logged to the case system and mod-log channel.

/clear <amount>

Bulk-delete messages in the current channel. Optional user filter.

/case <number>

Look up a moderation case by its case number — full action history, moderator, and reason.

/modstats

Moderation statistics by moderator and action type over a chosen period.

Server safety

/basicprotection

Free-tier baseline protection: enables sensible AutoMod defaults in one command.

/lockdown

Emergency server lockdown — restricts @everyone send permissions across channels.

/unlock

Lift an active lockdown and restore prior permissions.

/cleanbots

Remove inactive or unauthorized bots from the server.

/cleanembeds

Strip embeds from recent messages in a channel — useful after raids.

Analytics & info

/dashboard

Open the live analytics dashboard — moderation, growth, automod, and server activity in one view.

/analytics

Quick analytics summary for the current server.

/serverstats

Member counts, activity trends, and channel breakdowns.

/userinfo @user

Profile, join date, roles, and moderation history for a user.

/serverinfo

Server overview — owner, region, boosts, role and channel counts.

/avatar @user

Display a user's full-size avatar.

/export

Export moderation data and analytics as a downloadable file (premium).

/logs

Configure logging channels per event type.

Account & utility

/premium

Check premium status, view perks, and manage your subscription.

/redeem <code>

Redeem a premium activation code.

/vote

Vote for Gavel on top.gg to unlock voter perks.

/help

Interactive help browser — categorized command reference.

/info

Bot information, version, and system status.

/stats

Comprehensive bot and server statistics.

/uptime

Show current bot uptime.

/status

Live status of Gavel's services.

Case system

Every moderation action — warn, timeout, kick, ban — is automatically recorded with a unique case number, moderator, target, reason, and timestamp. Look up any case with /case <number> or review a user's complete history through /modpanel or /userinfo.