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

# Quarantine

> Isolate suspicious or rule-breaking members into a restricted zone.

The Quarantine (or Jail) system allows you to instantly strip a member of all their roles and lock them into a single, isolated channel. This is highly effective for dealing with compromised accounts or severe rulebreakers while staff investigates.

<Note>
  **Required Permission:** Administrator permission + role higher than the target.
</Note>

***

## Absolute Setup Guide

Setting up the Quarantine system takes only one step.

<Steps>
  <Step title="Run the Setup Command">
    ```bash theme={null}
    .quarantine setup @Quarantined #quarantine
    ```

    If you don't have a role and channel ready, the bot will automatically create them for you during the setup process.
  </Step>

  <Step title="Verify Permissions">
    The bot will automatically traverse every channel in your server and explicitly deny the `View Channel` permission for the quarantine role, ensuring the jailed user can only see the designated `#quarantine` channel.
  </Step>
</Steps>

***

## Commands

All commands are located under the `.quarantine` (or `.jail`) group.

| Command                          | Description                                                                  |
| :------------------------------- | :--------------------------------------------------------------------------- |
| `.quarantine @user [reason]`     | Instantly quarantines the target member                                      |
| `.quarantine add @user [reason]` | Instantly quarantines the target member                                      |
| `.quarantine remove @user`       | Restores the member's original roles and removes them from quarantine        |
| `.unquarantine @user`            | Shorthand alias to unquarantine a member                                     |
| `.quarantine show`               | Displays a paginated list of all currently quarantined members               |
| `.quarantine config`             | Shows the active quarantine role and channel configuration                   |
| `.quarantine reset`              | Deletes the quarantine configuration (does not unquarantine current members) |

***

## How It Works

1. **Role Preservation:** When a user is quarantined, ZEON securely saves all of their current roles to its database.
2. **Role Stripping:** The bot then removes all of their roles (except managed bot roles) and gives them the configured Quarantine role.
3. **Restoration:** When you run `.unquarantine`, the bot automatically retrieves their saved roles from the database and restores them exactly as they were.

<Warning>
  * You cannot quarantine the **Server Owner**.
  * You cannot quarantine a member who has a higher or equal role to yourself or the bot.
  * If a quarantined member leaves and rejoins the server, the bot will **automatically re-quarantine** them upon entry to prevent evasion.
</Warning>