Custom commands

⫸ Open the DraftBot panel

Fill in the various fields (name, description, actions, etc.), click the "Create" button, and your custom command is ready to use straight away!

Need to edit or delete a command?

No problem! Click "Edit" or "Delete":

You can create a custom command with the /config command, then going to the "Custom commands" tab of the selector. DraftBot then asks you for:

• The name of the command,
• The description of the command,
• The action(s) your command has to carry out,
• The allowed/forbidden roles or channels,
• Whether the command should appear in /help or not,
• Whether you want to add a slow mode to your command,
• Whether you want to set a condition for using it.

Send a message

When the command is run, DraftBot sends a message.

Show an example:

Here is a Send a message action, configured from the Panel:

When the command is run, this is what you get:

1. Add roles
   When the command is run, DraftBot assigns the selected role(s).
   Show an example:

   Here is a command using the "Add roles" action:

   

   If I write !role-a @DraftBot on Discord, the member DraftBot receives the @A role!

   For clarity, feel free to combine this action with a Send a message action, so that DraftBot can tell the member they have received a new role!

2. Add a temporary role
   When the command is run, DraftBot assigns a role, then removes it after a time of your choice.
   Show an example:

   From the Panel, setting the exact duration you want is very easy:

   

   If I write !role-temp on Discord, I receive the @C role!

   Then, after 5 minutes, the role is removed from me automatically.

3. Remove roles
   When the command is run, DraftBot removes the selected role(s).
   Show an example:

   Here is a function that removes the @A role from a member, by mentioning them:

   

   If I write !demote-a @DraftBot on Discord, the member @DraftBot instantly loses the @A role!

   If you want the command to apply directly to the member using it, simply untick the "target another member" box.

   

1. Shop article
   By using this command, the member buys the selected item.
   Show an example:

   The following command lets its user buy an item:

   

   If I write !fox on Discord, the item " Plush fox" appears in my inventory (and its price is deducted from my money)!

   DraftBot leaves you free to write the purchase confirmations yourself:

   So remember to combine this action with the Send a message action!

2. Add money
   When the command is run, DraftBot adds a set amount of money to the member.
   Show an example:

   Here is a !donation command, which adds 10 to a mentioned member:

   

   If I write !donation @DraftBot on Discord, the member @DraftBot instantly receives 10💰!

   You can also decide that this command adds the amount to the member using it, rather than to a mentioned member. To do so, untick the "target another member" box.

Access to a command can be restricted by two criteria:

1. Restrict by roles
   You can reserve the use of a command for certain specific roles, or on the contrary forbid it only to certain specific roles.

   Users with the Administrator permission can use the command whatever the allowed or forbidden roles.

2. Restrict by channels
   In the same way, you can restrict the use of your command to certain specific channels, or forbid it in certain specific channels.

   To switch between the "allow" and "forbid" modes, click "ALLOWED/FORBIDDEN".

   The active mode is written in white, while the other one is greyed out.

   

If you do not want the command to appear in /help, you can enable this button:

If you want to apply a "cooldown" to your custom command, you can set it up flexibly by giving the following information:

• Number of uses: how many times the same user can use it before triggering a cooldown
• Slow mode duration: how long the cooldown lasts before the user can use the command again.

If you are a moderator or an administrator, you can reset your own number of uses of a command! To do so, go to the Panel and click "Edit" next to the command in question.

A "Reset my slow mode" button appears at the bottom left of the screen:

You can make access to your command conditional on prerequisites:

• Inventory item: the member can only use the command if they own the set item.
• Money: the member can only use the command if they hold the set amount of money.
• Level: only the members of a certain level can use the command.

Thanks to the Panel, you can configure all of this in a few clicks: