> For the complete documentation index, see [llms.txt](https://docs.iynxdev.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iynxdev.com/premium-addons/command-maker.md).

# 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.

***