Permissions
This page covers everything to know about setting up permissions for Slash & context commands.
Application command (Slash, User & Message) permissions are set up at creation. When you add your commands to a guild or globally, the permissions will be set up from the attributes you defined.
Commands that are added will only show up for members that meet the required permissions. There is no further internal handling, as Discord deals with this on its own.
Warning
Permissions can only be configured at top level commands. Not in subcommands.
Disallowing commands in DM
Commands can be blocked from being executed in DM if a guild is required to execute them in as followed:
[EnabledInDm(false)]
[SlashCommand("ban", "Bans a user in this guild")]
public async Task BanAsync(...)
{
...
}
Tip
This attribute only works on global-level commands. Commands that are registered in guilds alone do not have a need for it.
Server permissions
As previously shown, a command like ban can be blocked from being executed inside DMs,
as there are no members to ban inside of a DM. However, for a command like this,
we'll also want to make block it from being used by members that do not have the permissions.
To do this, we can use the DefaultMemberPermissions
attribute:
[EnabledInDm(false)]
[DefaultMemberPermissions(GuildPermission.BanMembers)]
[SlashCommand("ban", "Bans a user in this guild")]
public async Task BanAsync(...)
{
...
}
Stacking permissions
If you want a user to have multiple permissions in order to execute a command, you can use the |
operator, just like with setting up intents:
[DefaultMemberPermissions(GuildPermission.SendMessages | GuildPermission.ViewChannels)]
[SlashCommand("ping", "Pong!")]
public async Task Ping()
=> await RespondAsync("pong");
Nesting permissions
Alternatively, permissions can also be nested.
It will look for all uses of DefaultMemberPermissions
up until the highest level class.
The EnabledInDm
attribute can be defined at top level as well,
and will be set up for all of the commands & nested modules inside this class.
[EnabledInDm(true)]
[DefaultMemberPermissions(GuildPermission.ViewChannels)]
public class Module : InteractionModuleBase<SocketInteractionContext>
{
[DefaultMemberPermissions(GuildPermission.SendMessages)]
public class NestedModule : InteractionModuleBase<SocketInteractionContext>
{
// While looking for more permissions, it has found 'ViewChannels' and 'SendMessages'. The result of this lookup will be:
// ViewChannels + SendMessages + ManageMessages.
// If these together are not found for target user, the command will not show up for them.
[DefaultMemberPermissions(GuildPermission.ManageMessages)]
[SlashCommand("ping", "Pong!")]
public async Task Ping()
=> await RespondAsync("pong");
}
}
The amount of nesting you can do is realistically endless.
Note
If the nested class is marked with Group
, as required for setting up subcommands, this example will not work.
As mentioned before, subcommands cannot have seperate permissions from the top level command.
NSFW Commands
Commands can be limited to only age restricted channels and DMs:
[NsfwCommand(true)]
[SlashCommand("beautiful-code", "Get an image of perfect code")]
public async Task BeautifulCodeAsync(...)
{
...
}