Server Permissions¶
This section of the document describes the Discord server permissions needed in order for Bernard to work as expected.
| Permission Name | Purpose |
|---|---|
| Create Invite | Create a single-use invite for the DM sent to a kicked or banned member when the server has no vanity invite, so they can rejoin later. |
| Kick Members | Kick members from the server, either as a result of an AutoMod violation or the Kick command. |
| Ban Members | Ban and unban members, either as a result of an AutoMod violation or commands such as Ban, Massban, and Unban. |
| Manage Channels | Create the channels and forums Bernard reports events to (such as OmniLogs), manage OmniLogs forum tags, and change channel permissions for the Lock and Unlock commands. |
| Manage Server | Read the server's invites and vanity invite for invite tracking and the invite commands, and delete invites created by members who leave the server or by the Invite Ban command. |
| Add Reactions | Add reactions to Bernard's own messages, such as vote and Arena prompts and the Lock and Unlock commands' feedback. |
| View Audit Log | Identify which moderator performed an action (such as a ban, unban, voice disconnect, or voice move) so OmniLogs can report it. |
| Video | Granted to Bernard itself by the Lock and Unlock commands, which change the stream permission in locked channels. Discord only lets Bernard change permissions it has. |
| View Channels | Monitor messages sent to text channels. |
| Send Messages | Respond to commands and report events (such as kicks and bans) in OmniLogs channels. |
| Manage Messages | Delete messages that violate AutoMod, honeypot messages, and messages removed by the Cleanup command. |
| Embed Links | Send embeds, which most of Bernard's command responses and OmniLogs events use. |
| Attach Files | Send chart images, such as those produced by the /analysis commands. |
| Read Message History | Read past messages for the Cleanup command and the honeypot channel. |
| Speak | Granted to Bernard itself by the Lock and Unlock commands, which change the speak permission in locked channels. Discord only lets Bernard change permissions it has. |
| Mute Members | Server-mute and unmute members in voice channels with the Voice Mute and Voice Unmute commands. |
| Manage Roles | Add and remove the role set by the Set Silence Role command for the Silence and Unsilence commands, and set channel permission overrides for Bernard's own channels. |
| Use Application Commands | Use Bernard's slash commands. |
| Manage Threads | Rename and manage the threads Bernard creates in OmniLogs forum channels. |
| Create Public Threads | Create posts in OmniLogs forum channels. |
| Send Messages in Threads | Send OmniLogs events to posts in OmniLogs forum channels. |
| Timeout Members | Time out members with the Timeout and Remove Timeout commands, and when a TIMEOUT punishment is applied. |
| Pin Messages | Pin and unpin Arena messages while a fight is in progress. |
Note
Denying Bernard one of the above permissions may prevent some features from working as expected!
The integer for these permissions is 2253228165164791.
Invite Link¶
Use the link below to invite Bernard to your server with all of the above permissions:
Servers that invited Bernard with an older link keep the permissions they granted at the time. To give Bernard a permission it is missing, such as Timeout Members, either invite Bernard again with the link above or grant the permission to Bernard's role in your server settings.
Honeypot Permissions¶
To run a honeypot channel, Bernard needs the following permissions:
- In the honeypot channel: View Channels, Send Messages, Embed Links and Read Message History to post and keep track of the warning, and Manage Messages to delete posts. If any of the first four are missing, the honeypot stays unarmed and won't punish anyone. Check the channel's permission overrides, since they can take away permissions Bernard's role has elsewhere.
- In the server: the permission for the punishment you choose. Kick Members for a kick, Timeout Members (called Moderate Members in some Bernard messages) for a timeout, or Ban Members for a temporary or permanent ban. The invite link includes all three, but servers that added Bernard with an older invite may be missing Timeout Members. Invite Bernard again or grant the permission to its role, as described in Invite Link.
- In the role list: Bernard's role must be above the roles of the members you want it to punish.
The /configuration honeypot status command lists any of these that Bernard is missing.
Who Can Configure a Honeypot¶
Configuring the honeypot from Discord requires the CONFIG_CHANGES administrative capability and the capability for the chosen punishment: KICK_MEMBERS for a kick, TEMP_SILENCE_MEMBERS or PERMA_SILENCE_MEMBERS for a timeout, TEMP_BAN_MEMBERS for a temporary ban, or PERMA_BAN_MEMBERS for a permanent ban. This stops a member from using the honeypot to issue a punishment they couldn't issue by hand. Turning the honeypot off or checking its status only requires CONFIG_CHANGES.
On the Bernard dashboard, the server owner and administrators can configure the honeypot.