Skip to main content
The Guild Moderation cog applies moderation actions within a single Discord server.

Command Groups

All commands are nested under /guild.

/guild moderation

CommandDescription
/guild moderation banBans a member from the guild. Optionally DMs the target with a reason and appeal link.
/guild moderation softbanBans and immediately unbans a member to purge their recent messages.
/guild moderation kickKicks a member from the guild.
/guild moderation muteTimes out, image-mutes, or react-mutes a member. Duration and type are configurable.
/guild moderation unmuteRemoves a timeout, image-mute, or react-mute from a member.
/guild moderation unbanUnbans a user from the guild.
/guild moderation clearBulk-deletes messages in a channel. Supports filtering by user, count, and age.
/guild moderation masskickKicks multiple members at once.
/guild moderation warnIssues a warning to a member, logged to the audit system.
/guild moderation quarantineQuarantines a member (strips roles and restricts permissions).
/guild moderation lockdownLocks or unlocks a channel or the entire server. Re-using the command on an already-locked target toggles it back.
/guild moderation slowmodeSets the slowmode delay on a channel.
/guild moderation nicknameChanges or resets a member’s nickname.
/guild moderation commsAssigns, removes, or lists community service (purgatory). A member must complete a configured number of cleanup tasks before regaining normal access.
/guild moderation statusShows the full moderation profile for a user within the guild. Supports filtering by action type and looking up a single audit row by ID.
/guild moderation bansBrowses the server’s ban list with pagination. Optionally checks if a specific user ID is banned.
/guild moderation wavebanStages users for a wave ban, then executes, lists, or clears the queue. Supports network propagation on execute.
/guild moderation ignore_banManages ban exceptions — allows globally or network-banned users to remain unbanned in this server. Actions: add, revoke, list.
/guild moderation sentimentscanOn-demand sentiment scan over stored message logs. Scopes: guild, channel, user, or role. Configurable look-back window, message cap, time-bucketing granularity, and keyword prefilter. Can attach a JSON report.

/guild management

CommandDescription
/guild management auditBrowses the guild’s internal moderation audit log with pagination.
/guild management customizeConfigures the bot’s per-server profile (name, avatar, colour, etc.).
/guild management appeal_linkSets or clears the guild’s ban appeal link sent in punishment DMs.
/guild management permissionsConfigures sub-permission grants for guild moderators.
/guild management logConfigures guild log channels. Actions: set, clear, view, setup.
/guild management wavebanViews or configures waveban settings (auto-execute threshold, notification channel, etc.) for this server.

/guild utility

CommandDescription
/guild utility roleAdds or removes a role from a member.
/guild utility profileDisplays a member’s avatar or banner.

Punishment DMs

When a moderation action is taken, the bot attempts to DM the target with the action type, reason, and appeal link (if configured). DM types supported: ban, softban, kick, timeout, untimeout, warn, unban, quarantine, unquarantine, image-mute, react-mute.

Permission Requirements

Guild moderation commands require one of:
  • Administrator Discord permission
  • A guild moderator role configured via /guild management permissions
  • Specific sub-permission grants (e.g. ban, kick, manage_automod)