You can set custom permissions for ATOS commands according to what you want to do.
How it works
It is possible to write “rules” allowing or prohibiting a member, a role or a channel from using a command or a module. You can accumulate several rules to properly frame the context where members can use the bot.
If no rule is applicable, then the command will behave correctly (relying on permissions, moderator and administrator roles, whitelist/blacklist and channels ignored by the bot).
The rules defined on the subcommands override the rules of the parent command. Same for the commands which override the rules defined on the module.
If for example a member does not have the right to use the
!checkin command but can use
!checkin call, the member will not be able to use any
!checkin subcommand except
!checkin call. In addition, if a member does not have the right to use the Tournaments module but can use
!bracket, he will not be able to use any tournament command except
Finally, there is also an order of precedence on the “objects” that define your rule. By object, I mean a member, a role, a text or voice channel, or the entire server; what your rule applies to:
- Voice channel
- Text channel
- Category of channels
- Role, from highest to lowest
- Server (default rules)
- Default commands
For example, if a role X does not have permission to use Audio commands but channel Y has permission, in this case members with role X will be able to use commands from the Audio module only when connected to the channel Y.
In DM, only global rules will be applied.
||Base command for permissions|
||Brief explanation of the system|
||Checks if a user can execute a certain command in the current channel|
||Add a permissions rule|
||Take off one of your rule|
||Adds a default permissions rule (will apply everywhere, minimum priority over other rules)|
||Clears all custom rules from the server|
||Set or display permissions from a YAML file|
To prohibit tournament commands from everyone except a role :
!permissions setdefaultserverrule deny Tournaments
!permissions addserverrule allow Tournaments @Games
To give access to audio controls only to users in a certain voice channel :
!permissions setdefaultserverrule deny Audio
!permissions addserverrule allow Audio "Voice - Music"
To give access to the
!setscorecommand to a role other than mod or T.O :
!permissions addserverrule allow setscore @Score Checker