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

# Moderation

> A full moderation system for Yapin servers.

![Moderation settings](https://mintcdn.com/doge-bot/dz3aJKoyl9lPQ6tb/images/yapin/module-moderation.png?fit=max\&auto=format\&n=dz3aJKoyl9lPQ6tb\&q=85\&s=74baf02172b46d1c67c1c2a42a743ad0)

**1. 1. On or off**

Switch the module on. Its commands appear in Yapin's `/` menu.

**2. 2. Server**

Pick the server, so channels and roles can be chosen below.

**3. 3. Who's staff**

People with a role that can **manage messages** are moderators, **manage server** are admins, and the server owner can do everything. Add extra moderator or admin roles here.

![More moderation settings](https://mintcdn.com/doge-bot/dz3aJKoyl9lPQ6tb/images/yapin/module-moderation-2.png?fit=max\&auto=format\&n=dz3aJKoyl9lPQ6tb\&q=85\&s=b7eed7c86c0b19084ba5d2f0f3da86f1)

**1. 1. Log channel**

Every ban, kick, time out and warning is posted here as a numbered case.

**2. 2. DM members**

Tells the member what happened and why, before a kick or ban while they can still be reached.

**3. 3. Automatic punishment**

When someone reaches a number of warnings: a time out, kick or ban.

## Commands

| Command | How to use it | Who |
| - | - | - |
| `/ban` | `/ban @member spamming links` | Staff |
| `/tempban` | `/tempban @member 1d raid` | Staff |
| `/unban` | `/unban @member` or their ID | Staff |
| `/kick` | `/kick @member reason` | Staff |
| `/timeout` | `/timeout @member 10m reason` (up to 28 days) | Staff |
| `/untimeout` | `/untimeout @member` | Staff |
| `/warn` | `/warn @member be nice` | Staff |
| `/history` | `/history @member` | Staff |
| `/case` · `/delcase` | `/case 12` · `/delcase 12` | Staff |
| `/clearhistory` | `/clearhistory @member` | Admins |
| `/note` · `/notes` · `/delnote` | `/note @member text` · `/notes @member` · `/delnote 3` | Staff |
| `/purge` | `/purge 50` or `/purge 50 @member` | Staff |
| `/slowmode` | `/slowmode 30s` or `/slowmode off` | Staff |
| `/lock` · `/unlock` | `/lock raid in progress` | Staff |
| `/nick` | `/nick @member New name` or `reset` | Staff |
| `/role` | `/role give @member @Role` · `/role take …` | Admins |
| `/temprole` | `/temprole @member @Role 1d` | Admins |
| `/voicekick` | `/voicekick @member` | Staff |
| `/userinfo` · `/serverinfo` | `/userinfo @member` | Everyone |
| `/ping` | `/ping` | Everyone |
| `/say` | `/say Hello everyone` | Admins |

Times are written like `30s`, `10m`, `2h`, `1d`, `1w` or combined: `1h30m`. Typing a command on its own shows how to use it.

## How it keeps things fair

* Nobody can act on themselves, the bot, the server owner, or someone with the **same or a higher role**.
* Every punishment becomes a **case** with a number, the moderator, the reason and the time.
* Temporary bans and roles **end on their own**.
* Each punishment has its own colour and icon in its embed: 🔨 ban, ⏳ temp ban, 👢 kick, 🔇 time out, ⚠️ warning, 🔓 unban.

> [!TIP]
>
> The bot's role on Yapin needs the matching permissions (Ban, Kick, Timeout, Manage messages, Manage channels, Manage roles, Manage nicknames, Move members) and must sit above the members it acts on.


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