Bot configuration

In Discord: the /config command

Type /config in any channel of your server. You need the Administrator Discord permission (see Permissions and roles). The command itself is detailed in the next section.

The /config screens are shown in your Discord language. The bot's logs and public messages use the server language (set in Language and time zone).

On the website: the dashboard

Sign in on the website, open the dashboard and pick your server (see Managing your servers). The server dashboard is open to the server owner and to members with the Administrator or Manage Server permission. The configuration pages are grouped under Configuration in the menu.

Each /config category has its counterpart on the website:

A few settings only exist on the website: they are listed in the Settings only available on the website section at the bottom of the page. To learn how the bot receives changes made on the website, read Synchronisation with the bot.

/config

Configure the app according to your needs.

Syntax

/config

Member permission

Administrator

Bot permission

None checked at launch (each category checks its own)

Where to use it

Server only

Rate limit

None

Plan

Free (some categories have limits depending on the server's plan)

Examples

• /config

The command has the same name in every language.

Result on Discord

How the panel works

1. The main panel is posted in the channel: other members can see it, but only you can use its menu.
2. Pick a category in the dropdown. The main panel disappears and the category opens in a message that only you can see.
3. The Back button returns to the previous screen or to the main panel. End configuration deletes the panel.
4. After 5 minutes without any action (10 minutes in Role/message reaction), the screen is replaced by "Oops.. It seems that what you were looking for no longer exists." with a few suggested commands. Just run /config again. If you had already clicked something on that screen, it simply stops responding.

Every change is recorded in the Server logs channel (if one is set and it is a text channel), with your name and the details of the change. Anti-raid changes go to the Raid logs channel.

The main panel shows the server's language and time zone, plus two recommendations: put the bot's role at the very top of the role list, and give it the Administrator permission.

The menu offers 17 categories, in this order:

In the menu: Welcome · On the website: Welcome and goodbye · Module: Welcome and goodbye

The screen shows the current settings, then a menu with four options: Roles, Join/Leave Channel, Custom Message and Image.

Custom message variables:

Example: Welcome {user} to **{guildName}**! You are member number {guildMemberCount}.

• Roles: select the roles, then click Confirm (Cancel leaves without saving). If you pick a role managed by an integration or placed above the bot's role, it is refused and the screen loses its buttons: run /config again.
• Join/Leave Channel only sets the welcome channel. The goodbye channel is set in Channels or on the website; the goodbye message and image can only be set on the website.
• The picker also lists announcement channels, but the welcome is only sent in a text channel.
• The custom message cannot be emptied from /config: to go back to the default text, use the website. After saving, a technical line (commands.config.welcome.message.success) appears at the bottom of the screen: your message has been saved.
• A new image can take up to an hour to show up on the cards.

In the menu: Channels · On the website: Channels · Module: Logs

The screen lists every channel type with its current channel, after the separator used in the names of channels created by the bot.

Picking a channel

1. In the menu, pick the channel type to set up.
2. Select a channel in the list, or click Create and assign: the bot suggests a name (for example 👋┇welcome), then creates a text channel in the same category as the channel where you typed /config.
3. To remove a channel, clear the selection.

Each type has a single channel, but one channel can serve several types. Log channels created by the bot are hidden from @everyone.

Channel name separator

The Edit current channel name separator button opens a form: up to 5 characters, spaces become -. The separator goes between the emoji and the name in the names suggested by Create and assign (📂┇server, 💧┇levels…). Default: ┇.

In the menu: Role/message reaction · On the website: Reaction roles · Module: Reactions and triggers

This category adds actions to an existing message. There are three kinds:

To create a bot message, use /say, /create-embed or /create-container (see Messages and announcements).

Adding an action

1. Click Add, pick the message's channel and paste the message ID (Discord developer mode → right-click the message → Copy Message ID).
2. If it is a bot message, pick the type: Reaction, Reaction button or Response button. For a member's message, you go straight to reactions.
3. Fill in the form for that type:

For a response button, then click Open the form and give the message to copy (channel + ID). It must not contain stickers or any button other than links, and it cannot be the message that carries the button. The bot keeps a frozen copy: later edits to the original message are not picked up.

Edit and Delete list the messages that have actions. Delete removes every action of a message after confirmation.

Limits

The Help with custom emoji button gets you the <:name:id> code of one of your server's emojis: type the emoji in the channel and the bot shows its code. While this help is open, the messages you send in the channel are deleted.

In the menu: System for managing other commands · On the website: Other commands

Some commands are not available by default. Today this category handles a single pack: the aviation commands /zulu, /metar and /frequencies (see Aviation).

The button reads Enable aviation commands? or Disable aviation commands? depending on the current state. You must wait 60 seconds between two changes on the same server. The commands show up in Discord as soon as the command list refreshes.

In the menu: Antiraid · On the website: Security and anti-raid · Module: Anti-raid and security

The anti-raid protects the server against spam, mass joins, app additions, mass channel creation or deletion, links and forbidden words.

1. Click the green button (labelled Enabled): it is the master switch. While it is off, no protection acts and the protection menu is hidden. Once it is on, the button turns red and reads Disabled.
2. Pick the Anti-Raid log channel in the menu.
3. Open each protection from the menu and turn it on with its button. Each protection screen shows the sanction it applies.

In the menu: Whitelist · On the website: Security and anti-raid

Whitelisted members and apps are not sanctioned by the anti-raid protections. The server owner is always on it, first, with the Global scope.

By default, the list only contains the owner. A member banned, kicked or timed out with the bot's commands is removed from the whitelist.

In the menu: Tickets · On the website: Tickets · Module: Tickets

A ticket system is a panel posted in a channel: members use it to open a private ticket. The menu offers three options:

Button system

1. Add opens a form:

2. Pick the panel's channel (or create it), then the category where tickets will be created (or create it).
3. Pick the roles to mention when a ticket is opened (0 to 10), then Confirm: the panel is posted.

Dropdown menu system

1. Add opens a Description + Image form, then you pick the channel and the category. The panel is posted without a menu.
2. Then add the menu options (up to 25). Each option has the System Name, Channel prefix, Welcome Message and Image fields, plus its roles to mention. The menu appears on the panel with the first option.

Limits

• The bot needs the Administrator permission (otherwise the menu is hidden) and Manage Channels to create ticket channels.
• After adding or editing an option with Confirm, the options screen closes: run /config again to carry on.
• Mentioned roles can read the tickets; they must click Claim to be able to write.

In the menu: Word reaction · On the website: Word reactions · Module: Reactions and triggers

When a message contains a word from the list, the bot reacts to it with the matching emojis.

• The reaction must contain at least one emoji; it can contain several. For one of your server's emojis, use <:name:id> (or <a:name:id> if it is animated).
• The word is matched anywhere in the message, even inside another word (cat also triggers on category).
• If a valid custom emoji is refused ("The reaction is not a valid emoji."), just submit the form again.

In the menu: Temporary channels · On the website: Temporary channels · Module: Temporary channels

In a temporary channel, every new message (from members and bots alike) is deleted after a delay.

• Edit changes a channel's duration and persistence. Delete stops the automatic deletion; the channel itself is not deleted.
• Always pick Yes or No for persistence: if you leave it empty, No is saved, even though the field shows "Yes (default)".
• The screen text mentions 60 seconds, but the duration you pick is the one that applies.

In the menu: Temporary Voice Channel · On the website: Temporary channels · Module: Temporary channels

A creator voice channel creates a personal voice channel for every member who joins it (🔊 Voice of Alex), in the same category. The created channel is deleted when it is empty.

1. Add: pick a voice channel, or click Create and assign.
2. Pick the roles allowed to join the created channels (0 to 25), then Confirm.

• Edit changes the allowed roles. Delete is refused while channels created by this hub still exist; the creator voice channel is not deleted from Discord.
• If your plan goes down, only the oldest creator channels stay active.
• The name prefix of created channels ("Voice of" by default) can only be set on the website.

In the menu: Bump · On the website: Bump · Module: Bump

Bumping promotes your server: /bump shares your card and an invite in the bump channel of every server that turned the system on.

1. Click Enable: the Bump channel / Invite code menu appears.
2. Pick the channel, then enter the invite code. The invite must be permanent (unlimited duration and uses); a vanity URL is not accepted.

The delay between two /bump depends on the server's plan: 12 h on Free, 9 h on Basic, 6 h on Ultimate. The bump description and image can only be set on the website. After turning the system on or off, receiving bumps can take up to an hour to adjust.

In the menu: Leveling · On the website: Levels · Module: Levels and XP

Click Enable: the system starts with the default values and the /rank, /reset-levels and /modify-xp commands are added to the server. Disable removes them and cancels the giveaways that award XP.

• Each message earns a random amount of XP between the min and the max (halved for very short messages).
• Rewards stack: a member keeps the roles of previous levels. Removing a reward does not take the role back from members who already have it.
• Provisional rewards (role removed at the next level) and the level card image can only be set on the website.

In the menu: Daily Streak System (Fire) · On the website: Flames · Module: Flames (streaks)

Each day a member takes part (message, voice activity or command), a flame is added to their streak. The day ends at midnight in the server's time zone.

• The mention and rename buttons only appear once the system is active.
• On a server that never set up flames, you have to click Enable twice: the first click saves the configuration but leaves it inactive.
• Streak freezes, role rewards and the card image can only be set on the website (rewards and image: Ultimate plan).

In the menu: Social networks · On the website: Social networks and RSS · Module: Social networks and RSS

The bot announces new YouTube videos and Twitch lives of a channel in a Discord channel.

• /config accepts up to 6 accounts per platform, but only the oldest ones, within your plan's limit, are checked.
• By default, YouTube is checked every 2 hours and Twitch every 30 seconds.
• The role picked in /config is not always saved: check the "Mention:" line after adding and, if needed, set the role on the website.
• Changing the URL or the platform creates a new entry: delete the old one afterwards.

In the menu: RSS · On the website: Social networks and RSS · Module: Social networks and RSS

The bot posts the latest item of an RSS or Atom feed in a channel.

• The bot checks the feed once the interval has passed and only posts the latest item.
• Edit changes the URL and the interval, but not the channel: to move a feed, delete it and add it again.
• If adding fails with an error message, add the feed from the website.

In the menu: Language and time zone · On the website: Basic configuration page, see Server home

• When the bot joins a server, it posts a message with two buttons, Français and English, to pick the language. Without an answer within 24 hours, the language stays English.
• Your own /config screens always follow your Discord language, whatever the server language.

In the menu: Color · On the website: Basic configuration page, see Server home

• Choose a Color opens the form; the screen takes on the new color right away. Short formats (#FFF), color names and rgb() are refused.
• Remove Color brings back #48D1E1. This button only appears when the color has been changed.
• A member who picked a personal accent color on their website profile sees their own color on the replies to their commands.

These settings have no counterpart in /config:

To go further: Permissions and roles, Premium plans and limits and Troubleshooting.