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.

​

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. 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. Where the evidence might look like:

​

Configuration

Punishments are set up via the dashboard. 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

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: Which means that any user with either the Administrator 🍁, Senior Moderator 🍎 or Moderator 🍊 role can apply this punishment.