Moderation (Suntinel)
Suntinel is SunBot's moderator, free on every server. Every action is a numbered case on the member's record, a DM telling them why, and a card in your mod-log channel.
Setting it up
- Pick or create a private #mod-log: Dashboard → Moderation, or
/admin→ Suntinel. - Decide whether members get a DM saying why (on by default).
- Check SunBot's role is above the roles of the members it will moderate.
The commands
| Command | What it does | Who sees it |
|---|---|---|
/warn member reason? | A warning on the member's record, as a numbered case. | Timeout Members |
/timeout member duration reason? | Discord's own timeout, 60 seconds to a week, or lift one early. Written only once Discord applied it. | Timeout Members |
/kick member reason? | They hear why first, then they're out. | Kick Members |
/ban user reason? delete_messages? | Also someone who already left, by their id. Can sweep their messages from the last hour, day or week. | Ban Members |
/unban user reason? | Lifts a ban. | Ban Members |
/note member note | A note only moderators see ("alt of @someone"). The member is never told. | Timeout Members |
/warnings member | The record, newest first, with a menu to take one warning back and a button to clear them all. Taken back means crossed out, never deleted. | Timeout Members |
/purge amount member? reason? | Deletes the channel's newest messages, all or one member's. Never a pinned one. | Manage Messages |
/slowmode wait channel? reason? | Members wait between messages: 5 seconds to 6 hours, or off. | Manage Channels |
Each command is hidden from members without the matching Discord permission. You can change who sees what in Server Settings → Integrations → SunBot.
The rules
Nobody can moderate themselves, SunBot, another bot, the server owner, or anyone whose top role is as high as their own. The bot says which rule stopped it.
The mod log
Every case posts a card to the mod log: the member, the moderator, the reason and the case number; timeouts show when they end. Purges and slowmodes get a card too. The cards ping nobody.
On the dashboard
The Moderation page shows the week in numbers and the newest cases, can take a case back, picks the mod log and has the DM switch. /admin → Suntinel has the same in Discord.
Autopilot: auto-mod, the ladder, anti-raid, the gate
Four parts that work without a moderator online, each switched on on its own on Dashboard → Moderation.
| Part | What it does | Plan |
|---|---|---|
| Auto-mod: invites and spam | Discord's own AutoMod blocks invite links, and what Discord's spam filter catches. | Free |
| Auto-mod: links, words, caps, mentions | Links (except the sites you allow; YouTube, Twitch, Tenor and Giphy are allowed to start with), your banned-words list (up to 1,000, * is a wildcard), messages in ALL CAPS, and too many mentions in one message (6 to start with). Each can also time the sender out. | Premium |
| The warnings ladder | Up to three steps: at so many standing warnings, a timeout, a kick or a ban, taken by SunBot itself, from /warn and from auto-mod. To start with: 3 → an hour's timeout, 5 → a kick, 7 → a ban. | Premium |
| Anti-raid | Too many joins too fast (10 in a minute to start with) and Discord's own pause invites goes on for as long as you set, up to 24 hours, with a card in the mod log and a ping to you. | Premium |
| The verification gate | A Let me in button in a channel you pick gives new members the member role, and can ask for an account at least so many days old (up to 365). | Premium |
How auto-mod works: SunBot writes its rules into Discord's AutoMod (Server Settings → AutoMod lists them as "SunBot · …") and keeps them in step with the dashboard. Discord blocks the message before anyone sees it, even while SunBot is offline, and SunBot never reads what people write. The sender sees "Suntinel blocked this message: it breaks a rule on this server." Every hit is a card in the mod log and, with Every hit is also a warning on, a warning on the member's record, which the ladder counts. Roles and channels can be exempt.
Auto-mod needs the Manage Server permission, Discord's rule for AutoMod. If SunBot was added without it, the Moderation page has a button that re-invites it with it.
Coming next
Jail, with bail paid in coins.