Автомодерация

Автомодерация автоматически проверяет новые сообщения и реагирует на нарушения заданных правил.

Она может обнаруживать:

приглашения на Discord-серверы;
нежелательные ссылки;
запрещённые слова и фразы;
слишком большое количество упоминаний;
сообщения с большим количеством заглавных букв;
слишком частую отправку сообщений;
запрещённые изображения во вложениях — по загруженным образцам.

Для каждого правила отдельно настраиваются:

действие при нарушении;
исключённые роли и каналы;
порог срабатывания;
длительность тайм-аута, если выбрано действие Мут.

Как включить автомодерацию

Откройте страницу «Автомодерация».

Изменять настройки могут:

владелец сервера;
участники с разрешением Discord Администратор;
участники с разрешением Управлять сервером.

Чтобы автомодерация начала работать:

Включите общий переключатель Включить автомодерацию.
Включите нужные правила.
Выберите действие для каждого правила.
При необходимости настройте пороги, исключения и канал уведомлений.
Нажмите Сохранить.

Недостаточно включить только отдельное правило. Общий переключатель автомодерации также должен быть включён.

По умолчанию автомодерация выключена.

Важно: собственный переключатель автомодерации не связан с общим модулем Модерация на странице обзора сервера. Если выключить общий модуль, проверка сообщений продолжит работать, но команда /automod status станет недоступна.

Основные настройки

Параметр	Где настраивается	Значение по умолчанию	Описание
Автомодерация	Верхняя карточка страницы	Выключена	Включает проверку новых сообщений по активным правилам.
Действие	В карточке каждого правила	Зависит от правила	Определяет, что бот сделает после нарушения. При любом выбранном действии бот также пытается удалить сообщение.
Исключённые роли	В карточке каждого правила	Не выбраны	Участники хотя бы с одной выбранной ролью не проверяются этим правилом.
Исключённые каналы	В карточке каждого правила	Не выбраны	Правило не применяется в выбранных каналах.
Длительность мута	Появляется при выборе действия Мут	300 секунд	Определяет длительность тайм-аута Discord. Допустимое значение — от 10 секунд до 2 419 200 секунд.
Канал уведомлений	Раздел Дополнительные уведомления	Не выбран	Получает отдельное текстовое сообщение при каждом срабатывании. Работает независимо от основного журнала автомодерации.
Шаблон уведомления	Там же, после выбора канала	Стандартный шаблон	Позволяет изменить текст уведомления. Максимальная длина до подстановки значений — 500 символов.

Правила и значения по умолчанию

Правило	Состояние и действие по умолчанию	Начальные настройки	Допустимые значения
Приглашения Discord	Выключено, Удалить	Обнаруживается любая поддерживаемая ссылка-приглашение	—
Ссылки	Выключено, Удалить	Белый список доменов пуст	—
Чёрный список слов	Выключено, Удалить	Список запрещённых выражений пуст	—
Упоминания	Выключено, Удалить	Не больше 5 упоминаний пользователей и ролей суммарно	От 1 до 50
Антикапс	Выключено, Удалить	Не менее 10 букв и 70% заглавных	От 10% до 100%; от 1 до 2000 букв
Антиспам	Выключено, Мут	5 сообщений за 5 секунд	От 2 до 50 сообщений; от 1 до 60 секунд
Запрещённые изображения	Выключено, Удалить	Режим «Наблюдение», консервативная чувствительность, список образцов пуст	До 300 образцов на сервер

Как проверяются сообщения

Бот не проверяет:

личные сообщения;
сообщения других ботов;
сообщения участников, исключённых настройками правила.

Участник полностью обходит все правила автомодерации, если у него есть хотя бы одно из разрешений Discord:

Администратор;
Управлять сообщениями;
Управлять сервером.

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

Порядок проверки правил

Одно сообщение может подходить сразу под несколько правил, но бот применяет только первое найденное нарушение.

Правила проверяются в следующем порядке:

антиспам;
приглашения Discord;
ссылки;
чёрный список слов;
антикапс;
упоминания;
запрещённые изображения;
AI-модерация, если она включена.

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

Правило изображений проверяется после текстовых: если текст сообщения уже нарушил другое правило, вложения не скачиваются. Вложения не скачиваются и тогда, когда список образцов пуст.

Что считается нарушением

Приглашения Discord

Правило срабатывает, если в сообщении найдена ссылка одного из следующих видов:

discord.gg/...;
discord.com/invite/...;
discord.me/...;
dsc.gg/....

Бот не отличает приглашение на ваш сервер от приглашения на другой сервер. Любая подходящая ссылка считается нарушением.

Белый список правила Ссылки не влияет на фильтр приглашений Discord.

Ссылки

Правило срабатывает, если сообщение содержит адрес с:

http://;
https://;
www..

Ссылка разрешается только в том случае, если её домен добавлен в белый список.

Разрешённый домен также разрешает его поддомены. Например, добавление youtube.com разрешит как youtube.com, так и www.youtube.com.

В белый список нужно вводить только домен:

youtube.com

Не нужно указывать протокол, страницу или путь:

https://youtube.com/video

Чёрный список слов

Правило срабатывает, если любой элемент чёрного списка встречается в сообщении.

Проверка:

не учитывает регистр;
ищет совпадение как часть строки;
не проверяет границы слова.

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

Перед включением строгого наказания рекомендуется проверить список в отдельном тестовом канале.

Упоминания

Бот суммирует упоминания пользователей и ролей.

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

Например, при лимите 5:

5 упоминаний разрешены;
правило сработает начиная с 6 упоминаний.

Антикапс

Правило срабатывает, если одновременно выполняются два условия:

в сообщении есть не меньше указанного минимального количества букв;
доля заглавных букв не ниже установленного процента.

В расчёте процента учитываются только буквы.

Не учитываются:

цифры;
пробелы;
эмодзи;
знаки препинания;
другие небуквенные символы.

Антиспам

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

Счётчик:

общий для всех каналов одного сервера;
не сбрасывается при переходе в другой канал;
очищается после срабатывания правила.

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

Запрещённые изображения

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

Оно предназначено для повторяющегося визуального спама: рекламы казино, скриншотов с промокодами, картинок-«приглашений».

Что поддерживается

Форматы: JPEG, PNG и статический WebP.
Не поддерживаются: GIF, анимированный WebP и APNG — анимация не сравнивается и в список образцов не принимается.
Размер: вложения больше 8 МиБ не проверяются (значение настраивается при развёртывании бота). Такие пропуски записываются в журнал событий, чтобы их было видно.

Что распознаётся

Сравнение устойчиво к обычной пересылке картинки:

повторная отправка того же файла;
изменение размера — и с сохранением пропорций, и без него (размер вбит руками, взят пресет вида 800×600);
пережатие JPEG и смена формата (PNG → JPEG);
удаление или изменение метаданных;
поворот, записанный в EXIF (фото с телефона);
прозрачность (сводится на белый фон).

Не распознаются:

сильная обрезка;
добавление широких полей или рамки;
значительное изменение самой картинки;
другая картинка на ту же тему.

Фильтр не даёт стопроцентного распознавания и не заменяет модератора.

Режимы

Режим	Что делает
Наблюдение	Только фиксирует совпадения в журнале. Наказание не применяется и сообщение не удаляется. Выбранное действие показывается как «Будущее действие».
Применение	Удаляет сообщение и выполняет выбранное действие.

Начинайте с наблюдения: так видно частоту совпадений и их точность до того, как правило начнёт наказывать.

Чувствительность

Значение	Когда использовать
Консервативная	По умолчанию. Меньше ложных совпадений. Единственная доступная в режиме применения.
Сбалансированная	Находит больше похожих вариантов. Доступна только в режиме наблюдения — она не откалибрована на реальном трафике.

Образцы

Образцы загружаются на той же странице, в блоке Образцы запрещённых изображений.

до 300 образцов на сервер;
каждому образцу можно дать название — оно видно только модераторам, в журнале срабатываний и в карточке апелляции;
название можно изменить позже, не загружая файл заново;
повторная загрузка того же файла не создаёт вторую запись: панель сообщит, что такой образец уже есть;
удаление образца означает, что бот перестанет распознавать изображения по нему.

Файл уходит на сервер без изменений: именно поэтому повторная отправка того же файла определяется как точное совпадение.

Что видит модератор

В журнале автомодерации у каждого совпадения показываются номер образца и его название, тип совпадения («Точное» или «Похожее»), расстояния pHash и dHash с порогом, канал и режим.

Эти данные предназначены только модераторам. Участнику в личных сообщениях приходит одна человекочитаемая причина — «совпадение с запрещённым изображением», без номеров образцов и хешей.

Исключения

У правила есть собственные исключённые роли и каналы, как у остальных правил.

Обжалование наказаний

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

Настройки находятся на странице «Апелляции»:

какие виды наказаний можно обжаловать;
обжалуются ли наказания автомодерации (по умолчанию — да);
срок подачи от момента выдачи наказания;
канал, в который приходят карточки апелляций;
можно ли подать апелляцию повторно после решения.

Апелляции разбираются и в Discord, и в панели: решение принимается один раз, кто бы ни нажал кнопку первым.

Решение из панели бот доводит до Discord сам — обновляет карточку в канале, снимает наказание, если апелляция одобрена со снятием, и пишет участнику. Это занимает до полуминуты.

Действия при нарушении

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

Для этого ему необходимо разрешение Управлять сообщениями в исходном канале.

Действие	Что делает бот	Необходимые разрешения
Удалить	Удаляет сообщение без дополнительного наказания.	Управлять сообщениями
Предупредить	Удаляет сообщение и выдаёт участнику предупреждение через общую систему наказаний: оно получает номер случая, попадает в историю и приходит участнику в личные сообщения.	Управлять сообщениями
Мут	Удаляет сообщение и выдаёт участнику тайм-аут Discord на указанное время.	Управлять сообщениями, Модерировать участников и подходящая позиция роли
Кик	Удаляет сообщение и исключает участника с сервера.	Управлять сообщениями, Исключать участников и подходящая позиция роли
Бан	Удаляет сообщение и блокирует участника на сервере. Предыдущие сообщения участника при этом не удаляются.	Управлять сообщениями, Блокировать участников и подходящая позиция роли

Предупреждение

Действие Предупредить создаёт полноценное предупреждение участника — то же, что выдаёт команда r!warn.

Оно:

получает номер случая и попадает в историю (r!warns и раздел «Активные наказания» в панели);
учитывается автоматическими наказаниями по числу предупреждений;
приходит участнику в личные сообщения — одним сообщением с кнопками «Подробнее» и, если обжалование включено, «Подать апелляцию».

Отдельного сообщения в канал автомодерация больше не отправляет: за уведомление участника отвечает система наказаний, и оно одно.

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

Наказания от автомодерации в панели

Все наказания автомодерации — предупреждения, муты, кики и блокировки — попадают в общую историю наказаний вместе с источником («🤖 Автомодерация») и сработавшим правилом. Их видно в разделе Активные наказания, и их можно снять оттуда же или кнопкой в журнале модерации.

Мут, кик и бан

Для применения наказания роль бота должна находиться выше самой высокой роли нарушителя.

Если у бота недостаточно разрешений или его роль расположена ниже роли участника:

сообщение может не удалиться;
наказание может не примениться;
событие всё равно будет записано в настроенные журналы с информацией об ошибке Discord.

Блокировки, созданные автомодерацией, попадают в таблицу Активные баны веб-панели наравне с ручными: у них указан источник и сработавшее правило.

Исключения

Исключения настраиваются отдельно для каждого правила.

Например, если канал добавлен в исключения антиспама, правило ссылок всё равно продолжит работать в этом канале, пока канал не будет отдельно добавлен и в его исключения.

Исключённые роли

Если участник имеет хотя бы одну роль из списка исключений, выбранное правило к нему не применяется.

Исключённые каналы

Выбранное правило не применяется в указанных каналах.

Исключения одного правила не распространяются на остальные правила.

Журналы и уведомления

При каждом срабатывании бот пытается отправить встроенное сообщение Discord в журнал:

Automod → Срабатывания автомодерации

Этот журнал настраивается отдельно в системе логирования.

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

Основной журнал и дополнительный канал уведомлений работают независимо друг от друга.

Шаблон уведомления

В шаблоне можно использовать следующие переменные:

Переменная	Что будет подставлено
`{user}`	Упоминание нарушителя без фактического уведомления пользователя
`{username}`	Отображаемое имя нарушителя
`{user_id}`	Discord ID нарушителя
`{rule}`	Название сработавшего правила
`{reason}`	Причина срабатывания, например процент заглавных букв
`{action}`	Выбранное действие
`{channel}`	Канал, в котором было отправлено сообщение

Стандартный шаблон:

🤖 {user} нарушил правило «{rule}» в {channel}: {reason} → {action}

Если оставить поле шаблона пустым, бот использует этот текст автоматически.

После подстановки значений сообщение обрезается до ограничения Discord в 2000 символов.

Упоминания пользователей и ролей в уведомлении не создают фактический пинг.

Команда `/automod status`

Автомодерация имеет одну команду для просмотра состояния:

Команда	Описание
`/automod status`	Показывает, включена ли автомодерация, какие правила активны, какие действия выбраны и какие основные пороги установлены.

Ответ виден только пользователю, вызвавшему команду.

Команда не позволяет изменять настройки и не показывает:

чёрный список слов;
белый список доменов;
исключённые роли;
исключённые каналы;
канал уведомлений;
текст шаблона уведомления.

Права на использование команды

Команду /automod status могут использовать:

владелец сервера;
участник с разрешением Discord Администратор;
участник с дополнительным правом automod.config;
участник, получивший это право через slash-пресет admin.

Разрешение Discord Управлять сервером открывает доступ к веб-панели, но само по себе не даёт доступ к команде /automod status.

Для работы команды также должен быть включён общий модуль Модерация.

Дополнительные права настраиваются в разделе «Права для команд».

Требования к правам бота

Для корректной работы всех функций боту могут потребоваться следующие разрешения:

Просматривать каналы;
Читать историю сообщений;
Управлять сообщениями;
Отправлять сообщения;
Модерировать участников;
Исключать участников;
Блокировать участников.

Конкретный набор зависит от выбранных действий.

Также роль бота должна находиться выше ролей участников, к которым применяются мут, кик или бан.

Ограничения

Задержка применения настроек

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

Общий модуль «Модерация»

Выключение общего модуля Модерация не останавливает проверку сообщений.

Чтобы полностью отключить фильтры:

откройте страницу Автомодерация;
выключите её собственный переключатель;
нажмите Сохранить.

Только одно действие на сообщение

Если одно сообщение нарушает несколько правил, применяется только первое правило в установленном порядке.

Из-за этого более раннее правило может перехватить сообщение до проверки более позднего.

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