discordjs / commando-guide

Beginner's guide for discord.js-commando.

Discord.js Commando Beginner's Guide

So I noticed there are very few resources to begin using the Commando command framework for Discord.js. Sure, there are a few tutorials out there, but they don't teach fundamental things such as args or how to properly use Commando's built-in say, embed, etc. That's what this guide is for. In this guide I will attempt to explain everything in commando from using args to when to use async for your commands. It's the least I can do for the people at Discord.js who helped me greatly on learning how to use it.

Before You Begin

Before you start with this guide I recommend you take a look at the official Discord.js guide. It'll teach you the fundamentals for Discord.js, which you can use to aid you in understanding this guide. Please note that I'm going to assume you have read that guide before this one. You can find that guide here.

More Information

Should you need more help after using this guide be sure to the Discord.js Official Server, where a Commando channel is available for all your questions. You can join that server with this link.

Updating of this Guide

I will create a new chapter every once in a while until I deem this tutorial complete. Should anything else come up that you think I should explain, feel free to ask for it to be implemented.

commando-guide's Issues

SQLite Provider section does not work. I get a promise rejection

(node:8470) UnhandledPromiseRejectionWarning: Unhandled promise rejection (rejection id: 1): Error: SQLITE_CANTOPEN: unable to open database file

Here is the code I have:

const sqlite = require('sqlite');
const { CommandoClient, SQLiteProvider } = require('discord.js-commando');
const path = require('path');
const bot = new CommandoClient({
  commandPrefix: config.prefix,
  owner: config.owner,
  unknownCommandResponse: false,
});

// SQL Priver
sqlite.open(path.join(__dirname, 'settings.sqlite3')).then((db) => {
  bot.setProvider(new SQLiteProvider(db));
});

Roles instead of hasPermissions?

Has permissions (in my opinion), is kind of bad. While this isn't an issue, and more of a question... can you check for a role instead of a permission? Because there are certain times you want users to have certain roles, and absolutely no permissions for the server itself. So you either have to try to figure out which permission to give one role and higher. And that is just inefficient, I think.

[suggestion] more "real life" examples

Hey dude,

I've just read your guide. Really cool, thanks for sharing your knowledge.

I'm opening this issue to say that your Xiao bot is a freaking awesome Commando learning resource. I dare to say that it's a must-check after finishing the guide.

IMHO the Xiao's repo should be mentioned somewhere in the guide.

Cheers!

User Permissions

I done this:

userPermissions: ['MANAGE_MESSAGES'],

Why it doesn't check for Permissions?

Using a RichEmbed in a Command code typo

In the run part of the code in .setAuthor the variable message should be msg.