# Command Maker

## <mark style="color:blue;">Overview</mark>

The **Command Maker** addon empowers you to create custom slash commands and interactive buttons without writing any code. Build automated workflows, create interactive menus, send predefined messages, assign roles, and much more - all through simple configuration.

***

## <mark style="color:blue;">Table of Contents</mark>

1. **Features**
2. **Installation**
3. **Key Concepts**

***

## <mark style="color:blue;">Features</mark>

### <mark style="color:yellow;">Custom Commands</mark>

* <mark style="color:red;">**Up to 5 Custom Commands:**</mark> Create multiple unique slash commands for your server
* <mark style="color:red;">**Command Parameters:**</mark> Add arguments to your commands (user mentions, text input with predefined options)
* <mark style="color:red;">**Flexible Responses:**</mark> Send rich embed messages using predefined message templates
* <mark style="color:red;">**Permission Control:**</mark> Restrict command usage based on your server's permission levels
* <mark style="color:red;">**Advanced Actions:**</mark> Execute multiple actions like role assignment, channel messaging, and DM sending

### <mark style="color:yellow;">Custom Buttons</mark>

* <mark style="color:red;">**Unlimited Custom Buttons:**</mark> Create interactive buttons to attach to any bot message
* <mark style="color:red;">**Multiple Styles:**</mark> Choose from Primary (Blue), Secondary (Gray), Success (Green), Danger (Red), or Link buttons
* <mark style="color:red;">**Custom Emojis:**</mark> Add visual flair with custom or standard Discord emojis
* <mark style="color:red;">**Smart Responses:**</mark> Update existing messages or send new ephemeral/public responses
* <mark style="color:red;">**Automated Workflows:**</mark> Chain actions together for complex automation

***

## <mark style="color:blue;">Installation</mark>

{% hint style="warning" %}
**This is a premium addon!** You must purchase this addon separately and have a valid license.
{% endhint %}

1. Download the Command Maker addon files from your purchase
2. Extract all files into the `plugins/` folder of your Athena Bot installation
3. Restart your bot to load the addon
4. Configure the addon using the `command_maker.json` file in your `configuration/` folder

***

## <mark style="color:blue;">Key Concepts</mark>

### <mark style="color:yellow;">Predefined Messages</mark>

Predefined messages are reusable message templates that you create using the `/sendmsg` and `/editmsg` commands. These templates can include:

* Custom embeds with titles, descriptions, colors, and fields
* Images, thumbnails, and attachments
* Formatted text with markdown support

Once created, you save them with a unique ID and reference that ID in your command or button configuration.

### <mark style="color:yellow;">Actions</mark>

Actions are automated tasks that execute when a command is run or a button is clicked. Available actions include:

* **CHANNEL\_SEND:** Send a message to a specific channel
* **USER\_SEND:** Send a direct message to a user
* **ROLE\_APPLY:** Add a role to the user who executed the command/button
* **ROLE\_REMOVE:** Remove a role from the user who executed the command/button

### <mark style="color:yellow;">Placeholders</mark>

Use dynamic placeholders in your action targets:

* `%user_id%` - The ID of the user who executed the command/clicked the button
* `%string_args_1%` - The value of the first STRING parameter (for commands with parameters)

### <mark style="color:yellow;">Components</mark>

Components (currently buttons) can be attached to any message sent by your bot. Use the `/buttons` command to add your custom buttons to existing bot messages, or reference them in your custom command responses.

***


---

# 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.iynxdev.com/premium-addons/command-maker.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.
