SparrowSparrow

Modules

Moderation

Warn, time out, kick and ban with commands, and every action becomes a numbered case you can look up, change and search. Sparrow also has AutoMod, Raid Protection and your own appeal page. On the dashboard it has its own Moderation heading: Overview, Cases, AutoMod, Raid Protection, Appeals, Appeal Page and Moderation Settings. Moderation is free, every part of it.

Setting it up

  1. Open Moderation, then Overview. Sparrow only asks for moderation permissions (Timeout Members, Kick Members, Ban Members and Manage Server) once you use Moderation, so press Give Sparrow these permissions if it lists any.
  2. In Discord, move Sparrow's role above the roles of the members it should act on. Discord never lets a bot act on someone with a higher role.
  3. Open Moderation Settings: pick a log channel, your Moderator roles and Kick and ban roles, and save.

Who can moderate

  • Moderator roles: warn, time out, purge, lock, slowmode, and look up cases and history.
  • Kick and ban roles: all of the above, plus kick, ban and unban.
  • Discord's own permissions work too: Timeout Members, Kick Members and Ban Members. Admins and Sparrow Master Roles can do everything.

Nobody can act on themselves, the server owner, Sparrow, or someone whose highest role is as high as theirs. Every use of a moderation command is posted in the log channel, refused attempts too, with the reason.

Commands

CommandWhat it does
/warnWarn a member. They get a DM and it's added to their history.
/timeoutTime out a member for a length like 10m, 2h or 1d (up to 28 days).
/untimeoutEnd a timeout early.
/kickKick a member. Asks you to confirm first.
/banBan someone, also people who already left (paste their ID). Add a length for a temporary ban (up to 1 year), and delete their messages from the last 1 to 7 days. Asks you to confirm first.
/unbanLift a ban.
/purgeDelete up to 100 recent messages, only from one member, with some text, or from bots. Pinned messages stay.
/lock, /unlockStop members sending messages in a channel. /unlock puts its permissions back exactly as they were.
/slowmodeSet how often members can post in a channel, up to 6 hours, or off.
/historyA member's moderation history, newest first, with what still counts or is still running.
/caseview, reason, length, evidence, remove and restore (remove and restore are for admins).
/lockdownAdmins: lock the channels picked under Raid Protection at once, and open them again.
Moderation historyRight-click a member, then Apps: their history, like /history.

Cases

Every warning, timeout, kick, ban, unban, purge and lock gets a case number, counted per server. Bans and timeouts done with Discord's own menus become cases too, marked Done with: Discord's own tools.

  • /case view shows one case with its pictures and changes. /case reason and /case length change it, and every change is kept with a before and after.
  • On the dashboard's Cases page, search by case number, member, ID, moderator or reason, and filter by type or still running.
  • On a case that's still in force, Unban, End timeout or Stop counting lifts it. Sparrow does it the same way as the command, with its own case and DM.
  • Remove case only hides the record, for a case made by mistake. It doesn't unban anyone, and it can be restored.
  • Ticket staff see a member's latest cases in Staff Notes, and in the ticket log channel when that member opens a ticket. The member never sees it.

Evidence pictures

/warn, /timeout, /kick and /ban take up to 3 pictures, and /case evidence adds more, up to 10 per case. They're for staff only: shown in the log channel, /case view and the dashboard, never in the member's DM.

Only real pictures are kept (PNG, JPG, GIF or WEBP, up to 8 MB). Sparrow redraws each one as a fresh copy, so nothing hidden in the file comes along, and stores it encrypted.

Messages to the member

Members get a DM with what happened, why, how long and the case number, with an Appeal button when your appeal page takes that kind of punishment. In Moderation Settings, pick which actions send one, whether it names the moderator, and whether a short public line goes in the channel (off at first).

When a ban or timeout is over sends a DM when it ends, with a one-use invite back after a ban. Discord only lets Sparrow DM people who share a server with it, so after a ban this often can't be sent.

Warning steps

Sparrow can act by itself when a member reaches a number of warnings, like a 10 minute timeout at 2 warnings and a ban at 5. Each step makes its own case. Pick when warnings stop counting: never, or after 7 days up to 6 months.

The safety limit

A hacked or rogue moderator could kick or ban a lot of people fast. The safety limit stops that: more than 5 kicks or bans in 10 minutes (the owner can change both) and Sparrow refuses, stops that person's moderation, and tells the owner by DM and in the log channel.

  • Kicks and bans with Sparrow's commands, with Discord's own menus, and the ones their warnings set off all count toward one limit.
  • Stopped moderators are listed on the Overview, where another admin can give their access back. They can't do it themselves.
  • Also watch Discord's own tools (off at first): anyone but the owner who goes over the limit also loses their roles below Sparrow's, so they can't carry on with Discord's menus. Discord doesn't let bots block a right-click ban before it happens, so this is what stops it.
  • Only the server owner can change the limit, the watch, and Bots joining. When an admin sets Sparrow to kick or ban by itself (warning steps, AutoMod or Raid Protection), it's posted in the log channel.

AutoMod

Rules that catch messages and punish who sent them. Each rule has its own punishment (only remove the message, warn, time out, kick or ban), and can ignore channels and roles. Admins, Sparrow Master Roles and bots are never caught.

  • Discord's own rules, set up for you in your server's AutoMod: Blocked words, Discord's word lists, Mention spam and Spam. Discord blocks the message before anyone sees it. These need the Manage Server permission. Discord allows only one Mention spam rule per server: if another bot's is switched off, Sparrow takes it over, and if it's on, Sparrow counts mentions itself.
  • Sparrow's checks: Invite links, Links (with websites you allow), Capital letters, Repeated messages, Message flood and Scam links. The message is removed with a short note that deletes itself.

Raid Protection

  • Join waves: when lots of accounts join within seconds, Sparrow alerts staff, can pause invites for up to 24 hours (Discord's own pause), and can time out or kick everyone in the wave. Staff end raid mode with a button.
  • New accounts: time out, kick or ban accounts younger than you pick, with a DM saying why.
  • Bots joining (owner only): only you, people you allow, and Discord-verified bots if you want, can add bots. Others are kicked and you get a DM.
  • Lockdown: pick channels, then lock them all at once from the dashboard or with /lockdown on. Ending it puts each channel's permissions back exactly.

Appeals

Your server gets its own appeal page, like sparrowbot.net/appeal/your-server. Members sign in with Discord and see only their own punishments in your server, each with Appeal or the reason it can't be appealed yet.

Making the page yours

  • Page address: pick a short name (it shows ✓ when it's free). Names that look like Sparrow, Discord or staff are kept back.
  • A banner (with where it sits), logo, title, welcome text, a Before you appeal box, server rules link and contacts, with a live preview.
  • Up to 10 questions: short answer, paragraph, dropdown, checkboxes, yes or no, and Pictures (up to 3, staff only).
  • What can be appealed (warnings, timeouts, kicks, bans), and Also after the punishment is over for clearing someone's record.
  • When they can appeal, whether they can appeal again after a deny, and when unanswered appeals close.

Answering appeals

  • New appeals are posted in your appeals channel with Accept, Deny and Discuss (a staff thread), and are on the dashboard's Appeals page too. Admins, Sparrow Master Roles and the roles you pick can answer.
  • Accept undoes the punishment (unban, end the timeout, or the warning stops counting) and can send a one-use invite back. The member gets a DM and sees the answer on their page and in My Account.
  • Show who answered decides whether the member sees your name.
  • Staff are warned when the punishment is already over or a newer one is still running. Accepting an appeal about an older ban never lifts a newer one.
  • If the punishment ends another way (unbanned, or the timeout ran out), the waiting appeal closes by itself. Nobody can answer their own appeal.

Good to know

  • Each server's cases, appeals and settings are its own. A member's history in one server never shows in another.
  • Moderation and Logs work together: when someone rejoins, the Logs entry shows their moderation history in your server.
  • Sparrow's role order matters: it can't time out, kick or ban anyone whose role is above its own.