> ## 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, зі списком дозволених доменів.

    <Warning>
      **Порожній список дозволених доменів блокує кожне зовнішнє посилання.** Якщо ввімкнути це правило без доменів, усі посилання будуть відфільтровані. Спершу додайте потрібні домени.
    </Warning>
  </Accordion>

  <Accordion title="Excessive Caps" icon="font">
    Спрацьовує на повідомленнях переважно у верхньому регістрі. Застосовується лише до повідомлень від семи символів; емодзі не враховуються в обрахунку.
  </Accordion>

  <Accordion title="Excessive Spoilers" icon="eye-slash">
    Обмежує кількість спойлер-тегів у повідомленні.
  </Accordion>

  <Accordion title="Mass Mentions" icon="at">
    Обмежує, скільки користувачів чи ролей може згадувати повідомлення.

    <Warning>
      Ліміт **inclusive** — повідомлення з рівно налаштованим максимумом уже порушує правило. Ставте на одиницю більше, ніж хочете реально дозволити.

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

  <Accordion title="Anti-Spam" icon="gauge-high">
    Обмеження частоти повідомлень на учасника.

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

## На одне повідомлення спрацьовує лише одне правило

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

  Трьох окремих дій за одне повідомлення не буде.
</Warning>

## Дії

| Дія                | Ефект                                       |
| ------------------ | ------------------------------------------- |
| **Block Message**  | Видаляє повідомлення-порушника              |
| **Send Alert**     | Публікує повідомлення в обраний канал       |
| **Timeout Member** | Тимчасово блокує учасника на фіксований час |

Тривалості timeout фіксовані: 60 секунд, 5 хвилин, 10 хвилин, 1 година, 1 день або 1 тиждень.

<Warning>
  Дві тихі поведінки, які варто знати:

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

Правило не діятиме на того ж учасника двічі протягом приблизно хвилини — тож серія повідомлень дає одну дію, а не десять.

## Виключення

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

<Tip>
  Виключіть модераторські ролі з правил про посилання й інвайти — інакше модератори, які постять законне референс-посилання, будуть відфільтровані власним сервером.
</Tip>

## Exclusive settings

Окремо від восьми правил — вони керують тим, що канал взагалі приймає:

| Налаштування         | Ефект                                                      |
| -------------------- | ---------------------------------------------------------- |
| **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>
  **Перемикачі правил зберігаються по одному.** Якщо один із них падає посередині, застосовані до нього залишаються застосованими, а решта — ні. Перезавантажте сторінку, щоб побачити фактичний стан, а не думати, що все збереження відкотилося.
</Warning>

Порожні списки exclusive-settings зберігаються як «unset», а не як порожні — це нормально, налаштування не втрачено.

## Налаштування, до яких не дістатися

Кілька збережених налаштувань бот читає, але **керування ними на панелі немає**: allow/block списки для інвайтів, block-список для зовнішніх посилань, чи збігатися bad-words всередині довших слів, і per-rule ліміти ескалації mute.

Вони тримають те значення, яке мають, і змінити їх звідси не можна.

## Розв'язання проблем

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

  <Accordion title="Правило ввімкнено, але ніколи не спрацьовує">
    Перевірте disabled channels і roles цього правила й пам'ятайте: на повідомлення спрацьовує лише перше правило-збіг.
  </Accordion>

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

  <Accordion title="Alert-и не публікуються для спаму й повторюваного тексту">
    Ці два правила не підтримують alert, попри перемикач.
  </Accordion>

  <Accordion title="Блокується кожне посилання">
    Ваш список дозволених доменів порожній. Додайте домени, які хочете дозволити.
  </Accordion>

  <Accordion title="Зміна зберіглася, але не діє">
    Конфігурація доходить до бота зазвичай за 30 секунд, але може займати до 10 хвилин, якщо сповіщення пропущене. Зачекайте, перш ніж перезберігати.
  </Accordion>
</AccordionGroup>

## Пов'язане

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

  <Card title="Logging" icon="scroll" href="/uk/moderation/logs">
    Фіксуйте дії Auto-Moderation для аналізу.
  </Card>
</CardGroup>