PangobotDocs
Moderation

Moderation Free

Bans, kicks, timeouts, warnings and a full case history.

The classic tools - ban, kick, timeout, warn - with a case for everything: who, whom, why, when. Cases can be looked up, edited and removed, and a member's history is one command away.

Setting it up

  1. Pick a mod-log channel that only your staff can see. Every case is posted there.
  2. Decide whether members get a direct message when they are punished, and add appeal instructions (for example the address of a ban-appeal form from Forms).
  3. Optional: immune roles, warnings that expire, and automatic escalation - for example a one-hour timeout at three active warnings.

Commands

<required> [optional] - "who may use it" is Discord's default; a server's admins can change it per command under Server Settings > Integrations.

/ban

Ban Members
/ban <user> [reason] [duration] [delete_days]

Ban a user (optionally temporary)

  • user member - User or user ID
  • reason text, optional - Reason (shown in the mod log and DM)
  • duration text, optional - Temporary ban, e.g. 7d or 12h
  • delete_days whole number, optional - Delete their messages from the last N days

/unban

Ban Members
/unban <user> [reason]

Unban a user

  • user member - User ID
  • reason text, optional - Reason (shown in the mod log and DM)

/kick

Kick Members
/kick <user> [reason]

Kick a member

  • user member - The member
  • reason text, optional - Reason (shown in the mod log and DM)

/softban

Ban Members
/softban <user> [reason]

Ban and immediately unban to wipe a member's recent messages

  • user member - The member
  • reason text, optional - Reason (shown in the mod log and DM)

/timeout

Timeout Members
/timeout <user> <duration> [reason]

Time a member out (mute)

  • user member - The member
  • duration text - e.g. 10m, 2h, 7d (max 28d)
  • reason text, optional - Reason (shown in the mod log and DM)

/untimeout

Timeout Members
/untimeout <user> [reason]

Remove a member's timeout

  • user member - The member
  • reason text, optional - Reason (shown in the mod log and DM)

/warn

Timeout Members
/warn <user> <reason>

Warn a member

  • user member - The member
  • reason text - Reason (shown in the mod log and DM)

/note

Timeout Members
/note <user> <text>

Attach a private moderator note to a user

  • user member - The member
  • text text - The note

/history

Timeout Members
/history <user> [page]

Show a user's moderation history

  • user member - The member
  • page whole number, optional - Page

/case

Timeout Members
/case view <number>

Show a case

  • number whole number - Case number
/case reason <number> <reason>

Change the reason of a case

  • number whole number - Case number
  • reason text - New reason
/case remove <number>

Mark a case (e.g. a warning) as removed so it no longer counts

  • number whole number - Case number

/purge

Manage Messages
/purge <amount> [user] [contains] [bots]

Bulk delete recent messages in this channel

  • amount whole number - How many messages to check (1-100)
  • user member, optional - Only messages from this user
  • contains text, optional - Only messages containing this text
  • bots yes / no, optional - Only messages from bots

/slowmode

Manage Channels
/slowmode <interval>

Set slowmode for this channel

  • interval text - e.g. 5s, 1m, 1h - or "off"

/lock

Manage Channels
/lock [channel] [reason]

Stop @everyone from sending messages in a channel

  • channel channel, optional - Defaults to this channel
  • reason text, optional - Reason (shown in the mod log and DM)

/unlock

Manage Channels
/unlock [channel]

Undo /lock

  • channel channel, optional - Defaults to this channel

Settings

Everything you can set for this module in the dashboard.

  • Mod-log channel - Every case is posted here.
  • DM members when they are punished
  • Appeal instructions - Added to ban DMs, e.g. a link to your appeal form.
  • Require a reason for every action
  • Immune roles - Members with these roles cannot be punished through Pangobot.
  • Warnings expire after (days) - 0 = never
  • Automatic escalation - Punish automatically when a member reaches a number of active warnings.
    • At this many warnings
    • Do this
    • Duration - For timeouts / temp bans, e.g. 1h or 7d. Empty = permanent ban.

Good to know

  • Durations are written like 10m, 2h, 7d. A ban with a duration lifts itself when the time is up.
  • /softban bans and immediately unbans: it removes the member's recent messages without keeping them out.
  • /note is only visible to moderators and never notifies the member.
  • Discord's own rules still apply: nobody can act on the server owner or on someone whose highest role is above their own - or above the bot's.
  • Require a reason makes the reason option mandatory for every action.
  • Members with an immune role cannot be punished through Pangobot - by anyone.

What the bot needs

  • Ban Members, Kick Members, Moderate Members (timeouts), Manage Messages (purge), Manage Channels (slowmode, lock).