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

# Server Logs

> Every message, member, thread, voice and permission event in one channel.

Point Criminal at a channel and it keeps a record of what happens in the server · deletions, joins,
role changes, channel edits and moderation cases.

```text theme={null}
/config channel log-channel #mod-logs
```

That one setting turns the whole system on. `/config view` → **Logs** opens the per-event switches if
you want to trim it down.

## What gets logged

| Group | Events |
| - | - |
| Messages | Deleted (text, attachments, stickers, embeds, polls), edited, bulk-deleted |
| Members | Join, leave, kick, ban, unban, boost, timeout, role changes, nickname changes, moderation cases |
| Threads and forums | Created (with a post's text, tags and attachments), renamed, locked, tags or slowmode changed, deleted |
| Stages | Started, topic changed, ended |
| Voice | Joined, left, moved, server muted or deafened |
| Channels and roles | Created, deleted, renamed, topic, slowmode, category, permission overwrites, role colour and permissions |
| Server | Name, icon, verification level and similar settings; emoji and stickers added, removed or renamed |
| Other | Invites created and deleted, webhooks, scheduled events, Discord's native AutoMod rules |

Role changes record **who** gave or removed the role, and moderation cases link back to the case
number.

## Reading old deletions

Servers with a log channel and **Message logs** enabled keep recent message text and attachment links
for **7 days**, so a deletion is still readable after Discord's own cache forgets it.

That only covers messages the bot saw while online. Content sent before the log channel was
configured, while the bot was offline, or older than seven days appears by ID only.

Turning **Message logs** off stops new captures; existing rows expire on their own.

## What doesn't get logged

* Changes Criminal makes itself · `/setup mute`, `/channel lock`, booster roles. Those commands write
  their own entry instead of being logged twice.
* Anything the bot can't attribute. Actor names come from the audit log, so Criminal needs **View
  Audit Log**; without it the event is still recorded, just without a "who".

## Format

Each entry has a title, a timestamp shown in the reader's own timezone, and the details · who, where,
and before/after where it applies. Entries never ping anyone.

**Two toggles worth knowing**

**Voice logs** and **Message logs** can each be switched off from `/config view` → **Logs** without
disabling the rest of the system.

## Permissions

| Requirement | Why |
| - | - |
| View Channel + Send Messages in the log channel | Posting entries |
| View Audit Log | Naming who did it |
| Manage Messages (optional) | Restoring cached content for deleted messages |


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