EmpireBan (Эмпайрбан)

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

Возможности

• Баны, муты, кики и предупреждения с историей наказаний игрока.
• Система причин-наказаний из ids.yml: для каждой причины задаются уровни эскалации, например предупреждение, затем мут и бан. После последнего уровня применяется самое строгое настроенное наказание.
• Проверка IP входящего игрока на совпадение с IP забаненных игроков: администраторам приходит уведомление или твинк блокируется автоматически.
• Дополнительная проверка VPN, прокси и Tor через vpnapi.io.
• Фильтр запрещённых слов и ссылок, а также задержка между сообщениями в чате.
• Мут блокирует команды действий и личных сообщений из списка mute-command-blacklist.list.
• Журнал выдачи и снятия наказаний.
• Работа с SQLite или MySQL.

Команды

• /bansystem или /bansys — основная команда; /bansystem reload — перезагрузка настроек.
• /ban <player> <id|duration> [reason], /unban <player> [reason] — бан и разбан.
• /mute <player> <id|duration> [reason], /unmute <player> [reason] — мут и снятие мута.
• /kick <player> [reason] — кик игрока.
• /check <player> и /history <player> — проверка и история наказаний.
• /deletehistory <player> — удаление истории.
• /bansystem ids create <id> <type> <onlyAdmins> <duration> <reason> — создание причины-наказания.
• /bansystem ids delete <id> — удаление причины.
• /bansystem ids edit <id> add lvl <lvl> <duration> <type> — добавление уровня эскалации.
• /bansystem ids edit <id> remove lvl <lvl> — удаление уровня.
• /bansystem ids edit <id> set lvlduration <lvl> <duration> и /bansystem ids edit <id> set lvltype <lvl> <type> — изменение длительности и типа уровня.
• /bansystem ids edit <id> set onlyadmins <true/false> и /bansystem ids edit <id> set reason <reason> — изменение доступа и текста причины.
• /bansystem ids show [id] — просмотр причин; /bansys logs show [page] и /bansys logs clear — просмотр и очистка журнала.

Длительность можно указать в секундах, например 86400, либо сокращённо: 1d12h, 30m или perm.

Права

• bansys.bansys, bansys.reload — доступ к основной команде и перезагрузке.
• bansys.ban.<id>, bansys.ban.all, bansys.ban.admin — выдача наказаний по причинам.
• bansys.unban, bansys.unmute, bansys.kick — снятие бана, снятие мута и кик.
• bansys.check, bansys.history.show, bansys.history.delete — проверка и управление историей.
• bansys.ids.create, bansys.ids.delete, bansys.ids.addlvl, bansys.ids.removelvl, bansys.ids.setduration, bansys.ids.settype, bansys.ids.setonlyadmins, bansys.ids.setreason, bansys.ids.show — управление причинами и уровнями наказаний.
• bansys.logs.show, bansys.logs.clear — доступ к журналу.
• bansys.notify — уведомления о твинках и VPN.
• bansys.bypasschatfilter, bansys.bypasschatdelay — обход фильтра и задержки чата.
• bansys.kick.bypass — защита от кика; bansys.ban.bypass — отмена кика при бане.

Настройка

В config.yml выбирается база данных через database.type: sqlite или mysql; параметры MySQL находятся в database.mysql.

• ip-handling.autoban включает автоматический бан твинков по IP, а ip-handling.notify-staff — уведомления персоналу.
• vpn-check.enabled, vpn-check.api-key и vpn-check.autoban управляют проверкой VPN.
• В chat-filter.blacklist задаются запрещённые фразы и ссылки, а chat-delay.seconds определяет задержку сообщений.
• punishments.require-id разрешает выдавать бан и мут только по причинам из ids.yml; punishments.admin-bypass оставляет администраторам возможность указывать длительность напрямую.
• Файл messages_english.yml содержит сообщения плагина. Можно добавить файл вида messages_<language>.yml для своего перевода.

Требования

Плагин работает на Spigot, Paper, Purpur, Bukkit, BungeeCord и Velocity. Для проверки VPN нужен сервис vpnapi.io.

На сервере с прокси JAR-файл ставится только на Velocity или BungeeCord, а не одновременно на серверы Spigot за прокси. На одиночном сервере он устанавливается на Spigot.