Банворды

Банворды — это список запрещённых слов и фраз, по которому NightSentinel проверяет сообщения в Twitch-чате.

Как работает фильтр

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

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

Глобальные и канальные списки

Глобальные банворды — слова и фразы, которые проверяются во всех каналах, где работает соответствующая конфигурация бота.
Банворды канала — дополнительные слова и фразы для конкретного Twitch-канала.

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

Как настроить банворды

Открой панель управления NightSentinel и найди раздел «Настройки банвордов».
В поле «Список» выбери «Глобальные банворды» или «Банворды канала».
Если выбран список канала, выбери нужный канал в поле «Канал».
Введи каждое запрещённое слово или фразу с новой строки.
Нажми «Сохранить банворды» и дождись сообщения об успешном сохранении.

Важно перед сохранением

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

Допускается до 200 записей в одном списке.
Пустые строки пропускаются.
Повторяющиеся записи удаляются при сохранении без учёта регистра.
Слово или фраза не должны превышать 100 символов.

Что делают алиасы банвордов

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

Сначала добавь основное слово в глобальный список или список канала и сохрани список.
В карточке «Алиасы банвордов» выбери основное слово.
В поле «Альтернативные варианты» введи каждый дополнительный вариант с новой строки.
Нажми «Сохранить алиасы».

Для одного основного слова можно указать до 100 вариантов. Каждый вариант должен занимать одну строку.

Алиасы банвордов хранятся в общей конфигурации бота, а не в отдельных настройках каждого канала. Они не заменяют основной банворд.

Как удалить алиасы

Выбери нужный основной банворд и нажми «Удалить алиасы». Будут удалены только дополнительные варианты написания. Основное слово останется в списке банвордов и продолжит проверяться.

Кнопки раздела

Загрузить список заново — загружает сохранённый список вместо текущего содержимого поля.
Сохранить банворды — сохраняет содержимое поля как новый выбранный список.
Загрузить алиасы — загружает сохранённые алиасы банвордов.
Сохранить алиасы — сохраняет альтернативные варианты выбранного слова.
Удалить алиасы — удаляет варианты выбранного слова, не удаляя его самого.

Если возникла ошибка

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