> ## Documentation Index
> Fetch the complete documentation index at: https://docs.overseer-bot.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Punishments

> Configure punishment steps, who can use them and more.

<Note>
  Requires **Manager** or **Guild Administrator** permissions
</Note>

# Overview

Punishments are the core of Overseer's moderation system. They allow for **consistent**, **fair** and **well-audited** handling of rule breaking.\
Moderators can run `/punish <user> <reason>` (with image/video attachments) to mute, kick or ban users depending on how many times they have committed this offence before.

<img src="https://mintcdn.com/overseer/_gZZt-qRvYuTzzmR/images/Figma_0GSLIxi2da.png?fit=max&auto=format&n=_gZZt-qRvYuTzzmR&q=85&s=b793aa6b886812e7d81c5b4136161905" alt="Figma_0GSLIxi2da.png" width="590" height="450" data-path="images/Figma_0GSLIxi2da.png" />

For example, `-p @Dan spamming` would mute Dan for 1 hour on the first offence, 12 hours on the second and lastly 1 week on the third. On subsequent offences, he would be **banned** from the server.

## Evidence

Overseer uniquely **handles media attachments and URLs**. Any images or videos attached when running `-punish` (`-p`) will be consumed and **stored** within each case.\
Similarly, URLs following the reason, e.g. `-p @Dan spamming https://i.imgur.com/image.png` will be **downloaded** and **stored** for that case.

<img src="https://mintcdn.com/overseer/_gZZt-qRvYuTzzmR/images/Discord_AZ0yNJmUcD.png?fit=max&auto=format&n=_gZZt-qRvYuTzzmR&q=85&s=d782b655aab4cfcca6c358dd0d87ebce" alt="Discord_AZ0yNJmUcD.png" width="757" height="473" data-path="images/Discord_AZ0yNJmUcD.png" />

**Where the evidence might look like:**

<Tabs>
  <Tab title="1">
    <img src="https://mintcdn.com/overseer/_gZZt-qRvYuTzzmR/images/DiscordPTB_rLY1o8scLX.png?fit=max&auto=format&n=_gZZt-qRvYuTzzmR&q=85&s=d5e7fc8e16f7520cded57d9b21527312" alt="DiscordPTB_rLY1o8scLX.png" width="1074" height="511" data-path="images/DiscordPTB_rLY1o8scLX.png" />
  </Tab>

  <Tab title="2">
    <img src="https://mintcdn.com/overseer/_gZZt-qRvYuTzzmR/images/DiscordPTB_0j16iljQzj.png?fit=max&auto=format&n=_gZZt-qRvYuTzzmR&q=85&s=382909ea800e15a902c93df6d1a989a7" alt="DiscordPTB_0j16iljQzj.png" width="1103" height="369" data-path="images/DiscordPTB_0j16iljQzj.png" />
  </Tab>

  <Tab title="3">
    <img src="https://mintcdn.com/overseer/_gZZt-qRvYuTzzmR/images/DiscordPTB_wCtjTdOjkr.png?fit=max&auto=format&n=_gZZt-qRvYuTzzmR&q=85&s=7366445ac2ce10e6fab4ea815351eadf" alt="DiscordPTB_wCtjTdOjkr.png" width="1080" height="329" data-path="images/DiscordPTB_wCtjTdOjkr.png" />
  </Tab>
</Tabs>

# Configuration

Punishments are set up via the [dashboard](https://overseer-bot.net/guilds). There are 3 components to a punishment, its:

* Name
* Steps
* Roles

Unlike all other commands, whether a user **can run** `/punish` (`-p`) is determined by whether they have *any* allowed role for that punishment.

## Editing Punishments

<img src="https://mintcdn.com/overseer/_gZZt-qRvYuTzzmR/images/firefox_PRFyJb5FXy.png?fit=max&auto=format&n=_gZZt-qRvYuTzzmR&q=85&s=84cfbe0f4d92cad9c38a85aede832257" alt="firefox_PRFyJb5FXy.png" width="658" height="770" data-path="images/firefox_PRFyJb5FXy.png" />

**Steps can be:**

* **Added** via the button in the top right
* **Edited** by using the select menu (`Mute`, `Kick`, `Ban`) and have its duration changed if it's either a `Mute` or `Ban`.
* **Deleted** by clicking the bin icon to the right of the *last step*.

**Roles** are edited by clicking the left-most button in the top-right corner:

<img src="https://mintcdn.com/overseer/_gZZt-qRvYuTzzmR/images/firefox_VSHt6s5C1V.png?fit=max&auto=format&n=_gZZt-qRvYuTzzmR&q=85&s=61da75926f3bfd5d084e1db55c8e3382" alt="firefox_VSHt6s5C1V.png" width="871" height="1188" data-path="images/firefox_VSHt6s5C1V.png" />

Which means that any user with either the `Administrator 🍁`, `Senior Moderator 🍎` or `Moderator 🍊` role can apply this punishment.

<Warning>
  **Server administrators** and **owners** bypass this requirement, meaning they can run **any** punishment.
</Warning>
