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

# Greet

> Create multiple, fully customizable welcome messages with dynamic cards.

Greet is the most powerful welcome system. Unlike basic welcomers, it supports **multiple named configurations** per server (up to 10), each with its own message, channel, auto-delete timer, and optional dynamic welcome card with over 25 visual themes.

<Note>
  **Required Permission:** [Admin Access](/permissions/admin-access) or higher — Server Owner, Extra Owner, Trusted User, or Administrator with a role above the bot can use these commands.
</Note>

## Setting Up

Follow these steps to create your first welcome message.

<Steps>
  <Step title="Create a Welcome Message">
    Give it a name and provide the message text.

    ```bash theme={null}
    .greet create main Welcome to {servername}, {user}! You are member #{servermembercount}.
    ```

    A preview of the message will be shown before saving.
  </Step>

  <Step title="Set the Channel">
    Assign a channel where the welcome message will be sent.

    ```bash theme={null}
    .greet channel set main #welcome
    ```
  </Step>

  <Step title="Test It">
    Send a test message to verify the output looks correct.

    ```bash theme={null}
    .greet test main
    ```
  </Step>
</Steps>

<Note>
  You can create up to **10 separate welcome messages** per server, each with a unique name, channel, and settings. This lets you send different messages to different channels from a single join event.
</Note>

***

## Commands

### Creating & Deleting

| Command                       | Description                         |
| :---------------------------- | :---------------------------------- |
| `.greet create <name> <text>` | Creates a new named welcome message |
| `.greet delete <name>`        | Deletes a saved welcome message     |

### Channel Management

| Command                               | Description                                     |
| :------------------------------------ | :---------------------------------------------- |
| `.greet channel set <name> <channel>` | Sets the channel for a specific welcome message |
| `.greet channel reset <name>`         | Resets the channel for a welcome message        |

### Welcome Card

| Command                           | Description                                        |
| :-------------------------------- | :------------------------------------------------- |
| `.greet card <name> <true/false>` | Enables or disables the dynamic welcome card image |
| `.greet style <name> <style>`     | Sets the visual theme for the welcome card         |

### Available Card Styles

Choose from **25 unique visual themes** to match your server's aesthetic:

<AccordionGroup>
  <Accordion title="Nature" icon="leaf">
    * `nature` — Lush greenery and natural landscapes
    * `forest` — Deep woodland scenery
    * `beach` — Sandy shores and ocean waves
    * `ocean` — Deep blue underwater vibes
    * `mountains` — Snowy peaks and alpine views
    * `desert` — Warm golden sand dunes
    * `snow` — Winter wonderland aesthetic
  </Accordion>

  <Accordion title="Atmosphere" icon="sun">
    * `sunset` — Warm orange and pink sky gradients
    * `aurora` — Northern lights color palette
    * `tropical` — Vibrant island paradise
    * `autumn` — Fall foliage and warm tones
    * `sakura` — Japanese cherry blossom theme
  </Accordion>

  <Accordion title="Space & Sci-Fi" icon="rocket">
    * `space` — Stars, nebulas, and galaxies
    * `cosmic` — Deep space color palette
    * `cyberpunk` — Neon-lit futuristic cityscape
    * `neon` — Bright glowing neon colors
  </Accordion>

  <Accordion title="Urban & Art" icon="city">
    * `city` — Modern urban skyline
    * `anime` — Japanese anime-inspired art
    * `fantasy` — Magical and mystical themes
    * `abstract` — Modern abstract art patterns
  </Accordion>

  <Accordion title="Minimal & Retro" icon="palette">
    * `minimal` — Clean, simple design
    * `gradient` — Smooth color transitions
    * `dark` — Sleek dark mode aesthetic
    * `vintage` — Retro and nostalgic tones
    * `pastel` — Soft, muted pastel colors
  </Accordion>
</AccordionGroup>

### Auto-Delete

| Command                           | Description                                  |
| :-------------------------------- | :------------------------------------------- |
| `.greet autodelete <name> <time>` | Sets an auto-delete timer (e.g. `10s`, `2m`) |
| `.greet autodelete <name> off`    | Disables auto-delete for the message         |

### Controls

| Command                 | Description                                            |
| :---------------------- | :----------------------------------------------------- |
| `.greet enable <name>`  | Enables a welcome message                              |
| `.greet disable <name>` | Disables a welcome message                             |
| `.greet test <name>`    | Sends a test welcome message to the configured channel |
| `.greet config`         | Shows all saved welcome configurations for the server  |

***

## Dynamic Welcome Cards

The Greet module can generate a beautiful welcome card image alongside your message. The card automatically displays the member's avatar, username, member number, and server name.

<Steps>
  <Step title="Enable the Card">
    ```bash theme={null}
    .greet card main true
    ```
  </Step>

  <Step title="Pick a Theme">
    Choose from 25 visual themes to match your server's aesthetic.

    ```bash theme={null}
    .greet style main cyberpunk
    ```
  </Step>
</Steps>

<Warning>
  * The auto-delete timer must be between **3 seconds** and **5 minutes** (300s).
  * If a welcome message has no channel set, it will not trigger on member join.
</Warning>

***

## Customizing Messages

Each welcome message is fully customizable and supports both **dynamic variables** and **custom embeds**.

### Using Variables

You can dynamically insert information like the user's name, server name, or member count. Refer to the [Variables](/resources/variables) reference for the full list.

**Available contexts:** Server, Channel, User, Author, Target

<CodeGroup>
  ```bash Input theme={null}
  .greet create vip Welcome {user} to {servername}! Enjoy your stay in {channel}.
  ```

  ```text Output theme={null}
  Welcome @john_doe to ZEON Official! Enjoy your stay in #welcome.
  ```
</CodeGroup>

### Using Custom Embeds

Design a rich embed using the interactive embed builder, then attach it to your message with the `{embed:name}` syntax. You can use up to **3 embed variables** per welcome message.

<Steps>
  <Step title="Create the Embed">
    ```bash theme={null}
    .embed create welcome_banner
    ```

    Use the dropdown menu to customize title, description, color, images, and variables.
  </Step>

  <Step title="Attach to Message">
    ```bash theme={null}
    .greet create fancy {user} just joined! {embed:welcome_banner}
    ```
  </Step>
</Steps>

<Note>
  The `{embed:name}` placeholder is invisible in the final output. The bot strips it from the text and attaches the rich embed below the message. Variables placed inside the embed builder will also parse correctly.
</Note>

### Limitations

<Warning>
  * Each server can have a maximum of **10 welcome messages**.
  * Each welcome message can use up to **3 embed variables** (`{embed:name}`).
  * Welcome messages with no channel set will **not trigger** on member join — always set a channel after creating.
  * If the configured channel is deleted, that specific welcome message will silently fail until a new channel is set.
</Warning>