> For the complete documentation index, see [llms.txt](https://docs.alphacloud.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.alphacloud.pro/module-moderation/moderation.md).

# Moderation

Verwarnen, stummschalten, kicken und bannen, mit Verlauf, Log Kanal und eigenen Benachrichtigungen.

**Im Panel unter:** Moderation, Moderation

Das klassische Moderationswerkzeug. Es stellt die Moderationsbefehle bereit und schreibt jede Aktion mit, sodass der Verlauf eines Mitglieds erhalten bleibt, auch wenn Kanäle aufgeräumt werden oder das Team wechselt.

## Einrichtung

{% stepper %}
{% step %}

### Modul aktivieren

Schalter oben umlegen.
{% endstep %}

{% step %}

### Moderator Rollen festlegen

Nur Mitglieder mit einer dieser Rollen dürfen die Moderationsbefehle benutzen. Lässt du das Feld leer, kann niemand moderieren.
{% endstep %}

{% step %}

### Mute Rolle einrichten

Klick auf **Mute Rolle erstellen**. Der Bot legt die Rolle an und trägt in jedem Kanal die passenden Verbote ein, sodass ein stummgeschaltetes Mitglied wirklich nirgendwo mehr schreiben kann.
{% endstep %}

{% step %}

### Log Kanal wählen

Dorthin schreibt der Bot zu jeder Aktion ein Embed.
{% endstep %}

{% step %}

### Speichern

{% endstep %}
{% endstepper %}

## Einstellungen

| Einstellung                    | Bedeutung                      |
| ------------------------------ | ------------------------------ |
| **Moderator Rollen**           | Wer die Befehle benutzen darf  |
| **Mute Rolle**                 | Die Rolle, die `/mute` vergibt |
| **Log Kanal**                  | Wohin die Aktions Embeds gehen |
| **Nachrichten bei Sanktionen** | Die fünf DMs, siehe unten      |

## Mute Rolle erstellen und synchronisieren

Zwei Knöpfe, ein Zweck.

* **Mute Rolle erstellen** legt die Rolle an und richtet in jedem vorhandenen Kanal die Verbote ein.
* **Mute Rolle synchronisieren** ergänzt fehlende Kanalberechtigungen nachträglich. Der Fortschritt wird live angezeigt.

{% hint style="warning" %}
**Synchronisiere nach jedem neuen Kanal.** Eine Mute Rolle wirkt nur in Kanälen, in denen sie auch eingetragen ist. Legst du später einen Kanal an, darf ein stummgeschaltetes Mitglied dort schreiben, bis du einmal synchronisierst.
{% endhint %}

## Befehle

| Befehl                         | Wirkung                                                    |
| ------------------------------ | ---------------------------------------------------------- |
| `/warn`                        | Verwarnung mit Grund, wird gespeichert                     |
| `/warnings`                    | Alle Verwarnungen eines Mitglieds anzeigen                 |
| `/unwarn`                      | Eine Verwarnung zurücknehmen                               |
| `/mute`                        | Stummschalten, mit Dauer                                   |
| `/unmute`                      | Stummschaltung aufheben                                    |
| `/kick`                        | Vom Server werfen                                          |
| `/ban`                         | Bannen                                                     |
| `/unban`                       | Bann aufheben                                              |
| `/clear`                       | Mehrere Nachrichten auf einmal löschen                     |
| `/moderation create-mute-role` | Mute Rolle per Befehl erstellen und alle Kanäle einrichten |

## Die fünf Benachrichtigungen

Wird jemand gebannt, gekickt, verwarnt, stummgeschaltet oder wieder freigeschaltet, bekommt er eine DM. Alle fünf gestaltest du im [Message Builder](/grundlagen/message-builder.md) unter **Nachrichten bei Sanktionen** frei.

{% hint style="info" %}
Servername, Grund, Moderator und Dauer stehen in einem **gesperrten Block**. Du kannst ihn innerhalb der Nachricht verschieben, aber nicht entfernen. Sonst erführe das Mitglied nicht, warum es sanktioniert wurde, und hätte auch keinen Weg zum Einspruch.
{% endhint %}

## Zeitlich begrenzte Mutes überstehen einen Neustart

Ein Mute mit Dauer läuft auch dann korrekt ab, wenn der Bot zwischendurch neu startet. Beim Start liest er alle laufenden Mutes ein und stellt die Timer wieder her. Was während der Ausfallzeit abgelaufen wäre, wird sofort aufgehoben.

## Benötigte Rechte

Mitglieder kicken, Mitglieder bannen, Rollen verwalten (für die Mute Rolle), Nachrichten verwalten (für `/clear`), Kanäle verwalten (für die Synchronisierung).

{% hint style="warning" %}
Der Bot kann niemanden moderieren, dessen höchste Rolle über seiner eigenen steht. Zieh die Bot Rolle möglichst weit nach oben.
{% endhint %}

## Verwandt

{% content-ref url="/pages/tbrKozRLQ7s4sVAWT4iY" %}
[AutoMod](/module-moderation/automod.md)
{% endcontent-ref %}

{% content-ref url="/pages/oKJwgfWc0OYlYVsYYhr6" %}
[Logging](/module-moderation/logging.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.alphacloud.pro/module-moderation/moderation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.