Documentation

Getting started

Three things, in this order. The second one is the step people skip, and it is the reason a bot appears to do nothing.

  1. Add the bot to your server

    Use the invite link. It requests the 29 permissions the code actually uses and nothing else. You can untick any of them — a feature’s own command tells you later if it is missing one, rather than failing silently.

  2. Move its role above the roles it manages

    Server Settings → Roles, and drag sick above them. Discord refuses to let any bot ban, kick, timeout or assign a role to someone whose highest role sits above the bot’s own. This is a Discord rule, not ours, and no permission can override it.

  3. Type a feature’s name

    /welcome, /logs, /antinuke — each opens one panel with every setting and what it holds, what is still needed before the feature can run, and a live warning if the bot is missing a permission that feature needs. Every setting is changed from that panel. Changing one never switches anything on: Turn on does, and the same button is Turn off afterwards. Most modules stay off until somebody presses it; the handful that start on are named below.

Modules

59 modules

Each one is set up from the command on its card. Most stay off until somebody presses Turn on on its panel; the exceptions, on from the moment the bot arrives, are Activity, AFK, Created channels, Giveaways, Language, Listening, Music sources, Premium, Quotes, Text commands, Transcribe, Moderation log, Punishment ladder and Snipe. Every card below says which it is.

Activity

Count messages, voice time and channel usage, so the server can be reported on

/logs activity4 settings on by default

Activity ping

A role for everyone, pinged when chat goes quiet

/activity-ping config16 settings off until enabled

AFK

Members can say they are away; anyone who mentions them is told

/afk config4 settings on by default

Applications

Openings people apply for, reviewed and voted on by staff

/applications config6 settings off until enabled

Automatic roles

Give roles to new members once they are through verification and screening

/autorole join3 settings off until enabled

Birthdays

Members share a birthday and the server celebrates it on the day

/birthday config6 settings off until enabled

Bump reminder

Reminds the server to bump on Disboard when the cooldown ends

/activity-ping bremindconfig6 settings off until enabled

Command channels

Keep commands to the channels meant for them

/identity commands3 settings off until enabled

Counting

A channel where members count upwards together, and the bot keeps the number

/counting config13 settings off until enabled

Created channels

One category for every channel I make for you, made the first time I need it

/identity channels1 setting on by default

Custom commands

Commands the server writes itself, and replies to what people say

/custom config2 settings off until enabled

Events

Sign-ups, reminders, attendance and what happened afterwards

/event config8 settings off until enabled

Giveaways

Who can run a giveaway, and what the bot does when one ends

/giveaway config6 settings on by default

Goodbye messages

Say goodbye when a member leaves, with an optional card

/goodbye1 setting off until enabled

Guild Management

Ranks, rosters, contributions, promotions, and who is due one

/guild config5 settings off until enabled

Join to create

A voice channel that makes members their own, with a control panel

/voice config13 settings off until enabled

Language

The language the bot answers in, in this server

/identity language1 setting on by default

Levels

Earn XP for chatting and in voice, level up, with role rewards and level-up announcements

/level config10 settings off until enabled

Listening

Who knows an artist, crowns and server lists from /fm

/fm config3 settings on by default

Live stat channels

Locked voice channels whose names show live counts

/counters21 settings off until enabled

Modmail

Members message the bot; staff answer in a private channel

/modmail config16 settings off until enabled

Music

A voice player with a queue, a panel, a DJ role and votes

/music config15 settings off until enabled

Music sources

Which sites and link kinds the music player may play from

/music sources8 settings on by default

Partnerships

Partner applications, verification, renewals and how announcements go out

/partner config7 settings off until enabled

Polls

Ask the server something, and say what it answered

/poll config6 settings off until enabled

Premium

The paid tier: a supporter role for whoever activates it, and unlocked limits

/premium config1 setting on by default

Quotes

Who may turn a message into a quote card with /quote, and how often

/quote config2 settings on by default

Reviews

Ratings out of five with the whole review, posted where you choose

/review config8 settings off until enabled

Rotating status

A few short lines that take turns as the bot’s status, or as a channel’s name

/identity status6 settings off until enabled

Social alerts

Post when a YouTube channel uploads or a Twitch streamer goes live

/alerts config2 settings off until enabled

Starboard

Pin the messages a server reacts to onto a board of their own

/starboard config5 settings off until enabled

Status rewards

Give a role to members who put something in their custom status

/autorole vanity5 settings off until enabled

Sticky messages

Keep one message at the bottom of a channel, posted again as people talk

/sticky config1 setting off until enabled

Suggestions

Members suggest, the server votes, staff answer

/suggest config11 settings off until enabled

Text commands

Run commands with a prefix as well as with slash

/prefix1 setting on by default

Tickets

Private support channels members open from a panel

/ticket config9 settings off until enabled

Transcribe

Whether /transcribe may write out a voice message as text

/transcribe config1 setting on by default

Welcome messages

Greet members when they join, with an optional card and DM

/welcome3 settings off until enabled

AI image scan

Send images to OpenAI’s model, and do what you choose with the bad ones

/filter ai25 settings off until enabled

Anti-nuke

Catch mass channel, role and webhook destruction

/antinuke15 settings off until enabled

Anti-raid

Catch coordinated floods of new accounts joining

/antiraid config16 settings off until enabled

Anti-spam

Catch message floods, repeated text and mass mentions

/filter spam18 settings off until enabled

Appeals

Let banned and muted members appeal, with a staff vote

/appeal config8 settings off until enabled

Auto-delete

Remove a channel’s messages on their own: after so many newer ones, after an age, or both

/autodelete config1 setting off until enabled

Auto-nuke

Wipe channels on a schedule, on a phrase, or when the server is under attack

/moderation autonuke3 settings off until enabled

Jail

Hold a member in one channel, and give their roles back after

/moderation jail3 settings off until enabled

Link filter

Block invites, phishing, and content that breaks Discord’s own rules

/filter links19 settings off until enabled

Moderation log

Record every moderation action to a channel

/logs moderation1 setting on by default

Moderator watch

Alert when one moderator takes an unusual number of actions

/moderation watch6 settings off until enabled

Pic perms

Images off for everyone, on for one role

/picperms config5 settings off until enabled

Punishment ladder

Escalate automatically: what happens on a member’s 1st offence, 2nd, 3rd…

/moderation ladder13 settings on by default

Server logs

Record edited and deleted messages, so nothing is lost

/logs server12 settings off until enabled

Snipe

Who can read back a deleted or edited message with /snipe

/logs snipe2 settings on by default

Temporary roles

Lend a role for a while; the bot takes it back when the time is up

/role config4 settings off until enabled

Term lists

Named lists of words with their own action: block, alert, time out, relay or nuke

/terms config6 settings off until enabled

Webhook relay

Post a blocked message back through a webhook under its author’s name

/filter repost6 settings off until enabled

Word blacklist

Block words before they are ever posted, using Discord AutoMod

/filter words13 settings off until enabled

Member screening

A risk profile for every account that joins, and why

/screening config21 settings off until enabled

Verification

Make new members prove they are a person before they can talk

/verify config16 settings off until enabled
Variables

26 variables for your messages

Type one in curly brackets in a message you write for the bot — the welcome, or anything you build with /message — and it is filled in when the message is sent. One a feature cannot fill (the welcome has no channel) is left exactly as you typed it. Names people choose are escaped, so nobody can break your formatting with theirs.

The member

{user}Mentions the member · also {mention} and {user.mention}@alice
{user.name}Their username, without a ping · also {username}alice
{user.display}The name they show in this serverAlice
{user.id}Their user ID123456789012345678
{user.avatar}Link to their profile picture — works as an image or thumbnailhttps://cdn.discordapp.com/avatars/…
{user.created}How long ago their account was made3 years ago
{user.joined}How long ago they joined this server2 minutes ago

The server

{server}The server’s name · also {server.name} and {guild}My Server
{server.members}How many members the server has · also {count} and {membercount}1,234
{server.members.ordinal}The member count as a place — welcome your 1,234th member1,234th
{server.id}The server’s ID123456789012345678
{server.icon}Link to the server icon — works as an image or thumbnailhttps://cdn.discordapp.com/icons/…
{server.boosts}How many boosts the server has14
{server.level}The server’s boost level, 0 to 32
{server.owner}Mentions the server owner@owner

The channel

{channel}Links the channel · also {channel.mention}#general
{channel.name}The channel’s name, without the linkgeneral
{channel.id}The channel’s ID123456789012345678

Time

{date}Today’s date, in each reader’s own format1 October 2026
{time}The time now, in each reader’s own time zone14:05

Birthday

{birthday}The date of the birthday, without the year14 March
{age}The age they are turning. Empty when they gave no year or the server hides ages25

Counting

{number}The number the channel is at1,234
{number.next}The number that comes next1,235
{number.high}The highest the channel has ever got5,000

Chance

{choose}One of several options at random — {choose:hi|hello|hey}hello
Permissions

What the invite asks for

This list is generated from the permissions the modules and commands declare, so it is exactly the set the code can use — not a padded request.

Kick MembersBan MembersManage ChannelsManage ServerAdd ReactionsView Audit LogView ChannelsSend MessagesManage MessagesEmbed LinksAttach FilesRead Message HistoryConnectSpeakMute MembersDeafen MembersMove MembersManage NicknamesManage RolesManage WebhooksManage Emojis and StickersManage ExpressionsManage EventsCreate Public ThreadsCreate Private ThreadsSend Messages in ThreadsTimeout MembersSet Voice Channel StatusCreate Polls