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

# Level-up Messages

> Announce levels in chat and congratulate members in DMs.

Two separate messages fire when someone levels up.

```text theme={null}
/config channel levelup-channel #levels
/config levelup message "{user} reached level {level}."
/config levelup dm "Congratulations {user}, level {level} in {server}!"
```

## Defaults and toggles

| Setting | Default | Meaning |
| - | - | - |
| Chat announcement | **Off** | Enable with `/config toggle level-announcements enabled:True` |
| DM | **On** | Disable with `/config toggle levelup-dms enabled:False` |
| `levelup-channel` | none | Chat messages post nowhere until this is set |

The chat announcement needs both the toggle **and** a channel. The DM only needs the member to have
DMs open from the server.

## Placeholders

| Token | Output |
| - | - |
| `{user}` | The member |
| `{level}` | The level they reached |
| `{server}` | Server name |
| `{user.name}` · `{user.display}` | Username · display name |

Both messages accept embed scripts, so the announcement can be a card rather than a line.

## Notes

* Level-up only fires on the level the member *reaches*, not on every XP gain.
* Resetting with `/config levelup reset` restores both stock texts and leaves the channel and toggles
  alone.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.