Create Discord Bot

Create Discord bots using a simple widget-based framework.

Bot Setup

Create Bot

1. Go to Discord's Developer Portal.
2. Create a new application.
3. Add a bot user to your app.
4. Find your bot token, you will need this in the next section.

Keep this token and any file containing it private! If your token ever leaks or you suspect it may have leaked, simply regenerate a new token to invalidate your compromised token.

5. Invite your bot to a server using: https://discordapp.com/oauth2/authorize?scope=bot&client_id=COPY_PASTE_YOUR_DISCORD_BOT_CLIENT_ID_HERE

A Discord bot's client ID is not the same as its token!

Get Bot

1. git clone https://github.com/peterthehan/create-discord-bot.git to download the project.
2. cd create-discord-bot/ to navigate into the project.
3. npm install to install project dependencies.
4. Rename example.token.json to token.json.
5. Open the file and add the bot token found in the previous section:

{
  "TOKEN": "COPY_PASTE_YOUR_DISCORD_BOT_TOKEN_HERE"
}

Run Bot

1. npm start to start the bot.

The bot should go from offline to online. Verify the bot is working by using the ping command.

The default command prefix is .. You can configure the command widget's settings in src/widgets/command/config.js.

🎉 You're ready to create your own widgets! 🎉

Widgets Setup

Design

create-discord-bot comes with a command widget. Simply follow the design of the ping command to start building your own commands.

Each widget must live under the src/widgets folder and must have a handlers folder containing only event handler files. In other words, a file tree diagram of these requirements would look like:

widgets
├───widget1
│   ├───handlers
|   |   ├───eventHandler1.js*
|   |   ├───eventHandler2.js
|   |   └───other event handlers
├───widget2
│   ├───handlers
|   |   ├───eventHandler1.js
|   |   ├───eventHandler2.js
|   |   └───other event handlers

*: All event handler files must be named exactly the same as the emitted events found on the Client page.

Examples

The following widgets can be used by this framework by moving them into the src/widgets folder:

• https://github.com/peterthehan/discord-active-role-bot
• https://github.com/peterthehan/discord-audit-log-bot
• https://github.com/peterthehan/discord-birthday-role-bot
• https://github.com/peterthehan/discord-emoji-log-bot
• https://github.com/peterthehan/discord-reaction-role-bot

Visit for more help or information!