djs-commands
v2.0.7
Published
a command handler for slash commands on discordjs v14
Downloads
165
Readme
djs-commands
an all-in-one command handler package.
Djs-commands currently includes a command handler for your Discord.JS bots.
UPDATE v2.0.0 MAJOR CHANGE
Hi! So over the years this bot has become more and more deprecated, and with the switch to slash commands, I decided to accommodate for that. This update is mostly for me to continue to use the same handler I've used for years with actual support for the recent changes with Discordjs, but it still remains open source on github with the link below.
djs-commands Discord Help Server
I set up a support server, it's minimal for now. I noticed a surge in downloads when I updated and assume many were from the videos and with it being extremely different, figured this would help. Also, any contribution questions/discussions can take place here. Click here to join
Installation
npm install djs-commands discord.js @discordjs/builders dotenv
Setup guide
1 - Setup .env
in the root folder of the bot
CLIENT_ID=CLIENTIDHERE
GUILD_ID=CLIENTIDHERE
TOKEN=BOTTOKENHERE
2 - Require and create a CommandHandler instance
const { CommandHandler } = require("djs-commands");
const CH = new CommandHandler({
folder: __dirname + "/commands/",
guildCommandRefresh: true, //not including this or setting as false reverts to not updating GUILD commands.
});
Another option is to use guildCommandRefresh: true
to just refresh guild commands from the ID in .env
.
3 - In the interactionCreate event is where we will run our command
client.on("interactionCreate", async (interaction) => {
if (!interaction.isChatInputCommand()) return;
let cmd = CH.getCommand(interaction.commandName);
if (!cmd) return;
try {
cmd.run(interaction);
} catch (e) {
console.log(e);
}
});
4 - And of course we're going to need a command file. So inside of your bot folder, create a folder called commands. I'm going to create a file called test.js and put the following code inside of it.
The this.slashCommand
option takes a SlashCommandBuilder()
passed as a JSON type. You can add whatever slash command options you like here using @discordjs/builders
.
const { SlashCommandBuilder } = require("@discordjs/builders");
module.exports = class test {
constructor() {
(this.name = "test"),
(this.slashCommand = new SlashCommandBuilder()
.setName("test")
.setDescription("A command to test stuff and things."));
}
async run(interaction) {
await interaction.reply(this.name + " works");
}
};
5 - And that's it! You have a working command handler now for all the commands you could want! Here's an example of how to add options to a slash command.
const { SlashCommandBuilder } = require("@discordjs/builders");
module.exports = class another {
constructor() {
(this.name = "another"),
(this.slashCommand = new SlashCommandBuilder()
.setName("another")
.setDescription("Another command to test stuff and things.")
.addBooleanOption((option) =>
option
.setName("stuff")
.setDescription("a description")
.setRequired(true)
));
}
async run(interaction) {
await interaction.reply(this.name + " works");
}
};
And then from there, you can add as many options or whatever type of option you wish using the link above.
https://github.com/nedinator/djs-commands
Contributing
- Fork it (https://github.com/nedinator/djs-commands/fork)
- Create your feature branch (
git checkout -b feature/fooBar
) - Commit your changes (
git commit -am 'Add some fooBar'
) - Push to the branch (
git push origin feature/fooBar
) - Create a new Pull Request