The bot ยท The bot
Permissions
Decide who can use which command.
Overview
Two commands control access. /bot setperm makes permission groups: a group has members and roles, a level, and a list of commands. /bot setcmd changes the access of a single command.
Levels stack: members of a group also get the commands and bypasses of every group with a lower level.
Why use groups
Giving a role a Discord permission such as Ban Members or Manage Channels gives it that power everywhere, with every tool Discord has, and the bot cannot watch or limit it. If one of these accounts is hacked, or a moderator turns against you, the damage is done before anyone reacts. This is how most raids and server wipes happen.
A permission group is safer. It only unlocks the bot commands you pick, and nothing else: the people in it get no Discord permission. They can only do what the commands allow, and the bot sees every action, so its protections, like Anti-Raid, still apply to them. They only skip the Anti-Raid modules you choose in Bypass Anti-Raid, and none by default.
Permission groups
A permission group lets you give commands to people without giving them the Discord permission. A moderator can run your moderation commands without being an administrator, for example. You create groups with /bot setperm.
Run /bot setperm to see your groups. Open one to edit it.
- Members and roles
- Who is in the group. Pick up to 25 members and 25 roles. Anyone who is selected, or who has a selected role, is in.
- Commands
- The commands the group unlocks. People in the group can use them even if they do not have the Discord permission the command asks for.
- Level
- A number that ranks the groups. A group also gets the commands and the bypasses of every group with a lower level, so a higher group does not need everything repeated. You can disable the level.
- Bypass Anti-Raid
- The Anti-Raid modules this group is exempt from, such as the one that watches mass joins.
- The member group
- A built-in group that is always there and cannot be deleted. Everyone is in it, so a command given to it can be used by every member.
/bot setpermLists your permission groups. A group is made of roles and members, can have a level, and gets the commands you give it.
/bot setperm โบ moderatorOpens one group: its name, level, members, roles, the Anti-Raid modules it bypasses and its commands.
Example: a moderator team
To let your moderators use some commands without making them administrators:
- 1Run
/bot setpermand press New Group. Name itmoderator. - 2Open the group, and pick your moderator role in Roles.
- 3Press Add a command and select the commands you want them to have.
- 4Optionally set a Level, and choose the Anti-Raid modules the group can bypass.
Changing one command
/bot setcmd is for the other direction: it changes who can use one command. Pick the command, then choose either a level (Default, Owner, Buyer or Off) or the Discord permission it requires, among 19 such as Administrator, Ban Members or Manage Messages. Only commands that you changed are listed, and a command goes back to its default when you remove its custom access.
/bot setcmdLists the commands that do not use their default access.
/bot setcmd โบ EditPick who can use a command: its default, owners, the buyer, nobody, or anyone with a Discord permission.
How the bot decides
Every command has a required level. For most of them it is a Discord permission (for example Administrator or Manage Messages), and a few have none. When someone runs a command, the bot checks these, in this order:
- 1The command's access is read: its default level, or the one you set with
/bot setcmd. - 2If it is Off, nobody can use it. If it is Owner or Buyer, only the bot owners or the buyer can.
- 3Otherwise, anyone who has the matching Discord permission can use it.
- 4The owners of the bot can always use it.
- 5If none of that applies, the person can still use it when a permission group that holds this command includes them, as a member or through one of their roles.
Need a hand?
Our support server is the fastest way to get help or suggest a feature.