discordeno/docs/content/stepbystep/createbot.md

title, metaTitle, metaDescription

title	metaTitle	metaDescription
Creating The Bot!	Creating A Bot | Discordeno	Let's create our very own bot with Discordeno!

Discordeno will help make Discord bot development much easier. Don't worry, as you go through this guide it will make a lot more sense.

Creating The Bot!

This guide is going to assume you already have the basic requirements to make a bot ready. This includes github, git, a code editor like Visual Studio Code. If you don't have these yet please prepare them first before going forward.

• First, create a Discordeno Bot using the Generator Boilerplate. Give it any name you like. For the purpose of this guide we will call it, Stargate.

• Then git clone https://github.com/Skillz4Killz/Stargate.git

• When that is done, go ahead and open up the folder with VSC.

• Create a new file called configs.ts. Open the configs.example.ts file and copy everything over.

Let's take a minute to review all the options we have available to us.

Configs File

The configs.ts file is where you will keep all your secret info you don't want to share with anyone else. As long as .gitignore file is ignoring configs.ts your configurations will be kept private!

// Step 1: Remove the `.example` from this file name so it is called `configs.ts`
// Step 2: Add all your bot's information below. The only required one is token and prefix. NOTE: As long as `.gitignore` file is ignoring configs.ts your configurations will be kept private!
// Step 3: Remove these comments if you like.

export const configs = {
  // Your bot token goes here
  token: "",
  // The default prefix for your bot. Don't worry guilds can change this later.
  prefix: "!",
  // This isn't required but you can add bot list api keys here.
  botListTokens: {
    DISCORD_BOT_ORG: "",
    BOTS_ON_DISCORD: "",
    DISCORD_BOT_LIST: "",
    BOTS_FOR_DISCORD: "",
    DISCORD_BOATS: "",
    DISCORD_BOTS_GG: "",
    DISCORD_BOTS_GROUP: "",
  },
  // This is the server id for your bot's main server where users can get help/support
  supportServerID: "",
  // These are channel ids that will enable some functionality
  channelIDs: {
    // When a translation is missing this is the channel you will be alerted in.
    missingTranslation: "",
    // When an error occurs, we will try and log it to this channel
    errorChannelID: ""
  },
  // These are the role ids that will enable some functionality.
  roleIDs: {
    // If you have a patreon set up you can add the patreon vip role id here.
    patreonVIPRoleID: "",
  },
  // These are the user ids that will enable some functionality.
  userIDs: {
    // The user ids for the support team
    botSupporters: [],
    // The user ids for the other devs on your team
    botDevs: [],
    // The user ids who have complete 100% access to your bot
    botOwners: []
  }
};

Token

First, add your bot token. This is required for the bot to start. Review the instructions if you have not made your token yet.

Prefix

The prefix is where you will set the default prefix for your bot. Don't worry, every server will be able to choose their own prefix but we need a default prefix to start.

Bot Lists Tokens

This section of the file is so you can easily have your bot's statistics updated on all the bot lists out there to help you grow your bot. The code is already written to handle this but you will need to do 3 things for each bot list.

1. Go to the bot list and add your bot to their website. (Each site has it's own instructions)
2. Create a token for yourself on each website and paste it in your configs.
3. Enjoy!

If you wish to customize the code, you will find the bot list tasks in the tasks folder. Don't worry we will discuss this when we get to the tasks section of the guide.

For now just remember, that Discordeno provides you a built in way to update most discord bot lists.

Channel IDs

The channelIDs section holds the channel IDs that are useful for specific features to help give you alerts/notifications. For example, the missingTranslation channel will be where messages are sent alerting you that somewhere in your code you are trying to use a translation key that you never created.

When you get to around 25,000 Discord servers on your bot, you may want to convert these channel IDs to webhooks.

Role IDs

The roleIDs section holds the role IDs that are useful for specific features. For example, the patreonVIPRoleID role can be used easily to enable vip features later in this guide.

User IDs

The userIDs section holds the user IDs that are useful for specific features. For example, the botDevs and such are useful for permission levels as you will see in the Permission Level part of the guide.

It's Alive!

Oh my god! You now have a bot with a bunch of features already! You don't believe me? Well, seeing is believing, so start the bot.

1. Invite your bot to a discord server.
2. Open up the integrated terminal in VSC using CTRL + `. If you use a Mac, replace CTRL with CMD.
3. Run the script below:

deno run --allow-net --allow-read mod.ts

The first time you run it, you may see a lot of files being loaded. This is preparing all the magic behind the scene. Once it is ready, you will see something like this:

Understanding What Discordeno Did

Discordeno includes these commands/folders as they are essential for any discord bot to have in order to meet the Discord Bot Best Practices. It also adds a few things that will help make some things easier to build a bot.

We will dive into these deeper in this guide. Let's take it step by step.