Get Started
Last updated
Last updated
BotWiz may be easier than coding your own bot, 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 at BotWiz!
Throughout your journey at BotWiz, we are always here to help. In our documentation, here, we cover all kinds of tools such as APIs and regexes which will help you create anything your heart desires! If at any point you would like one-to-one help, please visit our Discord Server and open a support post.
To create your very first Discord bot, head to the Discord Developer Portal. Here, you can create a new application and afterwards, you can head to the 'Bot' tab. In this tab, you can enable your bot's intents, access your bot's token and more.
When creating a new bot, it will not come with any default commands, events or permissions. Permissions can be set on the Discord Developer Portal, and you can create your very first custom commands and events at BotWiz for free!
Intents allow your bot to access message content, guild member information and presence updates. This is essential for creating custom commands and events. Therefore, you must enable all three before your bot can appear online.
To do so, visit the Discord Developer Portal and select your application. Then, head to the 'Bot' tab and select the following options below:
When creating your bot for the first time, you will need to generate a new bot token. Bot tokens are the code that is used to gain access to your bot, and anyone with your bot's token can take control. Therefore, it is essential that you keep this code safe.
When creating a new bot, you must generate a token for the first time. This will be used when registering your bot with BotWiz, at the Bots Management page. To do so, visit the Discord Developer Portal and head to your application's Bot tab and select 'Reset Token'.
It is also important to regenerate your bot's token from time to time, or if you believe your token has been compromised or potentially leaked. This is to avoid unwanted users accessing your bot and taking control.
When regenerating your bot's token, do not forget to update this at BotWiz. You can do so by visiting your bot's Data & Security settings, and replacing your old token with your regenerated code.
To start adding custom commands and events to your bot, you must first register it with BotWiz. To do so, visit the Bots Management page and paste your newly generated bot token into the 'Bot Token' textbox shown below and click 'Add Bot'.
Afterwards, your bot will be registered with BotWiz, and you can immediately start creating your new custom commands and events! To get started editing your new bot, feel free to select it in your
Do not share your bot's token with anyone. Instead, feel free to use our Teams feature.
Once you have registered your bot with BotWiz, you can view your bot's dashboard. To do so, select your bot in your bot list. For each bot you register, you can customize their settings, statistics, commands, events and more in its 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, and so below is a list of each section and page and what they do.
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.
| Page | Description |
|---|---|
Find some satistics on your bot, and see what is being used the most. | |
Start your bot, set its status, appearance, refresh data and tailor error replies. | |
Purchasing premium gives your bot countless more opportunities. See here. | |
Discover our Discord support server, and our available guides. | |
Redirect back to your bot list, for ease of access to modifying another bot. | |
Invite your current bot to a server by clicking this page! |
This section is entirely based upon your bot and its commands and events. Create Discord events (e.g., for when a new user joins a server your bot is in), timed events, webhook events, custom events and commands entirely from scratch. Or, visit our modules to implement professionally build systems effortlessly.
| Page | Description |
|---|---|
Build completely custom commands from scratch with various tools. | |
Trigger personalised actions from events e.g., when a user boosts a guild! | |
Run scheduled or interval timed events, for reoccuring actions. | |
Connect your bot with third-party services to run unique actions. | |
Steer your command into running a custom event of yours! | |
Instead of building systems from scratch, try out our pre-built ones! |
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.
| Page | Description |
|---|---|
Work on your bot with a team! Manage their permissions, invite members, etc. | |
Mainly for troubleshooting creations, these logs will mention any errors you have. | |
An up-to-date list of the servers your bot is currently in. | |
The place to create, edit and view all of your custom variables. | |
A showcase of each export you have saved; with the ability to import them. |
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 customise your creation with blocks. However, the command builder is slightly different to event builders, as it will also have option blocks.
Every builder has a menu incorporated, enabling you to access pages on the dashboard without needing to switch webpages! For example, you can find your bot logs, variables and exports in the builder navigation, along with additional tools such as a 'problems' tab.
| Navigation Tool | Description |
|---|---|
Co-create | View your team, chat and edit your co-create settings here. |
Logs | Easy access a live version of your bot logs; ready to catch an error. |
Migrates | See your saved exports and you can use this menu to import creations. |
Variables | Easily view, edit and create new custom and unique variables. |
Builds | A showcase of all of your commands and events. Click one to edit it! |
Problems | A list of any problems your current build has. |
Co-create is only available for premium members. Find out how to buy premium here.
Futher, you may find an action navigation section in any build. Action navigation holds only three tabs, which will each serve a list of blocks. For instance, by selecting 'actions', you can peruse our available action blocks (such as send a message, join a voice channel and more).
Actions, conditions and options are all lists of blocks you can use to personalise your new creation. However, each operate uniquely. Action blocks will be the actions the bot can take, whereas conditions will check if a situation has been met before continuing. Option blocks, however, will ask the command executor to enter some details before running the command.
To find out more, please visit their respective page: Actions, Conditions and Options.
At the bottom of your builder, you will see the icons shown below. These are the main tools, featuring the look-up tool, builder settings, purge, exit and save. Without autosave enabled, you must make sure to save before exiting the builder!
| Navigation Tool | Description |
|---|---|
Look-up | Search our documentation for an answer to your question via AI! |
Settings | Use this menu to enable autosave, modify your formats and kotkeys. |
Purge | Wish to start over and purge this entire command? This is the tool for you. |
Exit | Make sure to save your creation before exiting back to your dashboard! |
Save | Save your current build, ready for use immediately. |
To add blocks to your builder, you must first need to select an action navigation. In other words, you must have a block list open (e.g., have selected the actions tab shown in the above image). 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.
Option blocks do not need to be connected in a builder as they will always appear when a command is used. Thus, they cannot run after the command has been entered.
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 places after the send message block, for example, 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 builder tools section, and will have the ⚙️ icon. In the formatting options, 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 inbetween your blocks for when you use the organization tool.
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, at our 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 for your query.
