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

# Auto-Mod

> Фильтрация сообщений по правилам: маты, инвайты, ссылки, капс, спойлеры, массовые упоминания и спам — с автоматической эскалацией наказаний.

Auto-Moderation осматривает сообщения по мере отправки и действует на те, что нарушают включённое правило. Бесплатно на любом тарифе.

<Warning>
  **Все восемь правил идут выключенными.** Auto-Moderation ничего не делает, пока вы не включите нужные.
</Warning>

<Warning>
  **Участники с Administrator никогда не фильтруются.** Каждое правило для них пропускается, вне зависимости от конфигурации. Нигде в интерфейсе это не показывается.

  Если вы тестируете правила как администратор, они будут казаться нерабочими. Тестируйте с обычного аккаунта.
</Warning>

## Восемь правил

<AccordionGroup>
  <Accordion title="Bad Words" icon="comment-slash">
    Блокирует сообщения со словами из вашего списка. Запись — до 60 символов.
  </Accordion>

  <Accordion title="Repeated Text" icon="repeat">
    Ловит повторяющиеся символы и избыточные эмодзи.
  </Accordion>

  <Accordion title="Discord Invites" icon="link-slash">
    Блокирует инвайт-ссылки и коды Discord.

    <Note>
      У этого правила **нет экрана конфигурации**. Оно включено или выключено — способа разрешить конкретные серверы из панели нет.
    </Note>
  </Accordion>

  <Accordion title="External Links" icon="globe">
    Фильтрует ссылки на сайты вне Discord, с allowed-domains list.

    <Warning>
      **Пустой allowed-domains list блокирует любые внешние ссылки.** Если включить это правило без добавления доменов, отфильтруются все ссылки. Сначала добавьте разрешённые домены.
    </Warning>
  </Accordion>

  <Accordion title="Excessive Caps" icon="font">
    Срабатывает на сообщениях, в основном заглавными. Применяется только к сообщениям от 7 символов, эмодзи в расчёт не входят.
  </Accordion>

  <Accordion title="Excessive Spoilers" icon="eye-slash">
    Ограничивает число spoiler-тегов в сообщении.
  </Accordion>

  <Accordion title="Mass Mentions" icon="at">
    Ограничивает число упомянутых пользователей или ролей.

    <Warning>
      Лимит **включительный** — сообщение, упоминающее ровно заданный максимум, уже нарушает правило. Установите на единицу выше того, что реально хотите разрешить.

      `@everyone` и `@here` всегда нарушают это правило, независимо от числа.
    </Warning>
  </Accordion>

  <Accordion title="Anti-Spam" icon="gauge-high">
    Rate-limit сообщений на участника.

    <Warning>
      **Поле «Interval (seconds)» ничего не делает.** Оно сохраняется, но бот читает другое хранимое значение, и заданный интервал не применяется. Действует только лимит сообщений.
    </Warning>
  </Accordion>
</AccordionGroup>

## На сообщение срабатывает только одно правило

<Warning>
  Правила оцениваются по порядку, и **побеждает первое совпадение**. Сообщение, нарушающее три правила, запускает одно — самое раннее в списке.

  Три отдельных действия на одно сообщение вы не увидите.
</Warning>

## Действия

| Действие           | Эффект                                            |
| ------------------ | ------------------------------------------------- |
| **Block Message**  | Удаляет нарушающее сообщение                      |
| **Send Alert**     | Публикует уведомление в выбранном канале          |
| **Timeout Member** | Даёт участнику timeout фиксированной длительности |

Длительности timeout — фиксированный набор: 60 секунд, 5 минут, 10 минут, 1 час, 1 день или 1 неделя.

<Warning>
  Два молчаливых поведения:

  * **Send Alert ничего не делает для Repeated Text и Anti-Spam.** Переключатель сохраняется, но алерт не публикуется.
  * **Timeout подавляется во всех правилах, как только у вас настроено хоть одно Automated Action.** Переключатель остаётся включённым и длительность заполненной, но timeout не срабатывает — наказание полностью берут на себя Automated Actions.
</Warning>

Правило не действует на одного и того же участника дважды примерно в течение минуты, так что всплеск сообщений вызывает одно действие, а не десять.

## Исключения

У каждого правила свои **Disabled Channels** и **Disabled Roles**. Правило полностью пропускается для участника с исключённой ролью или в исключённом канале.

<Tip>
  Исключите роли модераторов из правил ссылок и инвайтов — иначе модераторы, публикующие законную ссылку, отфильтруются собственными же серверными правилами.
</Tip>

## Эксклюзивные настройки

Отдельно от восьми правил, они управляют тем, что канал вообще принимает:

| Настройка            | Эффект                                                     |
| -------------------- | ---------------------------------------------------------- |
| **Only Commands**    | Канал принимает только команды                             |
| **No Commands**      | Канал отклоняет команды, с настраиваемым списком префиксов |
| **Only Attachments** | Канал принимает только сообщения с вложением               |

У каждого есть свой список **Allowed Roles** для тех, кто должен обходить это. Пустой список заблокированных префиксов блокирует стандартные `/`, `!`, `#`, `+` и `$`.

## Automated Actions

Эскалирующее наказание по счётчику нарушений участника по всем правилам, а не в рамках одного.

Для каждого действия задаётся наказание, число нарушений, вызывающее его, окно, за которое они считаются, и опционально — какое одно правило учитывать.

<Warning>
  **Warn ничего не делает.** Его выбор записывает строку в лог бота и никаких действий не производит — предупреждение участнику не выдаётся и в его истории предупреждений ничего не появляется.

  Для реального последствия используйте Timeout или Mute.
</Warning>

<Note>
  **Mute применяется как Discord timeout**, а не как mute-роль. Mute и Timeout ведут себя одинаково.
</Note>

Действия оцениваются **от наибольшего числа нарушений к меньшему**, срабатывает первое подходящее. Как только действие сработало, вся история нарушений участника очищается, и эскалация стартует с нуля.

<Info>
  Automated Actions — единственная часть Auto-Moderation, ограниченная тарифом: **1 на Starter**, **50** на любом платном. На лимите кнопка добавления отключена — ссылки на апгрейд на ней нет.
</Info>

## Сохранение

<Warning>
  **Переключатели правил сохраняются по одному.** Если один упал посередине, уже применённые остаются, а остальные — нет. Переоткройте страницу, чтобы увидеть реальное состояние, а не считайте, что весь save откатился.
</Warning>

Пустые списки эксклюзивных настроек хранятся как «unset», а не как пустые списки — это нормально и не потеря настройки.

## Существующие, но недоступные настройки

Несколько хранящихся настроек читает бот, но **в панели их нет**: allow- и block-lists инвайтов, block-list внешних ссылок, режим сопоставления bad words внутри более длинных слов и per-rule mute escalation counts.

Они хранят имеющееся значение и не меняются отсюда.

## Решение проблем

<AccordionGroup>
  <Accordion title="Ничего не фильтруется, когда я проверяю">
    Вы почти наверняка тестируете как администратор. Администраторы освобождены от всех правил.
  </Accordion>

  <Accordion title="Правило включено, но никогда не срабатывает">
    Проверьте исключённые каналы и роли, и помните, что срабатывает только первое совпадающее правило.
  </Accordion>

  <Accordion title="Timeout настроен, но никого не мьютят">
    У вас есть хотя бы одно Automated Action. Это отключает rule-level timeouts везде.
  </Accordion>

  <Accordion title="Алерты не публикуются для спама или повторов">
    Эти два правила алерты не поддерживают, несмотря на переключатель.
  </Accordion>

  <Accordion title="Все ссылки блокируются">
    Ваш список разрешённых доменов пуст. Добавьте те, которые хотите разрешить.
  </Accordion>

  <Accordion title="Изменение сохранилось, но не вступило в силу">
    Конфигурация доходит до бота обычно за \~30 секунд, но до 10 минут, если уведомление пропущено. Подождите, прежде чем пересохранять.
  </Accordion>
</AccordionGroup>

## Связанное

<CardGroup cols={2}>
  <Card title="AI Auto-Mod" icon="sparkles" href="/ru/moderation/ai-auto-mod">
    Ловит намерение, а не точный текст.
  </Card>

  <Card title="Логирование" icon="scroll" href="/ru/moderation/logs">
    Записывайте действия Auto-Moderation для разбора.
  </Card>
</CardGroup>