Actions, Options, Conditions
Wanting to know what blocks to use in your custom command? Here's all you need to know about them all.

Step 3: Command Creation (Options)

This step consists of three different sections: Options, Actions & Conditions​
  • Now that you're command has been successfully set up, it's time to create the actual command itself.

Options:

Options are the purple blocks which allow users to select from channels, users and roles. You can also setup pre-made choices which allows users to choose from a variety of options while running your command. These options can be visible on the right hand side, ensure the "options" tab is selected:
Hint: Drag a block to the centre of the screen use it
Text
This allows users to input a piece of text when running your command. Give the block a name and a description.
​
​
Number
This allows users to input numbers when running your command. Give the block a name and a description.
​
​
User
This allows users to select another user while running your command. Give the block a name and a description.
​
​
Channel
This allows users to select another channel while running your command. Give the block a name and a description.
​
​
Role
This allows users to select a role while running your command. Give the block a name and a description.
​
​
Choice
This allows users to choose from a true or false option while running your command. Give the block a name and a description.
​
​

Option Settings:

  • Variables: Each option will have it's own variable based on the option name. For example if you use a role option and you name it "role", you can use the variable {option_role} in your response and the bot will mention that role. Same goes for all the other options:
The variable is {option_role}
Paste the variable {option_role} in your response for the bot to mention the role
  • Set Required: When this is toggled on, it just means that the user must give a response or choose from the given options.
  • Choices: This allows users to select from pre-made options without having to type it out themselves. This will only work for the number and text option block and there's a max of 25 choices per block.

Command Creation (Actions)

  • Actions are the blue blocks which are what we use to create command replies and allows the bot to perform certain requests:
Hint: Drag a block to the centre of the screen use it

Response Actions: Blocks which perform basic actions such as send a message.

Plain Text Reply
This is just a simple message and nothing too special.
​
​
Embed Reply
This is similar to a plain text reply, however it's shown as an embed.
​
​
Random Reply
This allows the bot to send a plain or an embedded random reply each time a user uses your command.
​
​
Send message to a channel
This allows the bot to send a plain or an embedded reply to another channel.
​
​
Direct Message a user
This allows the bot to send a plain or an embedded direct message to the user who executed the command.
​
​
​

Advanced Actions: Blocks which perform advanced actions such as send a message with buttons.

Send message with attached buttons
This allows the bot to send a plain or an embedded reply but with buttons.
​
​
Send message with a select menu
This allows the bot to send a plain or an embedded reply but with a select menu.
​
​

Role Actions: Blocks which perform actions such as adding on roles.

Add Role
Adds a specified role onto the user who executed the command.
Remove Role
Removes a specified role away from the user who executed the command.
Create a role
Allows the bot to create a role and set up permissions for it.
Delete a role
Allows the bot to delete a specified role.

Economy Actions: Blocks which perform actions such as adding currency

Add Currency
Adds the specified amount of coins to the balance of the user who executed the command.
Remove Currency
Removes the specified amount of coins from the balance of the user who executed the command.
Add item
Adds an item to the inventory of the user who executed the command.
Remove item
Removes an item from the inventory of the user who executed the command.

Channel Actions: Blocks which perform actions such as making a new channel.

Create a channel
Allows the bot to create a channel and set up permissions for that channel.
Delete a channel
Allows the bot to delete a channel that a user has specified.

Server Actions: Blocks which perform actions such as banning a user.

Kick a member
Allows the bot to kick the member specified in the command.
Ban a member
Allows the bot to ban the member specified in the command.
Timeout a member
Allows the bot to mute/timeout the member specified in the command.

Other Actions: Blocks in which perform actions like waiting before running another action.

Action Name
What does it do?
Wait before running another action
Allows the bot to wait a set number of seconds before running another action.

Command Creation (Conditions)

  • Conditions are the green blocks which allows your bot to run if statements while users use your custom commands.
Hint: Drag a block to the centre of the screen use it
Options Condition
This allows your bot to run different outputs based on what the user inputted from on of the option blocks.
Chance Condition
This allows the bot to run multiple outputs but randomly chooses them based on how likely the percentage is. (0-100, 100 being most likely)
Channel Condition
This allows the bot to run different output based on what channel the command was used in.
Role Condition
This allows the bot to run different outputs based on what role the user executing the command has.
User Condition
This allows the bot to run different outputs based on what user executed the command.
Currency Condition
This allows the bot to run different outputs based on the currency balance of the user who executed the command.

How to use conditions?

  • Adding Responses/Conditions: Based of which condition you've selected, you need to input information on the right hand side of the screen by interacting with the condition block. Once complete, press the "Add Condition" button and complete your command for every condition block.
  • Else block: For some conditions, you'll need action blocks to follow on from the "Else" condition block so that if the conditions aren't meet, the bot has something to output like "Sorry, this command isn't for you!"

How to solve "Bot is thinking" error?

  • This issue normally arises when there's no message output and the bot has nothing to send in channel where the command was first executed in. In most cases, you need to add a some sort of plain or an embedded reply towards the end of your command tree which could just be a simple message such as "Done!".

How to import pre-made commands?

  • BotGhost Marketplace: First, you'll need to head on over to the BotGhost Marketplace and select a command. Click on a command to open it, then press the big orange button which says "Add Command":
  • Once pressed, select the bot in which you want the command to be on and then the command should be added!

What are all the useable variables?

  • You can view all the available variables here
Experiencing issues with the command builder or just need help? Checkout our support options here​