Модерация

Раздел Модерация объединяет ручные наказания, активные баны, муты, предупреждения участников и статистику по ним.

В панели можно:

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

Выдавать новые наказания через панель нельзя — для этого используются команды Discord.

Важно: предупреждение обычного участника и выговор сотрудника — разные системы. Команда r!warn относится к поведению участников и может привести к автоматическому муту или бану. Выговоры сотрудников учитываются отдельно в staff-системе.

Как открыть и включить

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

Доступ к панели имеют:

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

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

Откройте «Обзор сервера».
Найдите раздел Модули.
Включите модуль Модерация.

Пока этот модуль ни разу не настраивали, он считается включённым.

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

ban;
unban;
mute;
unmute;
warn;
warns;
remwarn;
unwarn;
/kick;
/clear;
/automod status.

Команда /rename относится к ручной модерации, но не зависит от этого переключателя.

Выключение модуля:

не скрывает данные в панели;
не отключает staff-систему;
не останавливает фильтры автомодерации;
не отменяет уже выданные наказания;
не останавливает автоматическое снятие временных наказаний.

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

Параметр	Где настраивается	Значение по умолчанию	Описание
Модуль Модерация	«Обзор сервера» → Модули	Включён	Разрешает использование основных команд ручной модерации.
Префикс текстовых команд	«Сервер»	`r!`	Используется командами `ban`, `unban`, `mute`, `unmute`, `warn`, `warns`, `remwarn` и `unwarn`. На slash-команды не влияет.
Роль для мута	«Сервер»	Не выбрана	Используется для бессрочных мутов и мутов дольше 28 дней. Если роль не выбрана, бот создаёт роль Muted автоматически.
Срок бана	Указывается в команде `ban`	Без срока	Определяет момент автоматического разбана.
Причина бана	Указывается в команде	`Не указана`	Сохраняется в истории, сообщении команды, личном сообщении участнику и журнале аудита Discord.
Автоматические наказания за предупреждения	«Статистика наказаний»	Не настроены	Позволяют автоматически выдавать мут или бан после достижения заданного числа активных предупреждений.

На странице Активные наказания собственных настроек нет. Она предназначена для просмотра записей и снятия активных банов.

Команды и права

Команда	Кто может использовать	Дополнительные условия
`r!ban <пользователь> [срок] [дни очистки] [причина]`	Участник с разрешением Discord Блокировать участников или с правом `staff.ban`	Боту также нужны разрешение Блокировать участников и роль выше роли цели. Количество дней очистки — от 0 до 7.
`r!unban <пользователь>`	Участник с разрешением Блокировать участников	Боту также нужно разрешение Блокировать участников.
`r!mute <пользователь> [срок] [everywhere \| here \| #канал] [причина]`	Участник с разрешением Модерировать участников или Управлять сообщениями, либо с правом `staff.timeout`	Роль цели должна находиться ниже ролей автора команды и бота. Без указания области мут действует на всём сервере.
`r!unmute <пользователь> [everywhere \| here \| #канал]`	Участник с разрешением Модерировать участников или Управлять сообщениями	Без указания области снимаются все активные муты участника.
`r!warn <пользователь> [срок] [причина]`	Участник с разрешением Управлять сообщениями	Создаёт предупреждение и применяет настроенную политику автоматических наказаний.
`r!warns [пользователь]`	Свои предупреждения — любой участник; чужие — участник с Управлять сообщениями	Без цели показывает предупреждения вызвавшего. Пользователя можно указать по ID, даже если он уже покинул сервер.
`r!remwarn <номер случая>`	Участник с разрешением Управлять сообщениями	Номер берётся из команды `r!warns`.
`r!unwarn <пользователь>`	Участник с разрешением Управлять сообщениями	Снимает последнее активное предупреждение участника.
`/kick user:<участник> [reason:<причина>]`	Участник с разрешением Исключать участников или с правом `staff.kick`	Автор команды должен находиться выше цели по ролям, если он не владелец сервера. Боту также нужны право и подходящая позиция роли.
`/clear [user:<участник>] [amount:<число>] [time:<период>]`	Владелец сервера или участник с разрешением Управлять сообщениями	Боту нужно разрешение Управлять сообщениями в текущем канале.
`/rename member:<участник> nick:<имя>`	Участник с разрешением Управлять никнеймами	Боту нужны разрешение Управлять никнеймами и роль выше роли цели. Владельца сервера переименовать нельзя.

Права staff.ban, staff.kick и staff.timeout — это отдельный путь доступа: они заменяют требование к разрешению Discord у автора команды, но не отменяют ни разрешения самого бота, ни иерархию ролей. Командам r!unban, r!unmute и группе предупреждений точечные права такого обхода не дают.

Подробнее о дополнительных правах можно прочитать в разделе «Права для команд».

Выбор пользователя

В текстовых командах пользователя можно указать:

упоминанием;
Discord ID;
ответом на его сообщение.

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

Это поддерживается для:

ban;
unban;
mute;
unmute;
warn.

Бан

Команда r!ban блокирует участника на сервере.

Пример временного бана:

r!ban @User 2d 3 повторный спам

В этом примере:

@User — участник;
2d — срок бана;
3 — удалить сообщения за последние три дня;
повторный спам — причина.

Срок бана

Срок можно записать слитно или словами.

Примеры:

1h30m
2 дня
1д12ч

Если срок не указан, бан будет постоянным.

Удаление сообщений

Отдельное целое число от 0 до 7 определяет, за сколько последних дней удалить сообщения участника.

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

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

Что происходит после команды

После успешной блокировки бот:

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

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

Что получает наказанный

Личное сообщение одинаково для всех наказаний — и выданных модератором, и выданных автомодерацией.

В нём указаны вид наказания, сервер, причина, срок, дата и номер наказания, а также источник («👮 Модератор» или «🤖 Автомодерация»).

Под сообщением две кнопки:

📋 Подробнее — полная карточка наказания;
⚖️ Подать апелляцию — если обжалование включено на сервере.

Кнопка апелляции неактивна, когда обжалование выключено, срок подачи истёк или этот вид наказания обжаловать нельзя. Настраивается на странице «Апелляции».

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

Временный бан

Временный бан снимается автоматически после окончания срока.

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

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

Разбан

Команда:

r!unban <пользователь>

снимает активную блокировку.

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

В панели активный бан можно снять кнопкой Снять.

После подтверждения бот:

пытается разблокировать пользователя;
закрывает запись активного наказания.

Если пользователя уже разблокировали вручную через Discord, панель всё равно закроет наказание в собственной истории.

Мут

Команда:

r!mute @User 30m флуд

выдаёт участнику мут на 30 минут на всём сервере.

Серверный мут

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

Для срока до 28 дней бот использует встроенный тайм-аут Discord.

Для более долгого или бессрочного мута используется отдельная роль.

Роль для мута

Роль можно выбрать на странице «Сервер».

Если она не выбрана, бот создаст роль Muted при первой необходимости.

Чтобы бот мог выдать эту роль:

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

Если выбранную роль удалить из Discord, бот снова создаст роль Muted.

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

Мут в отдельном канале

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

r!mute @User 30m here флуд

или:

r!mute @User 30m #канал флуд

Значение here означает текущий канал.

При таком муте бот сохраняет прежние разрешения участника на:

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

После снятия мута сохранённые значения восстанавливаются.

Снятие мута

Примеры:

r!unmute @User here

Снимает мут в текущем канале.

r!unmute @User everywhere

Снимает серверный мут.

r!unmute @User

Снимает все активные муты участника.

Предупреждение участника

Команда:

r!warn @User 7d оскорбления

выдаёт предупреждение сроком на семь дней.

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

После выдачи бот:

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

Автоматические действия настраиваются на странице «Статистика наказаний».

Команда r!warn не создаёт выговор сотруднику и не влияет на KPI staff-системы.

Просмотр предупреждений

Команда:

r!warns

показывает собственные активные предупреждения.

Чтобы посмотреть чужие предупреждения:

r!warns @User

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

Пользователя можно указать по ID, даже если он уже покинул сервер.

В списке отображаются:

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

Предупреждения показываются по одному на страницу.

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

стрелки переключают страницы;
кнопка ✕ закрывает список.

Кнопками может пользоваться только тот, кто вызвал команду.

Снятие предупреждений

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

Первое предупреждение на сервере получает номер 1, следующее — 2 и так далее.

Снять конкретное предупреждение можно командой:

r!remwarn 1

Снять последнее активное предупреждение участника можно командой:

r!unwarn @User

Исключение участника

Команда /kick исключает участника без блокировки.

Исключённый пользователь сможет вернуться по новому приглашению.

Команда:

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

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

Очистка сообщений

Команда /clear удаляет сообщения только в том канале, где была вызвана.

Доступны три необязательных параметра:

Параметр	Что делает
`user`	Удаляет сообщения только выбранного пользователя.
`amount`	Удаляет указанное количество сообщений. Допустимо до 150.
`time`	Удаляет сообщения за выбранный период, например `30m`, `2h` или `1d`.

Приоритет параметров

Если указан amount, параметр time не применяется.

При использовании amount бот просматривает не больше 150 последних сообщений.

Если amount не указан, бот просматривает последние 100 сообщений.

Если time также не указан, используется период семь дней.

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

Переименование участника

Команда:

/rename member:<участник> nick:<имя>

изменяет никнейм участника на сервере.

Для работы команды:

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

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

Команда /rename работает независимо от состояния модуля Модерация.

Что показывает панель

Активные баны

Таблица отсортирована от новых записей к старым.

Для каждого бана отображаются:

участник;
модератор;
дата;
срок;
причина;
кнопка снятия.

В таблицу могут попадать баны:

выданные вручную;
созданные автомодерацией;
созданные антирейдом.

Для автоматических наказаний в поле модератора отображается Система.

Кик не создаёт запись активного бана.

Муты

Таблица мутов показывает:

участника;
модератора;
дату;
срок;
причину;
текущее состояние.

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

Таблица предупреждений показывает обычные предупреждения участников.

Выговоры сотрудников здесь не отображаются. Их история находится в staff-системе.

Статистика наказаний

Страница «Статистика наказаний» показывает:

данные за сегодня;
число активных наказаний;
график за 7, 30 или 90 дней;
самых активных модераторов;
частые причины наказаний.

На этой же странице настраиваются автоматические действия по числу активных предупреждений.

Реакции на текстовые команды

После выполнения текстовой команды бот добавляет реакцию к сообщению:

✅ — команда выполнена;
❌ — команда отклонена.

Отказ может произойти, если:

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

Slash-команды не используют реакции. Их результат отображается непосредственно в ответе Discord.

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

В зависимости от команды боту могут потребоваться разрешения:

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

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

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

Для мута в отдельном канале соответствующие права должны быть доступны боту именно в этом канале.

Ограничения

Ограничение таблиц

Каждая таблица в панели показывает только первые 50 записей.

Постраничной навигации пока нет.

Поэтому число рядом с заголовком может быть больше количества видимых строк.

Задержка снятия наказаний

Временные наказания могут сниматься с задержкой примерно до одной минуты.

История разбанов

При ручном разбане наказание отмечается как снято.

При автоматическом окончании срока — как истекло.

Записи при этом не удаляются из истории.

Выключение модуля

Выключение модуля Модерация:

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

Долгий мут

Для мута дольше 28 дней или бессрочного мута:

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

Для мута только в одном канале это право требуется в выбранном канале.