# Custom commands (cc)

When a user runs a custom command, the bot will send respond with the set message!

{% hint style="info" %}
There are two types of custom commands: text and embed.
{% endhint %}

### Commands

#### Creating custom commands!

{% tabs %}
{% tab title="Text" %}
To create a cc, please run the following command:

* `/cc add text name: <command name>`
* You then need to add a response by using the option `response: <response>`

You are then able to include the following options if you wish:

* `channel: <channel>` (The channel it is allowed to be sent in)
* `allowedroles: <role>` (The role allowed to run the command)
  {% endtab %}

{% tab title="Embed" %}
To create a cc, please run the following command:

* `/cc add embed name: <command name>`

You are then able to include the following options if you wish:

* `title: <title>` ()
* `description: <description>` ()
* `footer: <footer>` ()
* `thumbnail: <thumbnail>` ()
* `image: <image>` ()
* `channel: <channel>` (The channel it is allowed to be sent in)
* `allowedroles: <role>` (The role allowed to run the command)
  {% endtab %}

{% tab title="Variables" %}
You can also have variables which will be filled when a custom command is executed.

| key               | result                                     |
| ----------------- | ------------------------------------------ |
| {discordusername} | The username of the person who ran the CC. |
| {discordid}       | The ID of the person who ran the CC.       |
| {% endtab %}      |                                            |
| {% endtabs %}     |                                            |

{% hint style="danger" %}
We highly advise against using capitals in a command name.
{% endhint %}

#### Viewing custom commands!

There are two ways to view custom commands: a list of all the custom commands or the settings of a particular command.

To view a list of all the custom commands created with your bot run `/cc view list`.

To view a particular command, run `/cc view settings command: <command name>`. This will show you all of settings for that command from the response to who created/edited the command!

#### Editing custom commands!

Editing a custom command is simple! Start by running `/cc edit text|embed name: <command name>`. You are then able to select the option you want changed and replace it with the new value. Keep in mind if you don't edit a certain option it will not change!

#### Deleting custom commands!

To delete a custom command, run `/cc delete command name: <command name>`.

{% hint style="warning" %}
Multiline slash commands are only supported on Discord mobile. \
If you don't have access to a mobile, don't hesitate to contact our support team! We'll happily do it for you.
{% endhint %}