SkullBot
Getting started
SkullBot permissions and the bot role
Short answer
The bot needs only the permissions of the modules you enable and a role placed above the roles it manages. Module status in the dashboard shows what is missing.
Role hierarchy
Discord lets a bot assign roles, kick and ban only people whose highest role is below the bot highest role. A role managed by an integration or another bot cannot be assigned manually. If a role from a menu, verification or level reward is not given, check its position first.
Permissions by module
| Module | Bot permissions needed |
|---|---|
| Link blocking | Manage Messages; Kick or Ban Members depending on the action |
| Spam detection | Manage Messages; Kick or Ban Members depending on the action |
| Spam filters | Manage Messages; Moderate Members (mutes) |
| Raid protection | Kick, Ban or Moderate Members depending on the action |
| Honeypot | Manage Channels and Messages; Kick or Ban Members depending on the action |
| Bot guard | Manage Messages; Kick or Ban; Manage Webhooks when blocking webhooks |
| Warning escalation | Moderate Members (mute), Kick or Ban Members |
| Modlog | View Audit Log; send messages in the log channel |
| Role menus, verification, auto-roles, level rewards | Manage Roles and a bot role above the roles it gives |
| Tickets | Manage Channels; send messages and files in the transcript channel |
| Voice verification | Move Members; Manage Roles |
| Live notifications | View Channel, Send Messages and Embed Links in the channel; a role ping needs a mentionable role or Mention @everyone |
A module does not work: what to check
- Open Overview in the dashboard and look at Module status. Every problem says what to grant the bot.
- Check that the bot role is above the target role.
- Check the bot permissions in the specific channel (a channel can override them).
- After fixing, click Check again.
Frequently asked questions
What does "role is above the bot role" mean?
The bot cannot assign a role that sits higher than its own. Drag the bot role higher in Server settings, Roles.
Can I give the bot Administrator?
You can, but you do not have to. The specific permissions from the table are enough and safer.