LiteBans: баны, муты и варны на сервере и в сети

Установка и база данных

На одном сервере LiteBans работает сразу: по умолчанию используется H2, база хранится файлами в папке плагина. Для сети серверов нужна общая MySQL или MariaDB: все экземпляры, подключённые к одной базе, применяют наказания везде. Поддерживается и PostgreSQL.

1. Положите jar в plugins (на Fabric в mods).
2. Запустите сервер, конфиги появятся в plugins/LiteBans/ (Fabric: config/litebans/, Velocity: plugins/litebans/).
3. Для сети впишите базу в config.yml на каждом сервере.
4. Выполните /litebans reload или перезапустите сервер.
5. Проверьте подключение: /litebans info и /litebans servers.

sql:
  driver: mysql
  address: localhost:3306
  database: 'litebans'
  username: 'user'
  password: 'pass'
  table_prefix: 'litebans_'

server_name задаёт имя экземпляра для синхронизации и области наказаний, лучше строчными буквами. Ставить плагин на прокси вместо каждого сервера документация советует только в больших сетях от 30 серверов или при отсутствии MySQL.

Команды ban, tempban, mute, warn и флаги

Общий синтаксис: /ban <user> [flags] [duration] [server:*] [template] [reason]. Всё в квадратных скобках необязательно. Вместо ника можно указать UUID, IP или маску IP.

/ban Steve -s 10d server:survival Читы
/tempban Steve 7d Гриферство
/mute Steve 30m Флуд
/tempmute Steve 1h Капс
/warn Steve Оскорбления
/ban Steve duration:permanent Читы

Длительность: s, m, h, d, w, mo, y. Можно дробно (1.5h) и с пробелом (5 days). Бессрочно: duration:permanent.

• -s: тихое наказание, без объявления в чат. Его видят только игроки с litebans.notify.silent.
• -S: совсем тихо, объявление видит только консоль.
• -p: публичное наказание, если в конфиге включено silent: true.
• -I: наказание по аккаунту и IP.
• -g: на всю сеть, то же что server:global.
• -m: изменить действующее наказание (новые срок и причина) без создания нового.
• -d: удалить запись по ID или нику.
• -N: не перезаписывать уже действующее наказание более коротким.

Права модераторов

• litebans.ban и litebans.mute разрешают и вечные, и временные наказания. litebans.tempban и litebans.tempmute только временные: удобно для младших модераторов.
• litebans.warn, litebans.kick, litebans.ipban.
• Снятие: litebans.unban.own снимает только свои баны. Чтобы снимать чужие, нужны оба права, litebans.unban и litebans.unban.own. Так же устроены unmute и unwarn.
• litebans.exempt защищает от наказаний, litebans.exempt.bypass позволяет наказывать защищённых. Документация советует включить use_group_weights, чтобы младшие группы не могли наказывать старших. На Spigot для проверки прав офлайн-игроков нужен Vault.
• litebans.admin открывает /litebans reload и другие служебные команды, но не выдаёт остальные права. Для всего сразу есть litebans.*.
• Если плагин стоит на прокси, выдайте группе default litebans.notify.broadcast, иначе игроки не увидят объявления о банах.

Предупреждения и автоматические наказания

Варны по умолчанию истекают через 7 дней (warnings.expire_after, значение permanent делает их вечными). В warnings.actions задаётся, что происходит после N активных предупреждений. Пример из конфига:

warnings:
  expire_after: 7 days
  actions:
  - '3:/kick -s:$silent $player Final warning: $reason'
  - '4:/tempban -s:$silent $player 1 day Reached 4 warnings: $list'

Число перед двоеточием это порог, + после него срабатывает на этом числе варнов и выше. -s:$silent переносит тихий режим с предупреждения на наказание. Посмотреть свои варны игрок может командой /warnings.

Веб-интерфейс: litebans-php и LitebansU

Веб-страница со списком банов читает ту же базу, что и плагин, поэтому нужна MySQL или MariaDB. С H2 веб-интерфейс не подключить.

Официальный litebans-php. Нужны PHP 5.3+ с модулями intl и pdo_mysql, рекомендуется PHP 8.1+ и MariaDB. Распакуйте архив в корень сайта, переименуйте папку в bans, откройте example.com/bans/index.php и следуйте подсказкам. Есть русский перевод от сообщества. Инструкция: gitlab.com/ruany/litebans-php.

LitebansU это сторонний проект под лицензией MIT, не от автора LiteBans: публичные списки с поиском и статистикой, тёмная тема, админ-панель. Требования: PHP 8.0+, MySQL 5.7+ или MariaDB 10.3+, LiteBans 2.8.0+.

1. Распакуйте релиз в папку сайта и дайте веб-серверу запись в data/, demos/data/ и logs/.
2. Откройте install.php либо скопируйте .env_example_clean в .env и заполните DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASS, TABLE_PREFIX=litebans_.
3. После запуска удалите install.php и hash.php.

Репозиторий: github.com/Yamiru/LitebansU.

Перевод на русский

Сообщения плагина лежат в messages.yml. В репозитории LiteBans на GitLab есть messages_ru.yml, но он сгенерирован версией 2.11.3 и может отставать от текущей. Надёжнее переводить свой messages.yml, сверяясь с этим файлом, и применить /litebans reload. Файлы переводов: gitlab.com/ruany/LiteBans.