# Punishment logs

> Record what players were punished for, with evidence, from Discord, the website or in game, and look anyone up.

A **punishment log** is a record of what a player did and what your staff did about it: a warning, a kick, a ban, a BOLO, or any type you add. Each one has a case number, and is posted in your **punishment log channel**.

## Logging a punishment

<Tabs>
  <Tab title="Discord">
    ```discord
    /punishment log username:Sam_RP
    ```

    A form asks for the type, the reason and any **evidence files**, which Jellyn posts with the case in the log channel. Leave `username` out to type the player in the form.
  </Tab>
  <Tab title="Website">
    On **Punishment logs**, or in the [moderator panel](/moderation/moderator-panel), fill in the player, the type and the reason. Drop evidence files on the form: each uploads as soon as it is picked.
  </Tab>
  <Tab title="In game">
    Staff with a verified Roblox account type in ER:LC:

    ```erlc
    :log warning Sam_RP Failure to roleplay
    ```

    That is `:log type name reason`. It's on by default, and needs your [ER:LC server linked](/erlc/connect). Kicks and bans your staff run in game can be logged by themselves too. See [Game features](/erlc/game-features#logging-from-the-game).
  </Tab>
</Tabs>

## Evidence files

Up to **5 files** a punishment, **10 MB** each and **25 MB** together:

| Kind | Files |
| --- | --- |
| Pictures | PNG, JPEG, GIF, WebP |
| Videos | MP4, MOV, WebM |
| Text | `.txt`, `.log`, `.md`, `.csv` |
| Documents | PDF |

What a file is comes from what is in it, never from its name. Every file shows on the log as a tile; pictures, videos, PDFs and text open in the browser, and anyone on your staff can download them.

<Note>
  A file uploaded on the website but never logged is deleted after a day. Until the case is logged, only whoever uploaded it can open it.
</Note>

## Looking players up

| Command | Does |
| --- | --- |
| `/punishment view case:42` | Shows case #42, with how many files it has and where to download them |
| `/punishment history username:Sam_RP` | A player's recent cases |

On the website, the **Punishment logs** page loads 25 at a time, with a search; the moderator panel's **Player logs** shows the newest. Clicking a player anywhere opens their **player card**: their logs, and actions for them.

## Types and rules

On **Types and rules**, management sets:

- **Punishment types**: what staff choose when logging a punishment, in your order (hold the grip and slide one to move it). Give a type an **in-game command** and staff can carry it out in ER:LC while logging it; `{player}` and `{reason}` are filled in.
- **Staff rules**: what staff can do, on the website and in Discord. Management can always log bans and run commands.

A type you remove stays on the logs that already use it.

## Voiding a punishment

A punishment logged by mistake can be **voided** by staff with the **Void punishments** permission. A voided log stays in the record, marked as voided, and the change is in the [audit log](/moderation/audit-log).

## BOLOs

A **BOLO** (be on the lookout) is a punishment waiting for the player to be caught. With **Complete BOLOs as bans** on (on **Game features**), staff who may run bans in game get **Complete as ban** on active BOLOs: Jellyn bans the player in game, logs the ban and marks the BOLO done. Jellyn can also ban players with an active BOLO as soon as they join; see [Automations](/erlc/automations).
