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

# Moderation

***

### **Warning System (Prefix Commands)**

Warnings let you keep a record of user misbehavior. All warnings are stored per server and can be reviewed, cleared, or removed individually.\
Currently, warnings are only available as **prefix commands** (slash versions are coming soon).

| Command                       | Description                                                         |
| ----------------------------- | ------------------------------------------------------------------- |
| `.warn @user [reason]`        | Issues a warning to a user.                                         |
| `.warn list`                  | Shows a server‑wide overview of all warnings (like a leaderboard).  |
| `.warn view @user`            | Displays all warnings for a specific user.                          |
| `.warn remove @user <number>` | Removes a specific warning by its ID (use `.warn view` to see IDs). |
| `.warn clear @user`           | Clears **all** warnings for a user.                                 |

{% hint style="info" %}
**Tip:** Use `.warn list` to get a quick overview of who has the most warnings.
{% endhint %}

***

### **Logging & Auto‑Logs**

Arklynn can log various events (member joins/leaves, moderation actions, voice activity, messages) to a dedicated channel.\
All logging is managed through a single command: `/setup_autologs`.

| Command                                                   | Description                                                     |
| --------------------------------------------------------- | --------------------------------------------------------------- |
| `/setup_autologs category: <category> channel: <channel>` | Sets the channel where logs of the chosen category will appear. |

**Categories:**

* `all` – everything (members, moderation, voice, messages)
* `members` – join, leave, nickname changes, role updates
* `moderation` – kicks, bans, timeouts, warns
* `voice` – voice channel joins/leaves, moves
* `messages` – message edits, deletions, bulk deletions

{% hint style="info" %}
You can set different channels for different categories by running the command multiple times.\
To disable logging for a category, set the channel to `none` (e.g. `/setup_autologs category: moderation channel: none`).
{% endhint %}

***

### [**Other Moderation Tools**](/arklynn-docs/overview/additional.md)

Arklynn also provides the essential moderation commands you’d expect.\
For detailed information, use `/help` in Discord.

| Command (Slash)                       | Command (Prefix)             | Description                                                          |
| ------------------------------------- | ---------------------------- | -------------------------------------------------------------------- |
| `/kick <user> [reason]`               | `.kick <user> [reason]`      | Kicks a member from the server.                                      |
| `/ban <user> [reason] [days]`         | `.ban <user> [reason]`       | Bans a member (optional message deletion days).                      |
| `/timeout <user> <duration> [reason]` | `.timeout <user> <duration>` | Times out a user (mutes them temporarily).                           |
| `/untimeout <user>`                   | `.untimeout <user>`          | Removes an active timeout.                                           |
| `/clear <amount> [user]`              | `.clear <amount>`            | Deletes a number of messages (optionally only from a specific user). |

***

### **Troubleshooting**

* **Warnings aren’t showing up**\
  – Make sure you have the `Manage Messages` permission.\
  – The user must still be in the server.
* **Logs aren’t appearing**\
  – Verify that the bot has `Send Messages` and `View Channel` permissions in the log channel.\
  – Re‑run `/setup_autologs` to confirm the category is correctly set.


---

# 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:

```
GET https://mythicalbot.gitbook.io/arklynn-docs/overview/moderation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.