discord.js-additions

Package to make easier discord bot developpement in Javascript

Getting Started

$3

Using npm
``bash
$ npm install discord.js-additions
`

$3

`js
// ES6
import * as DiscordAdditions from 'discord.js-additions';

// CommonJS
const DiscordAdditions = require('discord.js-additions');
`

Handlers

Command Handler

$3

`js
const commandHandler = new DiscordAdditions.CommandHandler(client, '!');
// client is your Discord.Client
// '!' is the prefix used for every commands added in this handler
`

$3

`js
const handledCommand = new DiscordAdditions.HandledCommand('hello', hello);
function hello(client, message, args) {
message.reply('Hello!');
}
// 'hello' is the name of the command -> The command will be !hello
// hello is callback function (the code executed when the command will be triggered)
`

$3

`js
commandHandler.addHandledCommand(handledCommand);
`

$3

`js
commandHandler.setPrefix('?');
// '?' will be the new
`

Others

Slash Commands

❓ This library is very very similar to the official Discord API so check it out

:warning: ApplicationCommand = a created SlashCommand

$3

`js
const slashCommand = new DiscordAdditions.SlashCommand(client, 'hello', 'Say hello'); // Return ApplicationCommand object
// client is your Discord.Client
// 'hello' is name of the command
// 'Say hello' is the description of the command
`

$3

`js
const option = new DiscordAdditions.SlashCommandOption(6, 'user', 'Wich user you want the bot to say hello');

// Set if option is required
option.setRequired(true);

// Set a list of SlashCommandOptionChoice
option.setChoices([choice1, choice2, choice3...]);

// Set a list of SlashCommandOption (only for SUB_COMMAND and SUB_COMMAND_GROUP)
option.setOptions([option1, option2, option3...]);

// Adding the option to the slashCommand
slashCommand.setOptions([option]);
`

$3

`js
SlashCommandOptionTypes.SUB_COMMAND; // Return 1
SlashCommandOptionTypes.SUB_COMMAND_GROUP; // Return 2
SlashCommandOptionTypes.STRING; // Return 3
SlashCommandOptionTypes.INTEGER; // Return 4
SlashCommandOptionTypes.BOOLEAN; // Return 5
SlashCommandOptionTypes.USER; // Return 6
SlashCommandOptionTypes.CHANNEL; // Return 7
SlashCommandOptionTypes.ROLE; // Return 8
SlashCommandOptionTypes.MENTIONABLE; // Return 9
`

$3

`js
const choice = new DiscordAdditions.SlashCommandOptionChoice('Hello 1', 'hello_1');
// 'Hello 1' is the name of the choice
// 'hello_1' is the value of the choice
`

Application Commands

$3

`js
// From a SlashCommand
const applicationCommand = await slashCommand.create();

// From an ApplicationCommand Id
const applicationCommand = await DiscordAdditions.ApplicationCommand.getFromApplicationCommandId(client, '866621370782711838', '865949299509297192');
// client is your Discord.Client
// '866621370782711838' is the ApplicationCommand Id
// ''865949299509297192' is the Guild Id (optional, if the command is a GuildApplicationCommand)
`

Invites

$3

`js
const inviteSketch = new DiscordAdditions.InviteSketch(client, channel, 0, 42, false, true);
// client is your Discord.Client
// channel is your GuildChannel (where you want the invite to be created)
// 0 (optional), is the maxAge (in seconds) 0 = Never. Value must be between 0 and 604800
// 42 (optional), is the maxUses. Value must be between 0 and 100;
// false (optional) whether this invite only grants temporary membership
// true (optional) if true, don't try to reuse a similar invite
`

$3

`js
inviteSketch.setTargetApplicationId('755600276941176913'));
// '755600276941176913' the applicationId

// or you can use this enum : ActivitiesApplicationId
`

$3

`js
ActivitiesApplicationId.POKER_NIGHT; // Return '755827207812677713'
ActivitiesApplicationId.BETRAYAL_IO; // Return '773336526917861400'
ActivitiesApplicationId.YOUTUBE_TOGETHER; // Return '755600276941176913'
ActivitiesApplicationId.FISHINGTON_IO; // Return '814288819477020702'
ActivitiesApplicationId.CHESS_IN_THE_PARK; // Return '832012774040141894'
`

$3

`js
const invite = await inviteSketch.create();

// console.log(invite.code);
`

Dynamic Timestamps

$3

`js
const dynamicTimestamp = new DiscordAdditions.DynamicTimestamp(new Date(), 'R');
`
Once you created the Dynamic Timestamp you can use it in any message with the toString() method

$3

`js
// From a date
dynamicTimestamp.setDate(new Date());

// From an unix timestamp
dynamicTimestamp.setTimestamp(1626613839);
`

$3

`js
// With the letter
dynamicTimestamp.setDisplayStyle('R');

// With the provided enum
dynamicTimestamp.setDisplayStyle(DiscordAdditions.DynamicTimestamp.DynamicTimestampStyles.RELATIVE_TIME)
`
❓ See more on the official Discord Documentation

$3

`js
// Return the timestamp as a string usable in a message
dynamicTimestamp.toString();

// Example
client.on('ready', () => {
console.log('Bot online');
client.channels.cache.get(logChannelId).send(Bot online!\nMessage sended ${dynamicTimestamp.toString()});
});
`
Result :

!image

$3

`js
DynamicTimestampStyles.SHORT_TIME; // Return 't'
DynamicTimestampStyles.LONG_TIME; // Return 'T'
DynamicTimestampStyles.SHORT_DATE; // Return 'd'
DynamicTimestampStyles.LONG_DATE; // Return 'D'
DynamicTimestampStyles.SHORT_DATE_TIME; // Return 'f'
DynamicTimestampStyles.LONG_DATE_TIME; // Return 'F'
DynamicTimestampStyles.RELATIVE_TIME; // Return 'R'
``

If you see any error here feel free to open an issue

Todo

- Add an EventHandler
- Add an SlashCommandHandler
- Add support for MessageComponents