Permissions

Permissions are a way to enable or disable text commands for the server, or specific sections of it (based on role, channel or user).

Due to how slash commands are implemented, this system also works with most slash commands. However, you should check out Discord's built-in command permissions for finer grained control. Discord's built in system also has the advantage of hiding commands that users cannot run from their command list.

The permission system is simple: for each command invocation, go down the list of permissions, return the result from the first permission matching the invocation. For example, if you have 3 permissions configured:

1. #general - All commands - Disabled
2. @user1 - Group Fluff - Disabled
3. Server - Group Fluff - Enabled

When @user1 executes a command from group Fluff, they will be disallowed from doing so, because the check stops at permission 2 and never gets to permission 3. Therefore, it is important to order your permissions correctly.

Members with the Manage Server permission can edit command permissions and are always able to run commands, in order to prevent lockouts.

permissions¶

(aliases: permission, perms, perm)

The base command. Alias of permissions list.

permissions list¶

(aliases: permissions ls)

List the command permissions for this server.

permissions move¶

(aliases: permissions mv)

Move a permission from one position to another in the list.

Options

• source: The position of the permission to move.
• destination: The new position.

permissions delete¶

(aliases: permissions remove, permissions del, permissions rm)

Delete the permission at the given position.

Options

• position: The position of the permission to delete.

permissions reset¶

Reset all permissions for this server.

permissions server¶

Enable or disable a command or group at the server level.

Options

• command_or_group: The command or group name.
• is_allowed: Whether the command is enabled or not.

permissions serverall¶

Enable or disable all commands at the server level.

Options

• is_allowed: Whether the command is enabled or not.

permissions role¶

Enable or disable a command or group at the role level.

Options

• command_or_group: The command or group name.
• role: The role to apply this permission to.
• is_allowed: Whether the command is enabled or not.

permissions roleall¶

Enable or disable all commands at the role level.

Options

• role: The role to apply this permission to.
• is_allowed: Whether the command is enabled or not.

permissions channel¶

Enable or disable a command or group at the channel level.

Options

• command_or_group: The command or group name.
• channel: The channel to apply this permission to.
• is_allowed: Whether the command is enabled or not.

permissions channelall¶

Enable or disable all commands at the channel level.

Options

• channel: The channel to apply this permission to.
• is_allowed: Whether the command is enabled or not.

permissions member¶

Enable or disable a command or group at the member level.

Options

• command_or_group: The command or group name.
• member: The member to apply this permission to.
• is_allowed: Whether the command is enabled or not.

permissions memberall¶

Enable or disable all commands at the member level.

Options

• member: The member to apply this permission to.
• is_allowed: Whether the command is enabled or not.