docs

scraps is a multipurpose Discord bot for moderation, security and community features. Add it to your server and it runs AutoMod, anti-raid, verification, logs and tickets for you, with Last.fm, image tools and plenty more for your members.

what it does

• Security and moderation: AutoMod blocks phishing, ads, NSFW links and spam. Anti-raid catches coordinated joins and cleans up after them. Verification puts a captcha in front of new members, and moderation, jail and the honeypot handle the rest.
• Logging: message edits and deletes, joins and leaves, roles, voice, mod cases and tickets, each in a channel you choose. See logging.
• Community: tickets, welcome messages, role reactions, a starboard, levels, VoiceMaster, giveaways and games.
• Media and integrations: Last.fm, a social link fixer, song recognition, search and image tools.

Looking for one command? The commands page lists every one of them.

where to start

1. invite scraps and check its permissions

scraps can only do what its role allows. For the full feature set give it these permissions, or just Administrator if you prefer:

2. recommended setup order

1. Logs: run .logs setup so every later action is recorded. See logging.
2. AutoMod: run .automod setup. Start in Preview mode, check what it would catch, then switch to Live. See AutoMod.
3. Anti-raid: run .antiraid setup. Also starts in preview. See anti-raid.
4. Jail: run .jail setup so anti-raid and moderators can jail members. See jail.
5. Verification (optional): run .verification setup if you want newcomers to pass a captcha. See verification.
6. Everything else (tickets, levels, welcome messages, ...) is optional and independent.

prefix and slash commands

Most commands work both ways: as a prefix command (.ban @user) and as a slash command (/ban). In the tables of this documentation the Use column shows which:

• P: prefix only
• P+S: prefix and slash

Setup commands (automod setup, antiraid setup, ticket setup, ...) open an interactive wizard with buttons and menus, so you rarely need to remember arguments.

who can run a command

Each command lists the Discord permission it needs. scraps checks the member's permission, then checks fake permissions (see fake permissions). A command that needs Manage Server can therefore be unlocked for a role without giving that role the real permission.

command cooldowns

Heavy commands (image tools, fix, search, shazam, taste) have a short per-user cooldown. If you hit it, the bot tells you how long to wait.

custom prefix

See prefix for the server prefix and selfprefix for a personal prefix that works in every server.

AutoMod watches every new and edited message and removes the ones that break your rules. It has six modules that you turn on one by one:

why use preview mode first?

AutoMod has two modes:

• Preview: only logs what it would have done. Nothing is deleted. Use it for a few days to see false positives.
• Live: removes messages, applies the punishment and creates Discord's native AutoMod rules where it can.

AutoMod starts in Preview, with every module off. The recommended first modules are spam, links and raid.

module options

Each stored module has these options (not every module uses every option):

setting up

automod setup

Opens the step-by-step wizard: pick modules, sensitivity, punishments, exemptions, the notify role and the mode.

permissions

Manage Server

use

P+S

.automod setup

automod status

Shows each module's state, protection and the last 30 days of catches.

.automod status

automod mode

Switch between Preview (log only) and Live.

.automod mode (preview or live)

.automod mode live

automod enable / automod disable

Turn one module on or off while keeping its settings.

.automod enable (module)
.automod disable (module)

.automod enable links
.automod disable ads

automod settings

Change one module's options, or list them all when you give no module.

.automod settings [module]

.automod settings spam

blacklist

The blacklist is the words module: words and links scraps removes.

.automod blacklist add badword, ~slur, evil-site.com

Limits: 500 words, 200 link entries, entries up to 60 characters, and at most 2 wildcards per entry.

allowing domains

For the links, ads and nsfw modules you can allow a domain or one short link.

.automod allow youtube.com ads

Up to 200 allowed entries.

server rules

Anti-raid detects raids and coordinated spam, then reacts the way you choose. It watches joins (join bursts and new-account waves) and behaviour (the same message from many accounts), and groups evidence into incidents.

how it works

Evidence is graded into three levels, low, medium and high, and antiraid punishment lets you choose what happens at each level.

Extra options:

• Purge: delete the raiders' messages that match the confirmed pattern.
• Lockdown: temporarily lock channels while a raid is active (needs purge on, and lifts itself after a maximum time).
• Quiet welcome: no welcome pings during a raid.

Sensitivity can be relaxed, balanced or strict. Like AutoMod, anti-raid starts in a preview mode that reports what it would do without acting.

incident reports

When an incident happens scraps posts a report to the log channel with buttons such as Kick, Ban, Release and Purge messages, and attaches a transcript of the removed messages to the security log.

commands

All commands need Manage Server and work as prefix and slash.

.antiraid pause 2h
.antiraid incident 14
.antiraid falsepositive 14

Verification makes newcomers pass a captcha before they can see the server.

how it works

1. A new member joins and receives a restricted role. They only see the verification channel.
2. They press the button on the verification message and open a secure page on the scraps website.
3. After the captcha they are let in. If you enabled it, members who do not verify in time are removed.

The welcome message is held back until the member has verified.

alt detection

Optionally, verification can catch people verifying more than one account. It compares hashed network and device signals, never raw IP addresses, and links accounts that look related. Turn it on with verification settings alts.

Each verification gets a score. Depending on the score and on the action you chose in verification settings alts:

Held and flagged members come with Kick, Ban and approve buttons for your moderators.

commands

.verification setup
.verification approve @newmember
.verification alts @suspicious

Jail puts a member in an isolated space: they keep no roles, and can only see the jail channel. Their roles are given back when they are released. Rejoining members who were jailed when they left are jailed again.

.jail setup
.jail @user spamming in voice
.unjail @user cleared

The honeypot is a trap channel. Anyone who sends a message in it is softbanned (banned and their recent messages deleted), so bots and compromised accounts that post everywhere remove themselves.

Fake permissions let a role use scraps commands that need a permission, without giving the role that permission on Discord. They only affect the bot.

permissions

Administrator

aliases

fp, fakeperms

.fp grant @Moderators manage_messages
.fp list
.fp revoke @Moderators manage_messages

scraps sends each kind of event to a channel you choose.

log types

command

permissions

Manage Server

use

P+S

alias

logsetup

.logs setup
.logs (type) (channel)
.logs list
.logs remove (type)

.logs setup
.logs modlog #mod-logs
.logs securitylog #security
.logs remove voicelog

A ticket panel is a message with a button or a dropdown of topics. Members press it to open a private ticket channel. A server can have up to 5 panels, and a dropdown holds up to 25 topics, each with its own staff roles.

features

• Button panels or topic dropdowns
• Staff can claim a ticket
• A transcript is posted to the ticket log when a ticket closes
• Blacklist members from opening tickets

commands

All need Manage Server and work as prefix and slash.

alias

tickets

Members react to a message and receive a role.

permissions

Manage Roles

alias

rr

.rr setup https://discord.com/channels/123/456/789
.rr list

Send a message when someone joins, leaves or boosts the server. Use plain text or embed code, with variables. The embed builder writes the code for you.

permissions

Manage Server

Mention a channel in add to choose where the message goes (.welcome add #welcome ...). Without one, scraps uses the server's system channel.

.welcome add #welcome Welcome {user} to {guild.name}! You are member #{guild.count}.
.welcome add {embed}$v{title: Welcome!}$v{description: Glad you're here, {user}.}$v{color: #5865F2}
.welcome test

Auto responders reply to a trigger word or give and remove roles.

• A trigger matches when it appears anywhere in a message, ignoring upper and lower case.
• A responder only fires in the channel it was created in, or the channel you mention when adding it.
• Replies can use embed code.

permissions

Manage Messages

aliases

ar, autorespond

Options for add: write --reply to answer as a reply to the message, and mention a channel (#general) to limit it to that channel. Slash form: /autoresponder add trigger response [channel] [reply].

.ar add hello, Hi there!
.ar add rules, Read #rules before you chat. --reply
.ar role add @Member i agree

Boosters create their own role with a name and colour.

.br setup
.br Cloud #7289da
.br Sunset #ff7a18 #af002d

Messages that collect enough star reactions are reposted in the starboard channel.

permissions

Manage Server

default emoji

⭐

default threshold

3

.starboard setup #starboard
.starboard threshold 5

Members earn XP by chatting and in voice, and rank up. Level roles can be given at chosen levels.

default values

Level-up placeholders: {user_name}, {user_mention}, {level}.

member commands

admin commands

permissions

Administrator

.ranksetup true
.addlevelrole 10 @Regular
.setlevelupmsg Nice one {user_mention}, you hit level {level}!
.setlevelconfig msg_xp 25
.addxpbooster @Booster 50

Members join a "Join to create" channel and get their own temporary voice channel, which they control. The channel is removed when empty.

setup

permissions

Administrator

alias

vc

channel owner commands

The interface message in the VoiceMaster category has buttons for the same actions.

.vm setup
.vm limit 4
.vm rename Study room
.vm allow @friend

.prefix !
.selfprefix ,

Prefixes are chosen longest first, so .. wins over . when both are valid. Mentioning the bot always works.

Turn commands off in a channel. Staff with Manage Server can always use them.

permissions

Manage Server

The help, enable and disable commands can never be disabled, so you cannot lock yourself out.

.dcmd 8ball #general
.dcmd all #announcements
.eall #announcements

Give scraps a different avatar and banner in your server only.

permissions

Manage Server

permissions

Manage Messages

aliases

g, gw

Durations use the duration format: 30s, 10m, 1h, 2d.

.g quick 1h 1 Discord Nitro
.g start
.g reroll 123456789012345678

A channel-based counting game: members count up one number at a time.

permissions

Manage Server

A turn-based word game. On your turn scraps shows a few letters and you type a real word that contains them before the timer runs out. Words cannot be reused, and a player who runs out of time loses 1 HP. The last player standing wins.

personal

tools

messages

Message and voice statistics.

fix downloads the video or photos from a social media link and posts them in Discord.

cooldown

10 seconds

.fix (link)

.fix https://www.tiktok.com/@user/video/123
/fix link:https://x.com/user/status/123

Supported platforms: Bilibili, Bluesky, Dailymotion, Facebook, Instagram, Loom, OK, Pinterest, Newgrounds, Reddit, Rutube, Snapchat, SoundCloud, Streamable, TikTok, Tumblr, Twitch, X (Twitter), Vimeo, VK and YouTube.

• For X, Instagram and TikTok the result also shows post details such as likes, comments and views.
• When a link holds both photos and video, scraps asks which one you want.
• Uploads are limited by the server's Discord upload size.

Find a song from an audio or video file or a link.

cooldown

30 seconds per user, 10 per server

max file size

25 MB

A clip that was matched before is remembered for 15 minutes.

.fs https://www.tiktok.com/@user/video/123
/shazam link:https://youtu.be/abc

cooldown

10 seconds

.search image red panda
.search music Daft Punk One More Time

All send a new image from an attachment, a link, or the image you replied to. Animations are shrunk to fit.

cooldown

5–8 seconds

max image size

16 MB

.caption when the bot works first try
.motivation never give up
(reply to a message) .quote

Link your Last.fm account to see what you listen to, build charts, compare taste and compete in your server.

linking

now playing and stats

charts

Time periods (also for the top* commands and taste): weekly, monthly, alltime.

compare and compete

/fmlogin
.fm
.ta @friend weekly
.wk Radiohead
.cb weekly

Embed code is a short text format for building custom messages. It works in welcome, goodbye, boost messages, auto responders and the embed creator. Plain text with no tags is sent as it is, with variables replaced.

structure

Every part is written as {name: value} and parts are joined with $v.

{embed}$v{title: Hello}$v{description: Welcome to the server}$v{color: #5865F2}

• {embed} starts an embed. It must come first.
• {content: text} is the plain message above the embed.
• Parameters are joined with $v.
• && separates the pieces inside one parameter.

parameters

Button styles: link, primary (blurple), success (green), danger (red), secondary (grey).

full example

{content: Welcome {user}!}$v{embed}$v{title: Welcome to {guild.name}}$v{description: You are member #{guild.count}. Please read #rules.}$v{thumbnail: {user.avatar}}$v{color: #5865F2}$v{footer: Enjoy your stay}$v{button: link && Rules && https://example.com/rules}

Variables work in embed code and plain text for welcome, goodbye, boost and autoresponders.

Level-up messages use their own placeholders: {user_name}, {user_mention}, {level}.

Durations are written as a number followed by a unit, and can be combined.

30s
10m
1h
2d
1h30m

1 hour
ten minutes

Commands that need a permission name it in their table. Quick reference:

a role isn't given, or "I don't have permission"

Move the scraps role above the roles it needs to give, remove or jail, in Server Settings → Roles. Discord does not let a bot manage roles above its own.

a command does nothing

1. Check you used the right prefix. Mention the bot (@scraps help) to be sure.
2. Check the command is not disabled in that channel with .dcmds.
3. Check you have the permission shown in this documentation. A role may need a fake permission.

slash commands don't appear

Reinvite the bot with the applications.commands scope and wait a minute. Discord can take a moment to show new commands.

automod isn't deleting anything

AutoMod starts in Preview. Run .automod mode live once you are happy with the results, and make sure the module is on with .automod status.

anti-raid reported a false alarm

Run .antiraid incident (id) to see why it fired, then .antiraid falsepositive (id). Use .antiraid pause (duration) before events that bring many people at once.

the verification page doesn't open

Members need a browser that allows the captcha to load. If someone is stuck, use .verification approve @member.

logs are empty

Run .logs list. Each log type needs a channel, and scraps needs Send Messages there. Names of who did an action require View Audit Log.

can I change the prefix?

Yes, with .prefix. Anyone can set a personal prefix with .selfprefix.

does scraps read my messages?

scraps reads message text to run prefix commands, AutoMod, anti-raid, autoresponders and message logs. Text is processed as messages arrive and is not kept, except for features you use on purpose: AFK notes, ticket transcripts, and the message and security logs posted to channels you chose.

what does scraps store?

Server settings, IDs and counters (levels, message counts, voice time), and the data of features you enable. Alt detection stores hashed network and device signals only, and verification forget deletes them. The privacy policy has the details.

how do I remove my data?

Ask a server admin to remove the feature, or ask in the support server. You can remove some of your own data yourself: fmlogout deletes your Last.fm session and timezone reset forgets your timezone.

where do I get help?

Join the support server or use .help in Discord.