Custom Commands

Custom commands allow you to create unique commands to deliver information unique to your discord server. This means creating commands with custom triggers and information. You can create plain text commands, embeds or random commands which utilize both.

Creating a Custom Command

To create a custom command you must first choose what type of command you wish to create.

Type

Description

Text

A plain text response

Embed Message

An advanced embed message. Allows you to set a message with a title, link, color, image and description

Random Response

A list of responses, both embed and text. A response will be randomly chosen and sent when triggered.

Role Command

Add a role or list of roles to a member when this command is called.

To create a command click on one of the command types.

Variables

You are able to use a range of different commands in your custom command. These commands allow you to make your commands more tailored to your server and its members. To use a command, paste one of the following codes into your command and edit it to your liking.

Variable

Description

{user}

The user triggering the command. Example: 'Hello {user}'

{server}

The server which the command was triggered in. Example 'This server is {server}'.

{channel}

The channel which the command was triggered in. Example 'This channel is named {channel}.

{@user}

Mention a specific user by their user id. Replace 'user_id' in the variable with the targets user id. Example: 'Please message {@231849525185216512}'

{^role}

Mention an entire role by name, replace 'role' in the variable with the target role. Example: 'Hello everyone {^admins}'.

{#channel}

Mention a channel by name, replace 'channel' in the variable with the channels name. Example:'Please post suggestions in {#suggestions}'.

{channel_name}

the name of the channel that the message was posted in. Example: This channel is {channel_name}.

{server_members}

returns the member count of the guild. Example: This server has {server_members} members

{server_icon}

returns the icon of the guild. Example: This icon of the guild is {server_icon}

{server_region}

returns the region of the guild. Example: This server is hosted in {server_region}

{server_owner}

tags the owner of the guild. Example: If you have any problems, please message {server_owner}

{user_icon}

returns the icon of the user who triggered the message. Example: Your Profile Picture is {user_icon}

{random[min,max]}

returns a random number between a min and a max, replace min and max with two numbers. Example: Roll {random[1,10]}

{member_mention}

returns the user who was mentioned in the command trigger. Example: Hug {member_mention}

Plain Text Commands

Plain text commands are basic text responses. These are best for links or very basic information. To create a plain text response, click the Create button next to Plain Text.

This will open window where you can create a new basic text command. All fields must be filled in to create the command.

Fields

Field

Description

Trigger

The trigger of the command.

Description

A short description of the command. This is what will be displayed to users when they use the help command.

Post Type

Should the command be direct messaged or posted in the channel it was triggered in.

Command Content

The actual response of the command.

When you are done, click the Save button.

Just like any other command. You are able to edit the permissions and trigger of any custom command you create.

Embed Message

Embed messages are special messages unique to discord. They allow you to set a range of different parameters based on your needs.

An example of an Embed

To create an embed click the Embed Command option under Create a Command.

This will bring up a new window in which you can create your embed message. First, set a trigger and description and post type for your command Next you must supply a Title and Content for your command. The other fields are completely optionable.

Fields

Field

Description

Trigger

The trigger of the command.

Command Description

The description of the command. This will be displayed to users when they use the help command.

Embed Author

A small text field at the top of the embed.

Embed Title

The title of the embed.

Embed Body

The body text of the embed.

Embed Color

The color of the embed. This is the color of on the left hand side of the message in discord.

Embed Thumbnail

The thumbnail of the message. A small icon that is displayed in the top right of the message. A link to the actual image is required. Example: https://i.imgur.com/BvSgpnY.png.

Embed Image

Similar to the thumbnail, except the image is placed in the body of the embed. A link to the actual image is required. Example: https://i.imgur.com/BvSgpnY.png

Embed URL

Makes the entire embed message a link.

Once you are done, click the Save button to save the command.

Random Response

Random responses are made up of a list of commands, either text or embed, which are randomly chosen when the command is triggered. To create a random response click the Random Response command under Create a Command.

To create a random response, set the trigger and command description and post type like you did with plain text and embed messages. You must then add a command to the list of random responses. First choose either to add a Plain Text response or an Embed Response by using the Toggle.

Once you have selected your response type fill in the required fields. Finally click Add Message to add your response to the list of random messages.

Your response will now be added to the list of random responses. You can see the list of random responses at the bottom of the window.

Deleting a response from the response list

To delete a response simply click on the response you wish to delete.

Role Command

A role command adds a role or list of roles to a member when it is triggered. To create a role command click on the Roll Command button under Create a Command.

To create a role command first fill in the trigger, description and post type as described above. A role command also requires a text command content which is the response posted after the roles have been added to a member.

Adding Roles to a Command

To add roles to a command first click on the + button in the Role adder input.

This will open the role picker dropdown. If no roles appear ensure that your bot is in a server and then click the refresh button.

Select a role from the dropdown and click it to add the role to the command. You can add as many roles as you like.

To remove a role from the command. Click on the X next to the role. Click Save changes to save your command.

Editing a Command

To edit a command simply click the Edit button on the command.

You can edit the permissions and triggers of custom commands just like you would with any other default command. See the Editing Commands section for more information

Deleting a command

To delete a command first click on the command on the edit button and click the delete button on the bottom of the modal.