Permissions

When making more complicated bots, you'll want to start restricting command access. Discord slash permissions can be managed from the regular Discord UI, but it all starts from a default permission level.

Permissions are defined by vanilla Discord permissions. For example, to make a command only available if the user has the "Manage Messages" permission, you'd define the permission object as Permissions(Permission.ManageMessages). You can also combine permissions by specifying more than one in the constructor, for example Permissions(Permission.ManageMessages, Permission.ManageNicknames). In this case, both the "Manage Messages" and the "Manage Nicknames" permissions are needed.

Global permission level

If you want, you can set a default permission level for all registered commands. This is done in the configure block.

configure {
    defaultPermissions = Permissions(Permission.UseApplicationCommands)
}

Category permission level

You can also specify a permission level for a category. To do this, you need to pass the desired permissions in the commands builder.

fun adminCommands() = commands("Administration", requiredPermissionLevel = Permissions(Permission.Administrator)) {
    // ...
}

Command permission level

Lastly, you can also set the permission level directly in the command.

slash("ban") {
    requiredPermissions = Permissions(Permission.BanMembers)
    execute(UserArg) {
        args.first.asMemberOrNull(guild.id)?.ban()
    }
}

The narrowest permission level will be the permission level for a command (global > category > command).