Builder

Builder Tools

The Builder Tools allow you to edit your builders functionality. By clicking the icons, you can navigate the tool options and incorporate any desired actions, conditions and options into your command or event. See the chart below for all icons related to their function:

Actions

The Actions tab enables you to define the specific tasks and functions your bot can execute. Through this tab, you can add a variety of actions ranging from simple responses to complex workflows. Actions are essential for customizing your bot's behavior, allowing it to perform tasks like sending messages, modifying data, or interacting with third-party APIs. Use the Actions tab to enhance your bot's capabilities and automate processes seamlessly.

Conditions

The Conditions tab lets you specify the criteria under which certain actions or commands should be executed by your bot. By defining conditions, you can dictate how your bot responds to specific inputs or events. Leverage conditions to make your bot's interactions more dynamic and responsive, ensuring it acts appropriately in different scenarios.

Options

The Options tab offers a range of settings that let you fine-tune how your bot behaves when running a command. This is where you can define input preferences, prompting the user for specific details the bot needs to execute properly. For example, using the Role Option, the bot can ask the user to select a specific role—provided you’ve set up the necessary variables to link that input to your command logic. Options like these make your commands more flexible, interactive, and customizable based on user input.

Variables

Variables allow you to store and reference custom values throughout your bot’s commands and events. Variables come in different types, each serving a specific purpose. When accessing the Variable tab, you'll encounter two main categories: Custom and Unique. Custom variables are shared across users and sessions, making them ideal for storing global data like usage counters or server settings. Unique variables, on the other hand, are temporary and specific to the current event or interaction, often used to handle things like user input or dynamic responses.

Problems

The Problems tab displays any active issues with your custom command or event. Each problem listed helps identify errors or missing elements that may prevent your command from working correctly.

Logs

The Logs tab allows you to view all current and previous errors your bot has encountered. For example if your bot cannot send a message to a channel, the error will show here.

Migrations

Migrations allow you to import a share-code either for an event or a command, that you have received from someone. Migrates also allows you to export a command / event that you have created to show off!

Builds

Using this option will allow you to navigate between builds in your custom command or event directory. This can be extremely useful, especially when referencing other commands.

Command Tree

The Builder Command Tree is a vital element to organizing and visualizing the structure of your custom commands or events. It clearly displays how each component connects and flows, making it easier to build, understand, and maintain complex command logic. The Command Tree follows a sequential order, meaning actions are executed from top to bottom—each action must occur before the one below it can run. This structured layout ensures logical progression and helps prevent errors during execution.

Command Options and Settings

At the top of your builder, you will see various options to choose from—from exiting the builder to the settings for the builder. Each button serves its own purpose and this section will break down how each option's purpose and usage.

Exit Builder

When selecting the option to exit the Builder, you'll be prompted with a confirmation message to ensure you truly intend to leave. This safeguard is in place because any unsaved changes will be permanently lost upon exiting. It's recommended to review your work and save any progress before confirming your decision to exit the Builder.

Help

This button provides quick access to helpful resources while you're editing your command. It's strongly recommended that you review the official documentation for detailed guidance and make use of the BotWiz Discord server to ask questions, get assistance, or troubleshoot any issues you encounter during the building process. Taking advantage of these resources will help you build more effectively and avoid common mistakes.

Purge

Selecting this button will clear ALL added features that you've added to your builder for that particular command or event.

Save Builder

Use this button to save your work within your builder.

Command Settings

Pressing this button will prompt you with another page with various features within your builder.