> ## Documentation Index
> Fetch the complete documentation index at: https://docs.celestia.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Reply Config

> Customize command responses with personalized messages and embeds

## Overview

The config system allows you to customize bot responses for commands in your server. Create personalized messages using variables, change reply formats, and make the bot feel unique to your community.

<Info>
  Custom replies support dynamic variables like user mentions, server name, timestamps, and more.
</Info>

***

## Commands

<AccordionGroup>
  <Accordion title="config set" icon="plus">
    Set a custom reply for a command.

    <CodeGroup>
      ```bash Syntax theme={null}
      ~config set <command> <reply> [type=text|embed]
      ```

      ```bash Example theme={null}
      ~config set mute {user.mention} got muted in {server}
      ~config set ban {target} was banned by {moderator}
      ~config set welcome Welcome {user.mention} to our server!
      ~cfg set kick Kicked {target} for {reason}
      ```
    </CodeGroup>

    **Parameters:**

    * **command** — Command name to customize
    * **reply** — Your custom message (supports variables)
    * **type** — Optional: `text` (default) or `embed`

    **Aliases:** `config add`, `config create`, `cfg set`\
    **Permissions:** Manage Server
  </Accordion>

  <Accordion title="config reset" icon="rotate-left">
    Reset a command back to its default reply.

    <CodeGroup>
      ```bash Syntax theme={null}
      ~config reset <command>
      ```

      ```bash Example theme={null}
      ~config reset mute
      ~config reset ban
      ~cfg reset welcome
      ```
    </CodeGroup>

    **What It Does:**

    * Removes your custom reply
    * Restores the original bot response
    * Cannot be undone

    **Aliases:** `config remove`, `config delete`, `cfg reset`\
    **Permissions:** Manage Server
  </Accordion>

  <Accordion title="config list" icon="list">
    List all custom reply configurations in your server.

    <CodeGroup>
      ```bash Syntax theme={null}
      ~config list
      ```

      ```bash Example theme={null}
      ~config list
      ~cfg list
      ~configure show
      ```
    </CodeGroup>

    **What It Shows:**

    * All configured custom replies
    * Command name and type (text/embed)
    * Reply preview (truncated if long)
    * Paginated display (5 per page)

    **Aliases:** `config show`, `config view`, `cfg list`\
    **Permissions:** Manage Server
  </Accordion>

  <Accordion title="config clear" icon="trash">
    Clear all custom reply configurations from your server.

    <CodeGroup>
      ```bash Syntax theme={null}
      ~config clear
      ```

      ```bash Example theme={null}
      ~config clear
      ~cfg clear
      ~configure wipe
      ```
    </CodeGroup>

    **What It Does:**

    * Removes ALL custom replies
    * Shows confirmation prompt
    * 30 second timeout to confirm
    * Cannot be undone

    <Warning>
      This removes all custom configurations. Use with caution!
    </Warning>

    **Aliases:** `config wipe`, `config resetall`, `cfg clear`\
    **Permissions:** Manage Server
  </Accordion>
</AccordionGroup>

***

## Available Variables

Use these variables in your custom replies to create dynamic messages:

| Variable         | Output             |
| ---------------- | ------------------ |
| `{user}`         | User's name        |
| `{user.mention}` | Mentions the user  |
| `{target}`       | Target user's name |
| `{moderator}`    | Moderator's name   |
| `{server}`       | Server name        |
| `{channel}`      | Channel name       |
| `{reason}`       | Action reason      |
| `{duration}`     | Action duration    |
| `{role}`         | Role name          |
| `{timestamp}`    | Current timestamp  |

***

## How It Works

<Steps>
  <Step title="Set a Custom Reply">
    Configure a custom response for a command:

    ```bash theme={null}
    ~config set mute {user.mention} has been muted for {reason}
    ```
  </Step>

  <Step title="Variables are Replaced">
    When the command runs, variables are replaced with actual values:

    ```
    @John has been muted for spamming
    ```
  </Step>

  <Step title="Manage Your Configs">
    View, reset, or clear configurations as needed:

    ```bash theme={null}
    ~config list
    ~config reset mute
    ```
  </Step>
</Steps>

***

## Reply Types

<Tabs>
  <Tab title="Text Replies">
    Simple text messages with variables:

    ```bash theme={null}
    ~config set ban {target} was banned by {moderator} for {reason}
    ~config set kick Kicked {user.mention} from the server
    ~config set mute {user.mention} muted until {timestamp}
    ```

    **Best For:**

    * Quick messages
    * Simple notifications
    * Status updates
  </Tab>

  <Tab title="Embed Replies">
    JSON-formatted embeds for rich messages:

    ```bash theme={null}
    ~config set welcome {"title":"Welcome!","description":"Welcome {user.mention} to {server}"} type=embed
    ```

    **Best For:**

    * Detailed information
    * Formatted announcements
    * Professional appearance

    <Note>
      Embed replies require valid JSON format.
    </Note>
  </Tab>
</Tabs>

***

## Permission Requirements

<CardGroup cols={2}>
  <Card title="Bot Permissions" icon="robot">
    No special permissions required beyond basic message sending.
  </Card>

  <Card title="User Permissions" icon="user">
    Command Requirements:

    * **Manage Server** — Required for all config commands
  </Card>
</CardGroup>

***

## Aliases

All config commands support multiple aliases:

<CardGroup cols={3}>
  <Card title="config" icon="sliders">
    Full command
  </Card>

  <Card title="cfg" icon="c">
    Short alias
  </Card>

  <Card title="configure" icon="gear">
    Alternative
  </Card>
</CardGroup>

***

## Usage Examples

<Tabs>
  <Tab title="Moderation">
    ```bash theme={null}
    # Customize moderation responses
    ~config set ban {target} banned by {moderator} - Reason: {reason}
    ~config set kick {user.mention} was kicked from {server}
    ~config set mute {target} muted for {duration}
    ~config set warn {user.mention} received a warning for {reason}
    ```
  </Tab>

  <Tab title="Welcome/Goodbye">
    ```bash theme={null}
    # Personalize greeting messages
    ~config set welcome Welcome {user.mention} to {server}!
    ~config set goodbye {user} left {server}
    ~config set boost Thanks {user.mention} for boosting!
    ```
  </Tab>

  <Tab title="Role Management">
    ```bash theme={null}
    # Customize role messages
    ~config set roleadd {user.mention} received the {role} role
    ~config set roleremove Removed {role} from {user.mention}
    ~config set rolegive {moderator} gave {role} to {target}
    ```
  </Tab>

  <Tab title="Management">
    ```bash theme={null}
    # View all configurations
    ~config list

    # Reset specific command
    ~config reset mute

    # Clear everything
    ~config clear
    ```
  </Tab>

  <Tab title="Advanced">
    ```bash theme={null}
    # Multiple variables
    ~config set ban {target} banned by {moderator} on {timestamp} for {reason}

    # With timestamps
    ~config set mute Muted {user.mention} at {timestamp}

    # Server context
    ~config set serverinfo Server: {server} | Channel: {channel}
    ```
  </Tab>
</Tabs>

***

## Related Features

<CardGroup cols={2}>
  <Card title="Welcome Messages" icon="hand-wave" href="/welcome">
    Set up automated welcome messages with variables
  </Card>

  <Card title="Server Settings" icon="server" href="/server">
    Configure other server settings and preferences
  </Card>
</CardGroup>