Bot commands and server tools

Submit this server to the directory from inside Discord. Opens a form for the description, invite and tags.

Push the listing back to the top. Any member can run it. Cooldown: 6h free, 2h Silver, 30m Gold, 15m Platinum.

Posts the invite link recorded on the listing, so nobody has to go and find it.

One vote each, and you earn credits for it. Votes push the listing up the rankings.

A star rating and a few words. Opens after 30 days of membership, and shows on the listing rather than in chat.

rating

How would you rate this server?

comment

What do you want other people to know? (10-1000 characters)

Every tool the bot can run for this server, whether it is switched on here, and what it needs. Read live, not from a list somebody wrote once.

A walkthrough of each tool: what it does, what to switch on, and where its settings are. Paged, so you can read one tool at a time.

This. Every command, grouped, with what each one is for.

What discords.ai holds about you and how to turn parts of it off. Applies across every server the bot is in, not just the one you run it in. Warnings and bans stay, because they are a server's own record of something it did; use /appeal if you think one is wrong.

/privacy status

What we hold about you, and what you have turned off

/privacy optout <area>

Tell us to stop keeping something

/privacy optin <area>

Turn something back on

/privacy delete

Ask for what is already held to be removed

Opens a ticket without hunting for the panel channel, as the panel's button does: it asks what it is about when several ticket types are switched on, and shows the type's questions when it has an opening form. Same private thread, same staff, same rules about who may open one.

Flag a member. Enough weighted reports from different people mutes them and opens a review ticket for staff. Use the right-click version where the message still exists - it carries what was said.

member

Who are you reporting?

reason

What did they do?

Right-click any message → Apps. The report carries the message with it, so the automated check can have an opinion too.

Attach a correction to a misleading message. Readers vote on whether it helps, and the note says so.

Bans somebody and tells them why first, because after a ban the bot can no longer reach them. You can only ban somebody below you in the role list, and the appeal link goes out with the notice if appeals are on. Pick how much of their recent messages to delete, from none to the last 7 days; leave it empty to use the default set on the Moderator Commands page.

member

Who

reasonoptional

Why. They are told this.

delete_messagesoptional

How much of their recent messages to delete. Leave empty for this server's default.

Start typing a name and pick from this server's actual ban list, so you never have to go and find a user id.

member

Start typing a name

reasonoptional

Why

A ban that lifts itself. Type the length the way you would say it: 3d, 1w, 30d. The unban happens on a sweep that runs every ten minutes, so the length is a floor rather than an exact moment, and they need a new invite to come back. Like /ban, it can delete their recent messages, up to the last 7 days.

member

Who

length

3d, 1w, 30d. A bare number means minutes.

reasonoptional

Why. They are told this.

delete_messagesoptional

How much of their recent messages to delete. Leave empty for this server's default.

Bans and immediately unbans, which is how Discord deletes somebody's last seven days of messages in one go. They can rejoin with a new invite. Use it on a spam run where the person is worth keeping and the mess is not.

member

Who

reasonoptional

Why. They are told this.

Does whatever your mute mode says: Discord's timeout, your muted role, or both. Leave the length out and it lasts until you lift it. A muted role can be scoped so somebody is silent in general but can still answer in their own ticket, which a timeout cannot.

member

Who

lengthoptional

30m, 2h, 3d. Leave it out for until you lift it.

reasonoptional

Why. They are told this.

Lifts both halves whatever your settings say now, because a server that switched from a muted role to a timeout last week still has members carrying the role.

member

Who

reasonoptional

Why

Removes somebody and tells them why first. They can come back with a new invite, which is the whole difference between this and a ban.

member

Who

reasonoptional

Why. They are told this.

Type the length the way you would say it: 30m, 2h, 3d, 1w. A bare number means minutes, and the reply says the length back in words so a slip is obvious straight away. Discord will not hold a timeout longer than 28 days.

member

Who

length

30m, 2h, 3d, 1w. A bare number means minutes.

reasonoptional

Why. They are told this.

Lifts a timeout before it runs out, and tells them it has been lifted.

member

Who

reasonoptional

Why

Deletes up to 100 recent messages in the channel you run it in, optionally only one member's or only the ones containing something. Pinned messages are always left alone. There is no undo, so above 25 it asks first.

count

How many recent messages to look at (1 to 100)

memberoptional

Only this member's messages

containsoptional

Only messages containing this

reasonoptional

Why

Sets how long members must wait between messages in this channel. 0 switches it off. Discord only allows two channel edits every ten minutes per channel, so changing it repeatedly will be refused.

seconds

0 to 21600. 0 switches it off.

reasonoptional

Why

One member's whole record on one timeline: what a moderator did by hand, the warning ladder, report cases, honeypot catches and appeals. Other bots show you their own command's cases and nothing else. Each entry says whether it still counts, so a warning somebody took back and a report staff threw out do not read like a ban. Only you see the answer.

memberoptional

Who

idoptional

Their user id, if they have left the server

Pick a ready-made template or describe the server, and the bot lays out categories, channels and roles. Shows the plan first, creates nothing until you confirm, and only ever adds. A template is free; describing one costs credits.

templateoptional

Start from a ready-made layout instead of describing one

descriptionoptional

What is this server for? e.g. "a competitive Valorant team with weekly scrims"

Pick where the bot posts the moment the bump cooldown ends. Run it with no channel to see or clear the current one.

channeloptional

Channel to send bump reminders to (omit to view or clear current setting)

Which invite links people actually used, and what the listing sent you.

Your balance in this server's own currency, what you have earned in total, and your daily streak. This currency is minted by this server and spends only in its shop.

memberoptional

Whose balance? Leave blank for your own.

One claim per day, resetting at midnight UTC. Every seventh day in a row pays a streak bonus, and missing a day starts the streak again.

The items your server stocks, with a Buy button on each. Roles are granted the moment you buy them; anything your staff hands over says so.

Move currency to another member. Your server can switch this off, set a minimum, or take a percentage fee, which is destroyed rather than paid to anyone.

member

Who are you paying?

amount

How much?

The top balances in this server. Ranked by what people hold, with lifetime earnings beside it so spending does not push somebody down the board.

Mint currency for a member, or take it back. Every grant is written to the ledger with your name on it, so the history says who did it and why.

member

Who?

amount

How much? A negative number takes it away.

reasonoptional

What is this for?

Votes, members, categories and when the listing was last bumped, with a chart.

rangeoptional

Chart lookback period (default: 7 days)

Member count and growth read from Discord itself, plus how many arrived through the listing.

rangeoptional

Time period to show (default: 30 days)

Views, clicks, joins, votes and bumps on the listing, charted.

rangeoptional

How many days to chart (default 7)

Silences every channel that is not already locked or private, and unlocks on its own after the time you set. What each channel was before is remembered, so unlocking puts it back rather than granting permissions it never had.

reasonoptional

What is happening, for the log

Puts every channel back exactly as it was before the lockdown. A channel somebody unlocked by hand in the meantime is left alone.

Records a warning, tells the member what it was for and how many they have, and carries out whatever step that number reaches. Test mode is on until you turn it off, so you find out what it would do before it does it.

member

Who

reasonoptional

What for. They are told this

Shows how many warnings still count, what they were for, and any private notes staff have written. Only you see the answer.

member

Who

A note is never shown to the person it is about and never counts towards anything. It exists so the next moderator is not starting from nothing.

member

Who

text

What to write down

The same panel as right-clicking a member, for when you have their name but not their message: cases, tickets, reports, warnings and how long they have been here. Only staff can see it, the answer is private to you, and nothing is pooled from other servers.

member

Who

Right-click a member → Apps. Shows what THIS server knows about them - cases, tickets, reports, how long they have been here. Nothing is pooled from other servers, and only staff can see it.

Calls up an answer somebody already wrote, by name, with the name completed as you type. Staff-only replies are the canned answers for tickets and only staff see them in the list.

name

Start typing and pick one

Posts one of Discord's own polls: it renders natively, counts itself, stops at the time you set and announces the result without anybody having to come back to it. Two answers are required and four more are optional. Only you get the button to end it early, because Discord offers that to the message's author and the author is the bot.

question

What are you asking?

a

First answer

b

Second answer

coptional

Another answer

doptional

Another answer

eoptional

Another answer

foptional

Another answer

lengthoptional

How long it runs. A day if you do not say.

multipleoptional

Let people pick more than one answer

Posts your idea on the server's suggestion board, where people vote with buttons and staff answer it. You are told what was decided.

idea

What you are suggesting

Staff only. On a board set to anonymous, this says who wrote a suggestion, privately. Deciding a suggestion is done with the button on it rather than here.

number

The suggestion's number

Starts, ends, rerolls and lists giveaways. The draw seed is committed before entries open, so the result can be verified afterwards rather than taken on trust.

/giveaway start <prize> <minutes> [winners] [channel] [role]

Open a giveaway in a channel

/giveaway end [id]

Draw the winners now

/giveaway reroll [id]

Draw a replacement winner

/giveaway list

Every giveaway in this server

Sets the day and month this server greets you on. No year is asked for or stored, and it applies to this server only.

dayoptional

Day of the month

monthoptional

Month

removeoptional

Forget the birthday you told this server

Lists the next birthdays this server knows about. Only the day and month, because that is all that is stored.

Sets a reminder for yourself. Say how long with 30m, 2h30m or 3d - a bare number means minutes. It arrives within a minute of the time you asked for, in this channel or by direct message.

in

How long from now: 30m, 2h30m, 3d

about

What to remind you about

whereoptional

Where it should arrive

Lists your own reminders in this server, soonest first, and offers a menu to cancel one. Also shows any that could not be delivered.

Staff start notes in a channel and the bot posts a notice everybody can see. Messages posted there until it stops go into the record, anybody can add a note, and Stop posts a write-up with a link to the full transcript. Silver and up also get an AI summary.

/meeting start [title]

Start taking notes in this channel

/meeting note <text>

Put something on the record, with your name beside it

/meeting stop

Stop taking notes and post the write-up

Hands out a role, takes one back, or gives one for a set time that comes off by itself. There are two ceilings and Discord answers the same 403 for both, so this says which: the bot cannot give out a role at or above its own, and you cannot give out one above yours. /role info reads a role's permissions back in words.

/role add <member> <role> [reason]

Give a member a role

/role remove <member> <role> [reason]

Take a role off a member

/role temp <member> <role> <length> [reason]

Give a role that comes off by itself

/role info <role>

What a role can do, and how many hold it