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

# Moderation: Warn, Kick, Mute, Ban, and Case History

> Warn, kick, mute, and ban members with automatic logging to a searchable case history. Seshy tracks every moderation action for full staff accountability.

Seshy's Moderation module gives your staff team a complete toolkit for managing members, with every action automatically logged to a searchable case history. From informal warnings to permanent bans, each moderation action is timestamped, attributed to the moderator who issued it, and stored in a case record that any authorized staff member can look up. This creates a transparent, auditable record that keeps your team accountable and helps you spot repeat offenders before small problems become large ones.

<Note>
  Moderation commands respect the Permission Hierarchy configured in `/settings → Permissions`. Only roles assigned the appropriate permission level can run each command — for example, only senior staff may be able to issue bans while junior staff are limited to warns and mutes.
</Note>

## Available Actions

Seshy covers the full range of standard moderation actions. Each action accepts a required target and an optional reason that is recorded in the case log and included in the audit log embed.

<Tabs>
  <Tab title="Warn">
    Issue a formal warning to a member. The warn is logged as a case in the member's history and posted to your audit log channel. Use warns for first offences or minor rule violations where removal from the server isn't warranted yet. Warns feed into the infraction escalation system configured in the Staff Module.
  </Tab>

  <Tab title="Kick">
    Remove a member from the server without preventing them from rejoining. Kicks are appropriate for moderate violations where a permanent ban is excessive. The action is logged with the moderator's name, reason, and timestamp.
  </Tab>

  <Tab title="Mute / Timeout">
    Silence a member for a specified duration using Discord's native timeout system. The member cannot send messages or join voice channels for the duration. Specify the length in the command (e.g., `1h`, `30m`, `7d`) and include a reason for the log.
  </Tab>

  <Tab title="Ban">
    Permanently ban a member from the server. Bans include an optional message deletion window so you can clear recent messages from the banned member at the same time. The ban is logged with full details and cross-referenced in the case history.
  </Tab>

  <Tab title="Unban">
    Remove a previously issued ban by providing the banned user's Discord ID. Seshy logs the unban action and attributes it to the moderator who issued it, keeping the full ban/unban timeline visible in the case history.
  </Tab>
</Tabs>

## Case History

Every moderation action Seshy processes creates a case record automatically. Cases are numbered sequentially and stored in a searchable log. You can look up cases by:

* **User** — view all cases against a specific member
* **Moderator** — see every action a specific staff member has taken
* **Case type** — filter by warn, kick, mute, or ban
* **Date range** — narrow results to a specific time window

This makes it straightforward to build a history before escalating action on a repeat offender, to audit a staff member's moderation conduct, or to pull evidence when handling an appeal.

<Info>
  Cases are permanent records. Even if a member leaves and rejoins your server, their case history is retained and will appear when you search by their Discord user ID.
</Info>

## Audit Logging

Every moderation action Seshy processes also posts a structured embed to your configured audit log channel in real time. Each audit log entry includes:

* **Moderator** — the staff member who issued the action
* **Target** — the member who was moderated
* **Action type** — warn, kick, mute, ban, or unban
* **Reason** — the reason provided at the time of the action
* **Timestamp** — the exact time the action was taken
* **Case ID** — a reference number that links back to the full case record

Configure your audit log channel in `/settings → Moderation` so every action is captured in a dedicated channel your staff can monitor.

<Warning>
  If no audit log channel is configured, Seshy will still log cases internally — but your staff won't see real-time action embeds in Discord. Set up your audit log channel before your moderation team starts using Seshy.
</Warning>

## Moderation Desk (Dashboard)

The web dashboard's **Moderation Desk** provides a live staff panel for managing moderation actions visually — browse case history, filter by action type, review moderator activity, and issue actions without typing commands. The Moderation Desk is part of the v2 dashboard currently in development.

<Card title="Moderation Desk" icon="display" href="/dashboard/moderation-desk">
  Open the Moderation Desk to browse cases, review staff activity, and manage moderation actions from a visual interface.
</Card>

## Configuration

Set up your Moderation module in `/settings → Moderation`:

<Steps>
  <Step title="Set your audit log channel">
    Choose the channel where Seshy will post real-time moderation action embeds. Dedicate a private channel visible only to staff so the log stays clean and accessible.
  </Step>

  <Step title="Assign staff roles">
    Map your server's staff roles to Seshy permission levels so the right people can run the right commands. Configure this in `/settings → Permissions`.
  </Step>

  <Step title="Configure infraction thresholds (optional)">
    If you want warns to automatically escalate to timeouts or bans at defined thresholds, configure the escalation ladder in `/settings → Staff Module → Infractions`.
  </Step>
</Steps>

<Tip>
  The Ares Security module handles automated threats such as nukes, raids, and unauthorized bot additions separately — it operates independently of your staff team with a sub-second response time and requires no manual intervention. The Moderation module is for deliberate, manual staff actions against specific members.
</Tip>

## Key Commands

| Command                           | Description                                    |
| --------------------------------- | ---------------------------------------------- |
| `/warn @user [reason]`            | Issue a formal warning to a member             |
| `/kick @user [reason]`            | Kick a member from the server                  |
| `/mute @user [duration] [reason]` | Mute or timeout a member for a set duration    |
| `/ban @user [reason]`             | Permanently ban a member                       |
| `/unban [user-id]`                | Remove a ban by Discord user ID                |
| `/case view [case-id]`            | View the details of a specific moderation case |
| `/cases @user`                    | View all moderation cases for a member         |
| `/history @user`                  | View the full moderation history for a member  |