Handling permissions

Sometimes you may need a user to have a certain permission to use a command, or maybe your bot needs a permission to make the command work. Well, Commando makes both of these very simple.

User and client permissions

First, go grab the command you want to use permissions with.

const { Command } = require('discord.js-commando');

module.exports = class MeowCommand extends Command {
	constructor(client) {
		super(client, {
			name: 'meow',
			group: 'first',
			memberName: 'meow',
			description: 'Replies with a meow, kitty cat.',
		});
	}

	run(message) {
		return message.say('Meow!');
	}
};

You can then use the userPermissions and clientPermissions options to check for certain permissions. If you wanted to restrict the meow command, requiring the user to have the ability to manage messages, and the client full administrator access, you'd do the following:

super(client, {
	name: 'meow',
	group: 'first',
	memberName: 'meow',
	description: 'Replies with a meow, kitty cat.',
	clientPermissions: ['ADMINISTRATOR'],
	userPermissions: ['MANAGE_MESSAGES'],
});

All you need to do is set the properties to an array of permission flags. A list of those can be found here.

Owner-only commands

Another thing you may want to do is set a command as owner-only. This will make a command only usable by the bot owner(s). Doing this is even simpler than the client/userPermissions, all you have to do is set the ownerOnly parameter to true.

super(client, {
	name: 'meow',
	group: 'first',
	memberName: 'meow',
	description: 'Replies with a meow, kitty cat.',
	ownerOnly: true,
});
Last Updated: 1/4/2019, 3:46:06 AM