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

# FAQ

> How to punish someone, hand out roles, run a giveaway, fix levels and find your way around.

## Getting started

### How do I add Criminal?

Use the [invite link](https://docs.criminal.work/invite.md). You need **Manage Server**, and Criminal's role
must sit above any role it should hand out or remove.

### What should I set up first?

Four commands cover most servers:

```text theme={null}
/setup mute
/setup jail
/config channel log-channel #mod-logs
/config toggle automod enabled:True
```

That gives you mute and image-mute roles, a jail channel, one place for every log entry, and AutoMod.
Everything is re-runnable.

### How do I find a command?

`/help` groups every command by category, and `/help <command>` shows one command's options and who
can use it. If something isn't in `/help`, it isn't available in your server.

### Can I use comma commands?

Yes · set the prefix once with `/config text prefix ,`. Then `,ban @user spamming` works like
`/ban`, and `,help` lists the prefix versions.

## Moderation

### How do I punish someone?

| Want | Use |
| - | - |
| Remove a message | Delete it, or `/purge 50 --user @user` for a range |
| Cool someone down | `/mute @user 10m` or `/imagemute @user 1h` |
| Stop them posting at all | `/jail @user 1h` |
| Kick or ban | `/kick @user reason` · `/ban @user reason` |
| Ban and wipe recent messages | `/mod softban @user` |
| Log it without action | `/warn @user reason` |

Every action creates a numbered case. `/mod case <id>` shows one, `/mod modlogs @user` shows a
member's history, and `/mod warnings @user` lists active warnings.

### How do I stop spam and raids?

Turn on AutoMod, then enable just the rules you need:

```text theme={null}
/config toggle automod enabled:True
/automod filter rule:"server invites" enabled:True
/automod action action:"delete and warn"
```

For bot raids, arm a honeypot channel with `/honeypot edit` · anyone who posts in it is punished
automatically. Staff with Manage Messages are always exempt.

### Someone deleted a message · can I see it?

`/snipe` shows the most recent deleted message in the channel, and `/editsnipe` the last edit. Both
are per channel and in memory only, so they're gone after a restart.

## Roles

### How do members pick their own roles?

Two options, both persistent:

* **Reactions** · `/reactionrole add` binds an emoji to a role. Use `mode:add` for verification so
  un-reacting can't remove access, or `mode:toggle` for interest roles.
* **Buttons and menus** · `/embed` can add role buttons and select menus to a message, which is
  cleaner for a public "click to get access" panel.

Boosters can share their own colour with `/boosterrole share`.

### Criminal says it can't give a role · why?

The role is above Criminal's own top role. Drag Criminal's role higher in **Server Settings → Roles**
and try again. `/vanity status` and `/levelreward set` warn about this before you save.

## Levels and rewards

### How does levelling work?

Each message earns a random **15–25 XP**, once per **60 seconds** per member. The curve is
`50 × level^1.6`, so level 10 takes about 2,000 XP. `/level` draws your rank card, `/ranks` shows the
top 100.

Turn it on and give levels a home:

```text theme={null}
/config toggle levels enabled:True
/config channel levelup-channel #level-ups
```

Rewards are roles at a level: `/levelreward set 10 @Active`. Roles above Criminal's top role are
refused up front.

### Why didn't I get XP for a message?

XP has a 60-second cooldown, so fast chatting doesn't stack. Bots never earn XP, and leveling must be
enabled before messages start counting.

## Engagement

### How do I run a giveaway?

```text theme={null}
/giveaway start prize:"Nitro" duration:3d winners:3
```

Duration caps at 60 days and winners at 25. Members enter with the button on the post; `/giveaway end`
closes early, `/giveaway reroll` picks new winners. Needs **Manage Server**.

### How do suggestions work?

Set a channel, then members post with `/suggest`:

```text theme={null}
/config channel suggestion-channel #suggestions
```

Each suggestion gets up/down voting, and staff close it with `/suggestion approve`, `deny` or
`implemented`. `/suggestion list` shows what's still open.

### What is the Sob Board?

A starboard for the crying emoji. Set a channel and a threshold:

```text theme={null}
/config channel starboard-channel #sob-board
/config number starboard-threshold 3
```

A message needs that many 😭 reactions to be reposted. NSFW channels and channels `@everyone` can't
see are skipped.

### How do vanity roles work?

Criminal reads **custom statuses**, not bios. Set a keyword and a role, and anyone advertising it
gets the role:

```text theme={null}
/config toggle vanity enabled:True
/config role vanity-role @Advertiser
/config text vanity-keyword /yourinvite
```

Only online members are checked · run `/vanity rescan` after changing the keyword.

### How do social feeds work?

`/social add platform:YouTube account:@handle channel:#updates` follows a creator. A server can follow
up to **30** accounts, checks run every 2–10 minutes, and only posts made after you followed are
announced · the newest three after downtime, never the whole backlog.

## Limits and privacy

### What are the limits?

| Thing | Limit |
| - | - |
| Giveaway winners | 25 |
| Giveaway duration | 60 days |
| Social follows per server | 30 |
| Sob Board threshold | Set per server, default 3 |
| Embeds per message | 10 |
| Buttons per row | 5 |

### What does Criminal store about members?

Per server: settings, moderation cases, levels and XP, suggestions and votes, giveaway entries,
starboard mappings, vanity eligibility and name history. Deleted message text is kept for **7 days**
in the log channel, and the snipe cache is in memory only.

### How does someone clear their own data?

`/clearnames` deletes a member's own name history. Everything else belongs to the server's records, so
the server owner decides. Last.fm links are private by default and can be unlinked with
`/lastfm remove`.

## Something is broken

Check [Troubleshooting](https://docs.criminal.work/resources/troubleshooting.md) first · most issues are a missing role, an
unset channel or a module that's still off. If that doesn't cover it, ask in the
[support server](https://discord.gg/wrWcq4Gb46) with the command you ran and the reply you got.


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