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

# Configuration

> Every per-server setting, edited through one command.

All server settings live in the bot's database and are edited with `/config`. Nothing is written back to the source tree, so a `git pull` never overwrites your configuration.

## The panel

```text theme={null}
/config view
```

Opens a private panel with a category picker · **Channels**, **Roles**, **Toggles**, **Text**, **Numbers**, **Logs** and **Bot** · and side buttons for editing each setting inline. Changes apply immediately; there's no save step and no restart.

## Typed forms

When you know what you're changing, the typed forms are faster:

```text theme={null}
/config channel log-channel #mod-logs
/config role    vanity-role @Advertiser
/config toggle  levels enabled:True
/config text    prefix ,
/config number  starboard-threshold 5
/config text    welcome-message "Welcome {user} to {server}"
```

If a channel or role is deleted, the setting is simply unresolved · dependent features go quiet instead of erroring.

## Settings by area

| Setting | Used by |
| - | - |
| `log-channel` | Server logs, moderation records, AutoMod hits, honeypot catches |
| `mute-role` / `imagemute-role` | `/mute` and `/imagemute` (created by `/setup mute`) |
| `suggestion-channel` | `/suggest` |
| `starboard-channel` / `starboard-threshold` | Sob Board |
| `levelup-channel`, `levelup-message`, `levelup-dm-message` | Levels announcements and DMs |
| `vanity-role`, `vanity-channel`, `vanity-keyword` | Vanity roles |
| `welcome-channel`, `goodbye-channel`, `boost-channel` | Join, leave and boost announcements |
| `welcome-message`, `goodbye-message`, `boost-message` | The text of those announcements |
| `autorole` | A role given to every member who joins |
| `prefix` | Prefix commands |

Toggles and numbers follow the same pattern: `/config toggle <name> enabled:True` and `/config number <name> <value>`.

## Preview

```text theme={null}
/config preview setting:welcome-message
```

Renders a message exactly as it will send · current template, current channel, real member context · and lets you edit it from the same panel. Use it before a busy welcome channel finds the typo first.

## Aliases

`/config alias` turns a short word into a text command. An alias runs with the permissions of the member who typed it, so it can never hand out access somebody didn't already have.

```text theme={null}
/config alias add    shortcut:shh command:timeout {0} 10m
/config alias view   shortcut:shh
/config alias list
/config alias remove shortcut:shh
```

`,shh @member` now runs `,timeout @member 10m`. `{0}`, `{1}`… take the words the member typed, in order, and unused words are appended · so a plain `ban` alias still forwards the reason.

> [!NOTE]
>
> `/ban` can't be wrapped by an alias, and the bot says so when you try. Aliases exist for the prefix surface, not the slash one.

## Bot persona

Change how Criminal appears **in this server only** · name, avatar, banner and bio · without touching any other server it's in.

```text theme={null}
/config bot name   Criminal Support
/config bot avatar <image>
/config bot banner <image>
/config bot bio    "Need help? Open a ticket."
/config bot reset
```

Images must be PNG, JPG, GIF or WEBP under 8 MB and at least the required resolution; anything smaller is refused rather than stretched. The prefix twins are `,bot name`, `,bot avatar`, `,bot banner`, `,bot bio` and `,bot profile reset`.

## Message templates

Welcome, goodbye, boost, level-up and vanity messages are all templates with placeholders, and all accept embed scripts. They have their own page:

> [card] [Welcome, Goodbye & Boosts](https://docs.criminal.work/features/messages.md)
>
> Channels, templates, placeholders and previews.

Each group also resets on its own:

```text theme={null}
/config welcome reset
/config goodbye reset
/config boost reset
/config levelup reset
/config vanity reset
```

## Reset

`/config view` → category → setting → clear restores a single value to its default.

```text theme={null}
/config reset
```

Wipes every setting in the server back to defaults · channel targets, roles, toggles, text, numbers and aliases. It asks for confirmation first and only affects the server you ran it in.


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