SFT.DOCS // manual

Docs.

Everything you need to run Sift: setup, how it makes calls, and every command.

DOC.01

Getting started

  1. Add Sift. Use the invite link. It asks only for the permissions it uses: managing messages, timeouts, kicks, bans, channels for lockdown and appeal tickets. It never asks for Administrator.
  2. Run /setup. The server owner picks a log channel for case cards and a mod role. Everything else has a sensible default.
  3. Move Sift's role up. In Server Settings → Roles, drag Sift above the roles it should be able to time out or ban. Discord doesn't let a bot act on anyone ranked above it.
  4. Leave it running. After a day or two, /stats shows what it caught and how often your mods agreed.
Tip.txt

Optional channels in /setup: an event log (edits, deletes, joins, role changes), an urgent channel that pings your mod role for the most serious cases, and a private channel for members who may need support.

DOC.02

How Sift decides

Every message goes through two layers.

1. Instant rules

Lookalike and known scam links, spam floods, the same link posted across channels, and your own blocklist are handled on the spot. These never use a smart check, so they keep working when your monthly checks run out.

2. The smart check

Everything else is read together with the few messages before it, so friendly trash talk isn't treated like a real attack. Spaced-out letters, lookalike characters and words split across several messages are joined back up first. The result is one of three outcomes:

  • Pass. Nothing happens and the message isn't stored.
  • Review. Sift isn't sure. The message stays up and a case card goes to your log channel.
  • Block. Clearly over the line. The message is deleted, the member gets a strike, and a case is logged.

Members who seem to be in a bad place are never answered in public. Your mods get a private heads-up in the support channel instead.

DOC.03

Cases and the mod panel

Each case card shows the message, why it was flagged, and the member's recent history, with buttons to approve, warn, time out or ban. Use /modpanel to work through open cases one at a time, or /cases list to search old ones.

Approving a case tells Sift it got that one wrong. The overturn rate in /stats is the quickest way to see whether your thresholds need adjusting.

DOC.04

Strikes

Blocked messages add strike points. By default, 3 points is a timeout, 14 a kick and 20 a ban, and points expire after 30 days. Change the points, the steps or the expiry in /settings, or switch the ladder off and handle everything by hand.

Leaving and rejoining doesn't clear a timeout: Sift puts it back when they return.

DOC.05

Raids and mass deletes

When lots of accounts join in a short window (6 in 30 seconds by default), your mods get an alert that lists the new accounts. Turn on auto-lockdown in /settings and Sift also locks every text channel. /lockdown locked:false scope:server puts every channel back exactly as it was.

If anyone other than the owner deletes channels or roles, or bans members, in a rapid burst, Sift stops them, even if they have the permissions to do it.

DOC.06

Appeals

A member who was banned, kicked or timed out can DM Sift and run /appeal. That opens a private ticket channel with your team. Banned members are let back in to a restricted role while the appeal is reviewed, so they can only see their ticket.

Approving lifts the action. Rejecting ends the ticket, and they have to wait before appealing again.

DOC.07

Tuning it for your server

  • Too many flags? Raise the review threshold in /settings, or add the phrase your server keeps using to the allowlist.
  • Missing things? Lower the thresholds, or add exact phrases to the blocklist for instant deletes.
  • Quiet channels. Exempt channels and roles (a staff channel, a bot-command channel) so Sift ignores them.
  • Categories. Switch individual categories off. Child safety and member-support checks always stay on.

DOC.08

Sift Max features

Your own rules

/rules add takes a rule in plain English, like "No asking for game account logins". Choose whether a break is flagged for review or deleted with a strike. Up to 10 rules per server.

Server network

Link up to 5 servers you own with /network create and /network join. A ban in one is copied to the rest after a short delay, blocklists merge, and a raid on one warns the others. A burst of bans isn't copied, in case an admin account has been taken over. Unbanning someone where the ban started lifts the copies too.

Deeper context

Reads the last 25 messages instead of 6, and double-checks anything flagged or close to the line before acting.

Weekly report and export

A summary lands in your log channel every Monday with a CSV of the week's cases. /cases export downloads any period on demand.

DOC.09

Command reference

Setup

/setup

Opens the setup panel: log channels, mod role and the basics.

Server owner
/settings

Every setting in one panel: categories, thresholds, strikes, raid protection, exemptions.

Manage Server

Reviewing

/modpanel

Step through open cases one at a time.

Mods
/case id

Look up one case by its id.

Mods
/cases list

Recent cases. Filter by status, type, member, outcome or time.

Mods
/cases clear

Permanently delete this server's case history.

Mods
/stats period

What was caught, what was done, and how often mods overturned Sift.

Mods
/appeals status

Browse appeals by status.

Mods

Actions

/warn user reason

Warn a member. They get a DM and a case is logged.

Mods
/timeout user duration

Time out for 60 seconds up to a week.

Mods
/untimeout user

Lift a timeout early.

Mods
/kick user

Kick a member, with a DM and a case.

Mods
/ban user

Ban anyone by id, even if they've left. Can also clear their recent messages.

Mods
/unban user

Unban by id.

Mods
/purge count

Bulk-delete up to 100 recent messages in this channel.

Mods
/slowmode seconds

Set slowmode here. 0 turns it off.

Mods
/lockdown locked scope

Lock or unlock this channel, or every channel.

Mods

Members

/warnings user

A member's history. Members can see their own.

Everyone
/strikes view | reset

See or clear a member's strike points.

Mods
/appeal

Appeal a ban, kick or timeout. Run it in a DM with Sift.

Everyone
/verify

Check or finish verification.

Everyone

Plans

/premium status

This server's plan and smart checks used this month.

Mods
/rules add | remove | list

Your own plain-English rules. Max.

Manage Server
/network create | join | leave | status

Link servers you own. Max.

Server owner
/report now | weekly

Post the weekly report now, or turn the Monday report on or off. Max.

Manage Server
/cases export since

Download cases as a CSV file. Max.

Mods