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

# Moderation & Warning Commands

Moderator commands help staff members effectively and efficiently moderate text and voice channels. These commands can only be used if you have a staff role (eg. moderator, owner). Effective use of moderation commands ensures that community standards are upheld, members feel secure, and discussions remain productive and welcoming for everyone.

## /ban

Removes a user from the server, preventing them from rejoining unless unbanned.

### Syntax

```plaintext theme={null}
/ban [user] [duration, optional] [reason, optional] [days, optional]
```

* **user (required)** – Member to ban.
* **duration (optional)** – Ban length (`1d`, `7d`, `permanent`). Default: permanent.
* **reason (optional)** – Note for logs.
* **days (optional)** – Delete past messages (`0`, `1`, or `7`).

### Examples

```plaintext theme={null}
/ban @username
/ban @username spamming ads
/ban @username 7d harassment in chat
/ban @username 7d spamming links 7
```

***

## /kick

Removes a user from the server without banning them. They can rejoin with an invite.

### Syntax

```plaintext theme={null}
/kick [user] [reason, optional]
```

* **user (required)** – Member to remove.
* **reason (optional)** – Note for logs.

### Examples

```plaintext theme={null}
/kick @username
/kick @username posting slurs in chat
```

***

## /mute

Prevents a user from speaking or typing for a set time.

### Syntax

```plaintext theme={null}
/mute [user] [duration, optional] [reason, optional]
```

* **user (required)** – Member to mute.
* **duration (optional)** – Duration (e.g., `10m`, `1h`, `24h`).
* **reason (optional)** – Note for logs.

### Examples

```plaintext theme={null}
/mute @username
/mute @username 30m
/mute @username 2h flooding voice chat
```

***

## /unmute

Restores a muted user's ability to speak/type.

### Syntax

```plaintext theme={null}
/unmute [user] [reason, optional]
```

* **user (required)** – Member to unmute.
* **reason (optional)** – Note for logs.

### Examples

```plaintext theme={null}
/unmute @username
/unmute @username appeal approved
```

### Notes

* Ensure the user is currently muted; otherwise the command may do nothing.
* Useful after appeal reviews or when a timeout expires early.

***

## /unban

Lifts a ban, allowing a user to return.

### Syntax

```plaintext theme={null}
/unban [user] [reason, optional]
```

* **user (required)** – Banned user’s ID or username#discriminator.
* **reason (optional)** – Note for logs.

### Examples

```plaintext theme={null}
/unban 123456789012345678
/unban 123456789012345678 appeal approved
```

***

## /warn

Issues a formal warning to a member.

### Syntax

```plaintext theme={null}
/warn [user] [reason, optional]
```

* **user (required)** – Member to warn.
* **reason (optional)** – Reason for the warning.

### Examples

```plaintext theme={null}
/warn @username
/warn @username posting NSFW content in general chat
/warn @username spamming links
```

***

## /warnings

Lists the warnings of a specific user.

### Syntax

```plaintext theme={null}
/warnings [user]
```

* **user (required)** – Member to check warnings for.

### Examples

```plaintext theme={null}
/warnings @username
```

***

## /clearwarnings

Clears all warnings of a user.

### Syntax

```plaintext theme={null}
/clearwarnings [user]
```

* **user (required)** – Member whose warnings you want to clear.

### Examples

```plaintext theme={null}
/clearwarnings @username
```

***

## /topwarnings

Shows a ranked list of warnings on the server.

### Syntax

```plaintext theme={null}
/topwarnings
```

### Examples

```plaintext theme={null}
/topwarnings
```

***

## /delwarning

Deletes a warning by its ID.

### Syntax

```plaintext theme={null}
/delwarning [id]
```

* **id (required)** – The warning ID from `/warnings`.

### Examples

```plaintext theme={null}
/delwarning 1
```

***

## /editwarning

Edits the reason of a warning by its ID.

### Syntax

```plaintext theme={null}
/editwarning [id] [new reason]
```

* **id (required)** – The warning ID from `/warnings`.
* **new reason (required)** – Updated text.

### Examples

```plaintext theme={null}
/editwarning 2 updated reason after appeal
```

***

## Notes

* Warnings and moderation logs help maintain accountability.
* Too many warnings may escalate to mute, kick, or ban.
* Always provide clear reasons for transparency.

***

## /timeout

Timing out users allows you to punish users by removing their ability to talk or react using Discord's native Timeout feature.

### Syntax

```plaintext theme={null}
/timeout [user] [duration] [reason, optional]
```

### Examples

```plaintext theme={null}
/timeout @username 60
/timeout @username 60 spamming in general chats
```