botkit-discord

botkit-discord

🤖👾 A Botkit connector for Discord

This Botkit connector would not be possible without the powerful and simple library, izy521/discord.io.

Note this is still a work in progress and open to additional features and suggestions

Usage

const BotkitDiscord = require('botkit-discord');
const config = {
    token: '**' // Discord bot token
}

const discordBot = BotkitDiscord(config);

discordBot.hears('hello','direct_message',(bot, message) => {
    bot.reply(message, 'how goes there :)!');
});

discordBot.hears('.*', 'direct_mention', (bot, message) => {
	bot.reply(message, 'leave me to be please.');
});

Refer to Botkit documentation to utilize all of the other Botkit features.

Events

You can handle particular events for your bot using the .on() method.

discordBot.on(EVENT_NAME, event => {
	// do stuff
});

Incoming Events

Event	Description
ambient	a channel the bot is in has a new message
direct_message	the bot received a direct message from a user
direct_mention	the bot was addressed directly in a channel ("@bot hello")
mention	the bot was mentioned by someone in a message ("hello @bot")

Bot Activity Events

Event	Description
disconnect	Bot has disconnected or failed to login
ready	Bot is connected

Guild Events

Guilds can also be referred to "server"

Event	Description
guild_member_add	A member added to guild (server)
guild_member_update	An existing guild member has bene updated
guild_member_remove	A member removed from guild
guild_role_create	A new guild role created
guild_role_update	An existing guild role has been updated
guild_role_delete	A guild role deleted
channel_create	A channel has been create
channel_update	An existing channel has been updated
channel_delete	A channel has been deleted

API

For convenience the following methods from discord.io library is available on the controller.api

• setPresence
• editUserInfo
• getAllUsers
• fixMessage
• simulateTyping
• getMessage
• getMessages
• editMessage
• deleteMessage
• pinMessage
• deletePinnedMessage

License

Ⓒ MIT (Brandon Him / brh55)

Please let me know if you plan on forking or would like professional support.