Get Started

BotWiz may be easier than coding your own bot from scratch, but there are components that can be confusing for new members. In this page, we have put together a complete guide on how to get started and make your very first Discord bot using BotWiz!

We are determined to answer any and all questions that you might have about BotWiz. If at any point you would like one-on-one help with our bot creation tools, please visit our Discord Server and open a support post.

Setting up your First Bot

Before you can begin implementing bot commands, events, and other features with BotWiz, you must first create a Discord bot through Discord. To do this, sign into the Discord Developer Portal using your Discord account, and click on 'New Application.' After you've created a Discord application, visit the 'Bot' tab. Here, you will be able to configure the application as a bot by defining its bot intents. Through the Discord Developer Portal, you will also be able to access the bot's token, and more, which will be necessary to configure BotWiz!

Enabling your Bot's Intents

By defining a bot's intents, you allow it to access message content, guild member information, and presence updates. This is essential for adding custom bot behavior, therefore, you must enable all three before you can configure the bot with BotWiz, and before the bot can appear online.

In order to define a bot's intents, from the top of the 'Bot' tab, scroll down until you see 'PRESENCE INTENT,' 'SERVER MEMBERS INTENT,' and 'MESSAGE CONTENT INTENT.' Once there, be sure to enable all three, as shown below:

Bot Tokens

All Discord bots use what is called a bot token to connect a bot's application code to the bot's Discord application itself. As you will come to learn, BotWiz handles the application code for your bot. Therefore, in order to give your bot custom bot behavior through application code, you will need to add the bot's token to BotWiz. This is done through the main landing page, but first, you need to create a bot token.

Generating a Bot Token

When creating a bot for the first time, you will need to generate a new bot token. In order to do this, from the top of the 'Bot' tab, scroll down until you see 'Reset Token.' Once there, select the 'Reset Token' option, and click 'Copy' to copy the bot token for use in the next step.

In general, be sure to keep this token confidential, as anyone with access to it can connect their own application code to your bot. If you believe that your bot's token has been compromised, it's considered best practice to immediately regenerate it using the same process above. This is to prevent unwanted users from accessing your bot and taking control of your Discord servers.

Adding your Token at BotWiz

To start adding custom commands, events, and other behavior to your bot, you must first add the bot's most recently generated token, as per the last step, to BotWiz through the main landing page. Visit BotWiz's main landing page and select "Click to add your first bot..." After doing so, it will walk you through all the necessary steps to create your first bot in BotWiz.

Afterwards, your bot will be registered with BotWiz, and you can immediately start creating your new custom commands and events.

Navigating the Dashboard

Once you have registered a bot's token with BotWiz, you can view your bot's dashboard which provides you various information about the bot, such as command uses per week, and navigation to dashboard sub pages. In order to view a specific bot's dashboard, select the desired bot and it will navigate you to the Dashboard.

For every dashboard, you will see multiple pages that let you customize your bot completely, ranging from your bot's appearance down to how it operates. Navigating the dashboard can be a little overwhelming for new users, so below we've listed each dashboard subsection and what they do.

Main

The main section of the dashboard will include six pages meant for preparing your bot, such as its settings. These pages are typically used for starting or stopping your bot, purchasing premium, inviting your bot, and finding additional support resources for creating your custom commands and events. See the below tabs for all pages within the dashboard:

Under the settings subsection, you can customize various attributes about your bot, as described in the table below:

Creations

This section is entirely based upon your bot and its commands and events. Under the Builds column, you can create custom commands, Discord events (e.g., for when a new user joins a server your bot is in), timed events, webhook events and custom events entirely from scratch. Visiting our Modules, Templates or Market pages is a great way to implement professionally built systems with ease, to find a solid starting point for your own bot, or publcly share your builds with the BotWiz community! See the below tabs for all pages within this section:

Miscellaneous

Featuring pages showcasing information about your bot, such as the guilds your application is currently in. Use these pages to manage your bots storage, team and troubleshoot your systems by using your bot logs (providing up-to-date errors, information and success notifications), and more. See the below chart for all pages within this section:

Navigating a Builder

A builder is a workplace where you can create commands and events from scratch using blocks. For each block, a unique action is carried out; such as sending a message, or triggering a custom event.

Currently, BotWiz has five unique builders: a builder for commands, Discord events, timed events, webhook events and custom events. For each, you can customize your creation with blocks. However, the command builder is slightly different to event builders, as it will also have option blocks.

Builder Tools

Every builder has a set of menus incorporated, enabling you to access pages on the dashboard without needing to switch webpages! You will see a list of page options under each respective section. For example, under the "Actions" section, you will see options such as "Start Poll". See the below chart for all pages within this section:

Main Builder Tools

At the top of your builder you will see a list of options which are the main tools for your building process. These options feature the exiting of the builder, help, purge, save builder, and builder settings. Without autosave enabled, you must make sure to save before exiting the builder!

Blocks & Block Flow

To add blocks to your builder, you must first select an action or condition. From here, you can click and drag a block onto your builder.

For every block you add (apart from option blocks), you must connect them. To attach the very first block in your command or event, click and hold the red circle at the bottom of the 'main block' (the block that states your command or event name) and drag that down to your block's upper red circle.

See below as an example of connecting blocks together. In this command, once run, the bot will respond with a message and then pin a message. See how the very first block to run is the send message block, this is because it is connected to the main block.

Any subsequent blocks will follow afterwards. For instance, the pin message blocks runs after the message has been sent; not before or at the same time. The same logic occurs for condition blocks, whereby if placed after the send message block, it will run after the message is sent.

Block flow can be manipulated by editing your builder's settings. You can find these settings in the main builder tools section. In the Blocks option, you can change the direction of your block flow. So instead of having your blocks flow vertically, you can change it to horizontally. Further, you can modify the spacing in-between your blocks for when you use the organization tool.

Learning more about BotWiz

BotWiz has endless possibilities, it's just about knowing how to create them. Even blocks can be confusing at times, which is why we offer several resources to aid you at any time, at any level. The majority of your learning will come from experience. Build endlessly and explore more!

Though we may have helpful documentation, we may not provide all of the information you need. If at any point you need any additional help from our Support Team, please find us at our Discord server. Simply open a post at our support channel and a response will be provided soon.