BetterPunish (Беттерпаниш)

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

Возможности

• Постоянные и временные баны, муты, теневые муты, предупреждения и кики с уникальным идентификатором каждой записи.
• Предупреждения для игроков не в сети: они сохраняются и выдаются при следующем входе.
• Несколько ссылок на доказательства для каждого наказания.
• Меню /punishgui и /punishments со списками активных, истёкших, отменённых и недавних наказаний, а также отдельными категориями банов, мутов, предупреждений и теневых мутов.
• Поиск игрока в меню, просмотр его истории, доказательств и подробностей наказания; редактирование записей с отдельным подтверждением отмены активного наказания.
• Система повторных нарушений: /offend назначает следующее настроенное наказание для выбранной категории.
• Фильтр чата, защита от спама и обхода мута через личные сообщения, таблички, книги и переименование предметов в наковальне. Сообщения теневого мута видит только сам отправитель.
• Очистка чата, общий мут и задержка между сообщениями.
• Жалобы на игроков через /report, очередь жалоб в /reports, внутренние заметки, профили модерации и заморозка игрока на время проверки.
• Журналы команд и личных сообщений с поиском и просмотром в реальном времени.
• Локальное хранение данных в YAML: наказаний, жалоб, заметок, записей проверки чата, журналов команд и замеченных IP-адресов.

Команды

Наказания и история:

• /ban <player> <reason>, /tempban <player> <duration> <reason>, /unban <player|id> — бан, временный бан и отмена бана.
• /mute <player> <reason>, /tempmute <player> <duration> <reason>, /unmute <player|id> — мут, временный мут и отмена мута.
• /shadowmute <player> <reason>, /tempshadowmute <player> <duration> <reason> — теневой мут.
• /warn <player> <reason>, /kick <player> <reason>, /offend <player> <reason> — предупреждение, кик и наказание за повторное нарушение.
• /history <player> [page] — история наказаний игрока.
• /checkban <player|id>, /check <player|id>, /pinfo <player|id> — проверка активных наказаний, состояния заморозки, заметок и профиля игрока.
• /punishgui [category] [page], /punishments [category] [page] — меню наказаний.
• /punishedit <id> — открыть редактор записи; reason <reason>, duration <duration> и staff <staff> меняют причину, длительность и указанного модератора.
• /proof <add|remove|list> <id> [url] — управление доказательствами.

Жалобы, чат и проверка:

• /report <player> <reason> и /reports [page] — отправить жалобу и открыть её очередь.
• /chatreview [page] — очередь сообщений, заблокированных фильтром.
• /note <add|list|remove|clear> <player> [text/id] — заметки персонала.
• /freeze <player> [reason], /unfreeze <player> — заморозить или разморозить игрока.
• /clearchat [all] [reason], /mutechat [reason], /slowmode <seconds|off> — очистка чата, общий мут и задержка сообщений.
• /playermsgs <player> [limit], /allmsgs [limit], /livemsgs <player|all|off> — просмотр и отслеживание личных сообщений.
• /playercommands <player> [limit], /livecommands <player|all|off> — просмотр и отслеживание команд.
• /sus или /suspects — меню подозрительных игроков при использовании Vulcan.

Управление данными:

• /punishreload — перезагрузить конфигурацию и данные.
• /punishmigrate, /punishpull — отправить историю наказаний в Supabase или загрузить её обратно.
• /punishcleardb — очистить локальные и настроенные удалённые данные о наказаниях.

Для временных наказаний используются значения вроде 30m, 12h, 7d, 30d или permanent. К поддерживаемым командам наказаний можно добавить -s либо --silent, чтобы не показывать публичное объявление.

Права

/report доступна игрокам по умолчанию, а команды персонала по умолчанию доступны операторам сервера.

• betterpunish.ban, betterpunish.tempban, betterpunish.unban — управление банами.
• betterpunish.mute, betterpunish.tempmute, betterpunish.unmute — управление мутами.
• betterpunish.shadowmute, betterpunish.tempshadowmute, betterpunish.warn, betterpunish.kick, betterpunish.offend — теневые муты, предупреждения, кики и повторные нарушения.
• betterpunish.history, betterpunish.checkban, betterpunish.gui, betterpunish.edit, betterpunish.proof — история, проверка, меню, редактирование и доказательства.
• betterpunish.reports, betterpunish.chatreview, betterpunish.note, betterpunish.freeze — жалобы, проверка чата, заметки и заморозка.
• betterpunish.clearchat, betterpunish.mutechat, betterpunish.slowmode — управление чатом.
• betterpunish.commandlogs, betterpunish.live — журналы и наблюдение в реальном времени.
• betterpunish.sus, betterpunish.reload, betterpunish.migrate, betterpunish.pull, betterpunish.cleardb — меню подозрений, перезагрузка и управление данными.
• betterpunish.staff — оповещения персонала и отдельные обходы ограничений.
• betterpunish.chatfilter.notify, betterpunish.chatfilter.bypass — уведомления фильтра и его обход.
• betterpunish.offend.exempt — защита игрока от /offend.

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

Настройка

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

Система наказаний поддерживает режимы LEGACY, OFFENSE и HYBRID. Данные хранятся в plugins/BetterPunish/data/.

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

Требования

Плагин предназначен для серверов Paper и требует Java 21 или новее. Обязательные плагины не нужны.

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