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

# Honeypot

> A trap channel that automatically catches and punishes spam bots and raiders.

# Honeypot

> A trap channel that automatically catches and punishes spam bots and raiders.

## Overview

The honeypot creates a decoy channel that legitimate members are told to ignore. Any non-staff member who posts in it is treated as suspicious — their message is deleted instantly, and repeat or spam-like activity triggers an automatic punishment.

Detection combines two signals:

* **Rate limiting** — more than 3 messages in 10 seconds from the same member triggers the punishment immediately.
* **AI judgement** — each message is analysed by the built-in security model to catch spam, scams, and raid content even at low volume.

<Info>
  Members with the **Manage Server** permission are never punished by the honeypot, so staff can safely test it.
</Info>

***

## Setup

<Steps>
  <Step title="Create the honeypot channel">
    ```bash theme={null} theme={null}
    ;honeypot setup
    ```

    Creates a channel named `#chat` with a warning notice and a live "Caught" counter. Leave it where new or suspicious members will see it.
  </Step>

  <Step title="Choose the punishment">
    ```bash theme={null} theme={null}
    ;honeypot action (mute/role)
    ```

    ```bash theme={null} theme={null}
    ;honeypot action mute
    ```

    Use `mute` to time the member out, or `role` to assign a punishment role (set below).
  </Step>

  <Step title="Set the punishment role (only if using role)">
    ```bash theme={null} theme={null}
    ;honeypot role (@role)
    ```

    ```bash theme={null} theme={null}
    ;honeypot role @Quarantine
    ```
  </Step>
</Steps>

***

## Commands

All commands require the **Manage Server** permission. Alias: `;hp`.

| Command                        | Description                                     |
| ------------------------------ | ----------------------------------------------- |
| `;honeypot setup`              | Create the honeypot channel and monitor message |
| `;honeypot action (mute/role)` | Set the punishment: `mute` or assign a `role`   |
| `;honeypot role (@role)`       | Role to assign when the action is set to `role` |
| `;honeypot disable`            | Delete the honeypot channel and turn it off     |

***

## How punishment works

When a non-staff member posts in the honeypot channel:

1. The message is deleted immediately.
2. If they exceed 3 messages in 10 seconds, or the AI flags the content, the configured action is applied.
3. The "Caught" counter on the honeypot message increases.

<Warning>
  If you set the action to `role` but never configure a punishment role, offenders will still have their messages deleted but no role is applied. Always pair `;honeypot action role` with `;honeypot role`.
</Warning>