# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vibez.dev/commands/configuration/custom-commands-cc.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.