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

# Troubleshooting

> The problems people actually hit · permissions, missing roles, quiet modules and late feeds.

## A command says "I don't have permission"

Three different things produce that message:

1. **Discord permission** · the bot's role lacks it. Check the table in
   [Permissions](https://docs.criminal.work/configuration/permissions.md).
2. **Hierarchy** · the target's top role is at or above Criminal's. Move Criminal's role up in
   **Server Settings → Roles**.
3. **Exemption** · the member has Manage Messages, is a bot, or holds an AutoMod-exempt role.

## `/mute` or `/imagemute` does nothing

`/setup mute` hasn't been run, so there's no Muted role to apply. Run it, then re-run it whenever you
add channels outside a category.

## `/jail` doesn't move anyone

`/setup jail` hasn't been run, or the bot can't manage the Jailed role. Honeypots set to `jail` have
the same dependency.

## AutoMod ignores everything

In order of likelihood:

```text theme={null}
/config toggle automod enabled:True
/automod status
```

* The module is off by default.
* The individual rule is off · invites, links, caps, mentions, spam and words each need enabling.
* The member is exempt: staff, bot, or an exempt role or channel.
* The bot lacks **Manage Messages**, so it can't delete.

## Level ups aren't announced

Announcements stay off until a channel exists:

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

Leveling itself must be enabled with `/config toggle levels enabled:True`, and messages only count
after that.

## A level reward role isn't granted

The role sits above Criminal's highest role. `/levelreward set` refuses to save those, so if it saved,
the role was probably moved up afterwards. Move it below the bot's role.

## Sob Board posts nothing

* `starboard-channel` isn't set.
* The message hasn't reached the threshold (default **3**).
* The channel is NSFW, or `@everyone` can't view it · both are skipped.
* The reaction is 😭 only; other emoji are ignored.

## Suggestions say "no suggestion channel is set"

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

## Vanity roles never apply

* The module is off: `/config toggle vanity enabled:True`.
* The keyword doesn't match · it's checked against the **custom status**, not the bio, because Discord
  doesn't expose bios to bots.
* The member is offline; status is only read while they're online.
* The role is above the bot's highest role · `/vanity status` warns about this.

After fixing, run `/vanity rescan` to re-check everyone online.

## Social feeds are late or missing

| Platform | Likely cause |
| - | - |
| YouTube | New uploads can take a few minutes; the platform is checked on a schedule |
| Twitch / Kick | The platform is temporarily rate-limiting the bot |
| Twitter | The post wasn't found by the public feed the bot reads; follows retry automatically |
| Reddit | Anonymous rate limits; checks are spaced out and back off under pressure |

A new follow only announces posts made *after* you followed. After downtime, the newest three missed
items are posted, not the whole backlog.

## Something is broken that isn't on this list

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.