mBans (Эмбанз)

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

Возможности

• Постоянные и временные баны, баны по IP, обычные, IP- и теневые муты, предупреждения и кики.
• История наказаний игрока и действий модераторов, заметки для персонала, отмена наказаний по ID и откат недавних действий модератора.
• Поиск аккаунтов с совпадающим IP, исключения для игрока при IP-бане и уровни иммунитета модераторов.
• Шаблоны причин, ссылки на доказательства и прикрепление последних сообщений чата к бану, муту или предупреждению.
• Теневой мут: сообщения видят только отправитель, консоль и персонал с нужным правом.
• Настраиваемая эскалация предупреждений: после заданного числа предупреждений плагин применяет выбранное наказание.
• Апелляции из игры, очередь их проверки и идентификаторы для апелляций на бан.
• Списки активных банов, мутов и предупреждений, а также графическое меню модерации для игроков, в том числе офлайн.
• Поддержка сообщений на русском языке: в lang/en_US.yml выберите language.default: ru_RU.
• При наличии PlaceholderAPI доступны плейсхолдеры %mbans_banned%, %mbans_muted%, %mbans_warnings%, %mbans_status% и %mbans_version%.

Команды

• Наказания: /ban, /tempban, /unban, /banip, /unbanip, /mute, /tempmute, /unmute, /ipmute, /unipmute, /shadowmute, /tempshadowmute, /unshadowmute, /warn, /unwarn, /kick.
• Просмотр данных: /history, /staffhistory, /check, /banlist, /mutelist, /warns, /punishment, /alts, /dupeip, /muser.
• Управление: /mbans rollback, /mbans revoke, /mbans reason, /mbans allow, /mbans note, /mbans notes, /mbans stats.
• Апелляции: /appeal <appeal-id> <message>, /mbans appeals, /mbans appeal <id> <accept|deny> [note].
• Импорт, экспорт и перезагрузка: /mbans import, /mbans export, /mbans reload.

Длительность указывается, например, как 30m, 2h, 7d или 1mo. Флаг -s делает наказание тихим, --evidence=<url> прикрепляет доказательство, а -last <count> добавляет последние строки чата. Вместо причины можно указать имя шаблона.

Права

Каждой административной команде соответствует право вида mbans.command.<name>, а mbans.admin выдаёт доступ ко всему набору команд.

• mbans.view.ip — просмотр IP-адресов.
• mbans.notify.alts — уведомления об альтах.
• mbans.notify.shadow — просмотр чата игроков с теневым мутом.
• mbans.bypass.ban, mbans.bypass.mute, mbans.bypass.warn, mbans.bypass.kick — защита цели от соответствующего наказания.
• mbans.override и mbans.override.shorten — замена и сокращение действующего бана или мута.
• mbans.silent — использование флага -s.

Настройка

Основной файл — plugins/mBans/config.yml. В разделах storage и network задаются хранилище, подключение к базе, имя сервера и интервал синхронизации. Разделы templates, durations, escalation, immunity, exemptions, chat-evidence, geoip, rest-api и appeals отвечают за причины, сроки, эскалацию, исключения, доказательства из чата, фильтрацию стран, API и апелляции.

Команда /mbans reload перезагружает сообщения и безопасные параметры. Изменения хранилища, сети, REST API и GeoIP требуют перезапуска.

Требования

Плагин работает на Paper, Purpur и Folia. Для одиночного сервера можно использовать H2 или SQLite; для сети серверов нужна общая база MySQL, MariaDB или PostgreSQL. Файл H2 или SQLite нельзя использовать одновременно несколькими процессами.

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