Add the bot
Open the invite link and pick your server. You need Manage Server there to add a bot.
Every module is on from the start, and its slash commands appear in your server right away. A module that needs a channel, like welcome cards or the mod log, does nothing until it has one.
Permissions
The invite asks for the permissions the modules use, and nothing else:
- View channels, read message history, send messages and messages in threads, embed links, attach files, add reactions, use external emojis, send polls, mention everyone
- Manage messages, channels, roles, webhooks and nicknames
- Kick, ban and time out members, move members between voice channels
- View the audit log, create invites
The bot can only manage roles below its own. After adding it, drag its role above the roles it should hand out or take away.
/setup
/setup opens the server settings panel. From there you can:
- Pick which modules run, from one menu. Commands of a module you turn off disappear from the server.
- Change the bot's name, picture, banner, bio and text-command prefix in this server only, with Edit profile.
- Choose the staff category, where private channels like the mod log go. Leave it empty and the bot makes one named Staff when it first needs it.
- Start Quick setup.
Quick setup
Quick setup looks at your server first and lists what already works. Then it goes through what's missing one area at a time (members, staff and safety, community) and shows, for each feature, the channel it would use or make.
It builds on what you have. A channel a module already uses, a panel the bot posted before, or a channel with a decorated name like 〔📈〕joins is used as it is. Only what's missing gets made, named in your server's style and placed in the category it belongs in. Nothing changes until you confirm the review, and running it again makes nothing twice.
It covers welcome cards, tickets, applications, the mod log, server logs, staff alerts, suggestions, a suggestion panel, staff suggestions, ranks, the tag role and server stats channels.
/create
/create what: sets up one feature in a single step: its channels, its settings and its panel. For example, /create what:Tickets makes the support panel, a private tickets category, ticket logs and the reports channel.
Two options are optional:
staffis the role that sees the private channels. Leave it empty and every role that can moderate sees them.namenames the feature's channel or role, for features that make only one.
When the server has Claude and you're allowed to give it orders, Quick setup and /create come back as a plan you confirm before anything is made.
Channel types
Every channel, category and role can be marked with what it is: the rules channel, the mod log, the staff role, and so on. Setup and Claude look up these marks before matching names, so they never make a second mod log next to yours.
/setmarks one channel or role./initgoes through every channel and role at once and suggests marks for you to confirm.
Text commands
Every slash command also works as a text command: the prefix, the command name, then its options in order. With the default prefix !, /timeout member:@rico duration:1h reason:spam can be typed as !timeout @rico 1h spam.
Options can also be named, as in !ban user:@rico duration:3d. Quotes keep words together. The same permissions apply as for the slash command. Private answers to a text command arrive by DM.
Change the prefix in /setup under Edit profile. It can be up to three characters.
Settings
A module's settings live in its own command, named after it: /mod-settings, /tickets-settings, /welcome-settings, /levels-settings and so on. Run one with no options to see the current settings. Every option is optional, so change one thing and leave the rest.
The dashboard, where you sign in with Discord, shows the server's activity, switches modules on and off, and lists moderation cases. It lists the servers you own or have Manage Server in.
Help
/help lists what the bot can do in your server, module by module, with only the commands that are on.
Ouroboros