Pterohost docs

LiteBans: баны, муты и варны с общей базой MySQL

Установка LiteBans, подключение MySQL, синхронизация банов между серверами сети, команды ban/mute/warn, веб-интерфейс и импорт данных.

Кратко: LiteBans - один из лучших платных плагинов для управления банами, мутами и варнами на серверах Minecraft. Поддерживает MySQL для синхронизации наказаний в сети из нескольких серверов, гибкие причины-шаблоны и удобный веб-интерфейс со списком банов.

LiteBans: баны, муты и варны с общей базой MySQL

LiteBans - это платный плагин для Paper/Spigot/BungeeCord/Velocity, который заменяет стандартную систему банов Minecraft полноценным модулем наказаний. Плагин хранит все данные в базе данных (H2 или MySQL/MariaDB), поддерживает временные баны, муты, варны и кики, а через общую MySQL-базу синхронизирует наказания между всеми серверами сети в реальном времени. В 2026 году LiteBans остаётся стандартом для серьёзных Minecraft-серверов с развитой системой модерации, потому что сочетает простоту настройки с гибкостью и надёжностью хранения данных. Плагин приобретается на Spigot (BuiltByBit) или у официального разработчика - распространяется как jar-файл после покупки.

Pterohost - Minecraft-хостинг с NVMe-дисками, DDoS-защитой и поддержкой 24/7: идеальная база для сервера с LiteBans и общей MySQL-сетью. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг

Что умеет LiteBans

LiteBans обеспечивает четыре типа наказаний: бан (полная блокировка входа), мут (запрет чата), варн (предупреждение) и кик (принудительное отключение). Каждое наказание может быть временным или постоянным, содержать произвольную причину и IP-адрес.

Ключевые возможности плагина:

  • Хранение данных в H2 (встроенная, без настройки) или MySQL/MariaDB/PostgreSQL
  • Синхронизация банов в реальном времени через общую БД между серверами BungeeCord/Velocity
  • Шаблоны причин (reason templates) - заранее настроенные тексты для частых нарушений
  • Поддержка UUID и IP-банов одновременно
  • Импорт данных из других плагинов: AdvancedBan, BanManager, BungeeAdminTools и др.
  • Веб-интерфейс для публичного отображения списка банов
  • Полная интеграция с LuckPerms через права доступа
  • Поддержка PlaceholderAPI для вывода статистики банов в других плагинах
  • Уведомления для персонала о новых наказаниях в реальном времени

Установка LiteBans

Требования

  • Java 11+ (рекомендуется Java 17 или 21)
  • Paper/Spigot 1.8+ или BungeeCord/Velocity
  • MySQL 5.7+ / MariaDB 10.3+ (опционально, но нужен для сетей)

Одиночный сервер (H2)

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

  1. Скачай litebans.jar после покупки
  2. Положи jar в папку plugins/
  3. Запусти сервер
  4. LiteBans автоматически создаст plugins/LiteBans/ с конфигами и базу H2 локально

После первого запуска проверь что плагин загрузился:

/litebans version

Вывод покажет версию плагина и текущий тип БД.

Сеть серверов (MySQL)

Для синхронизации наказаний между серверами нужна общая MySQL/MariaDB база. Сначала создай базу данных:

CREATE DATABASE litebans CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'litebans'@'%' IDENTIFIED BY 'ваш_пароль';
GRANT ALL PRIVILEGES ON litebans.* TO 'litebans'@'%';
FLUSH PRIVILEGES;

Затем на каждом сервере сети (включая прокси BungeeCord/Velocity) отредактируй plugins/LiteBans/config.yml:

sql:
  # Тип БД: h2, mysql, mariadb, postgresql
  driver: mariadb

  # Настройки подключения
  host: "127.0.0.1"        # IP или хост MySQL-сервера
  port: 3306
  database: "litebans"
  username: "litebans"
  password: "ваш_пароль"

  # Пул соединений
  pool:
    maximum-pool-size: 10
    minimum-idle: 5
    connection-timeout: 30000
    idle-timeout: 600000
    max-lifetime: 1800000

После сохранения перезагрузи каждый сервер командой /litebans reload или полным рестартом. LiteBans автоматически создаст нужные таблицы в базе данных при первом подключении.

Основные команды

Баны

КомандаОписание
/ban <ник> [причина]Постоянный бан игрока
/tempban <ник> <время> [причина]Временный бан (1d, 12h, 30m)
/unban <ник>Снять бан с игрока
/banip <ник/IP> [причина]Бан по IP-адресу
/unbanip <IP>Снять IP-бан
/banlist [страница]Список активных банов

Формат времени: 1d - 1 день, 12h - 12 часов, 30m - 30 минут, 1d12h - 1 день 12 часов, perm - постоянно.

Примеры:

/ban Notch Использование читов
/tempban Steve 3d Спам в чате
/tempban Alex 1d12h Флуд - последнее предупреждение

Муты

КомандаОписание
/mute <ник> [причина]Постоянный мут
/tempmute <ник> <время> [причина]Временный мут
/unmute <ник>Снять мут
/mutelist [страница]Список активных мутов

Варны

КомандаОписание
/warn <ник> [причина]Выдать предупреждение
/unwarn <ID>Удалить варн по ID
/warnings <ник>Список предупреждений игрока

Кики и история

КомандаОписание
/kick <ник> [причина]Кикнуть игрока
/history <ник>Полная история наказаний игрока
/litebans reloadПерезагрузить конфиг без рестарта
/litebans versionВерсия и информация о БД

Права доступа (permissions)

LiteBans использует детализированные права, которые легко интегрируются с LuckPerms. Основные:

# Стандартные права модератора
litebans.kick             # Кикать игроков
litebans.ban              # Постоянный бан
litebans.tempban          # Временный бан
litebans.mute             # Постоянный мут
litebans.tempmute         # Временный мут
litebans.warn             # Выдавать варны
litebans.unban            # Снимать баны
litebans.unmute           # Снимать муты
litebans.history          # Просматривать историю
litebans.banlist          # Видеть список банов

# Права администратора
litebans.ipban            # IP-бан
litebans.import           # Импорт данных
litebans.exemptoverride   # Банить exempt-игроков

# Защита от бана (игрока нельзя забанить)
litebans.exempt.ban
litebans.exempt.mute
litebans.exempt.kick
litebans.exempt.warn

Пример выдачи прав модератору через LuckPerms:

/lp group moderator permission set litebans.ban true
/lp group moderator permission set litebans.tempban true
/lp group moderator permission set litebans.mute true
/lp group moderator permission set litebans.tempmute true
/lp group moderator permission set litebans.kick true
/lp group moderator permission set litebans.warn true
/lp group moderator permission set litebans.history true
/lp group moderator permission set litebans.banlist true
/lp group moderator permission set litebans.unban true
/lp group moderator permission set litebans.unmute true

Администраторам выдай дополнительно litebans.exempt.ban и litebans.exemptoverride чтобы защитить их от бана и дать возможность банить других администраторов.

Шаблоны причин

Шаблоны (reason templates) позволяют модераторам быстро применять стандартные причины без ввода текста вручную. Настраиваются в plugins/LiteBans/config.yml:

# Шаблоны причин для быстрого применения
# Использование: /ban <ник> #1 (применяет первый шаблон)
reasons:
  enabled: true
  list:
    - "Использование запрещённых модификаций (читы)"
    - "Гриферство - разрушение чужих построек"
    - "Оскорбления и токсичное поведение"
    - "Спам и флуд в чате"
    - "Реклама сторонних серверов"
    - "Обход предыдущего бана"
    - "Использование дюпов и эксплойтов"

После настройки шаблоны применяются через номер:

/ban Steve #1
/tempban Alex 7d #4
/mute Notch #3

Это ускоряет работу модераторов и обеспечивает единообразие формулировок в истории наказаний.

Настройка сообщений

Файл plugins/LiteBans/messages.yml содержит все текстовые сообщения плагина. Вот ключевые блоки для русификации:

# Сообщение при бане (показывается заблокированному игроку)
ban:
  appeal_message: ""
  ban_message: |
    &c&lВы заблокированы на этом сервере!
    &7Причина: &f{reason}
    &7Забанен: &f{ban_date}
    &7Истекает: &f{expires}
    &7Администратор: &f{banned_by_name}

# Сообщение при муте
mute:
  mute_message: "&cВы не можете писать в чат. Причина: &f{reason} &c(истекает: {expires})"

# Уведомление персонала о новом бане
ban_broadcast: "&a[LiteBans] &f{banned_by_name} &7заблокировал &f{name} &7- &f{reason}"

Доступные переменные: {name}, {uuid}, {reason}, {banned_by_name}, {expires}, {ban_date}, {id}, {ip}.

Синхронизация в сети BungeeCord и Velocity

При работе в сети с несколькими серверами LiteBans нужно установить как на прокси (BungeeCord/Velocity), так и на каждый сабсервер. Все используют одинаковый config.yml с данными MySQL.

Важные нюансы синхронизации:

BungeeCord: В config.yml на прокси укажи:

bungeecord: true
# Позволяет баны применяться через прокси при входе

Velocity: Поддерживается начиная с LiteBans 2.9+. Убедись что используешь актуальную версию плагина.

Что происходит при бане: Когда модератор выполняет /ban Steve на сервере A, запись появляется в MySQL. Когда Steve пытается войти на сервер B - LiteBans читает ту же базу и блокирует вход. Задержка синхронизации при нормальной работе MySQL - менее секунды.

Проверка синхронизации: После бана на одном сервере проверь историю на другом:

/history Steve

Если история одинакова на всех серверах - синхронизация работает.

Импорт данных из других плагинов

Если ты мигрируешь с другого плагина банов, LiteBans умеет импортировать данные. Поддерживаемые источники (по состоянию на 2026):

  • AdvancedBan
  • BanManager
  • BungeeAdminTools (BAT)
  • GeSHuBan
  • MaxBans
  • Vanilla (стандартная система Minecraft)
  • BungeeBanManager

Процедура импорта:

  1. Убедись что старый плагин и LiteBans используют одинаковый тип БД или что данные доступны
  2. Выполни команду импорта (плагин старого хранения должен быть установлен):
/litebans import advancedban
/litebans import banmanager
/litebans import bat
  1. Дождись сообщения об успешном завершении
  2. Проверь историю нескольких игроков командой /history <ник>
  3. После проверки удали старый плагин

Импорт не удаляет существующие данные LiteBans - он добавляет к ним. Это позволяет делать тест-импорт без риска потери данных.

Веб-интерфейс

LiteBans имеет официальный веб-интерфейс, написанный на PHP. Он отображает публичный список активных банов, историю наказаний и позволяет игрокам искать своё имя.

Установка веб-интерфейса

  1. Скачай веб-интерфейс с официального GitLab разработчика (ссылка в документации плагина)
  2. Распакуй файлы на веб-сервере (Apache/Nginx + PHP 7.4+)
  3. Отредактируй config.php:
<?php
// Данные подключения к MySQL (те же, что в config.yml плагина)
$config = array(
    'host'     => '127.0.0.1',
    'port'     => 3306,
    'database' => 'litebans',
    'user'     => 'litebans',
    'password' => 'ваш_пароль',
    'charset'  => 'utf8mb4',
    'prefix'   => 'litebans_',  // prefix из config.yml плагина

    // Название сервера (отображается на сайте)
    'server_name' => 'Мой Minecraft сервер',

    // Язык интерфейса
    'language' => 'ru',
);
  1. Открой сайт в браузере - веб-интерфейс автоматически прочитает таблицы из базы

Настройка nginx

Пример конфига nginx для веб-интерфейса:

server {
    listen 80;
    server_name bans.ваш-сервер.ru;
    root /var/www/litebans;
    index index.php;

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

Веб-интерфейс читает данные напрямую из MySQL и не требует никаких плагинов или API на стороне сервера.

Резервное копирование данных

LiteBans хранит все данные в базе данных, поэтому резервное копирование сводится к дампу MySQL. Добавь в cron автоматический бэкап:

# Бэкап базы LiteBans каждый день в 3:00
0 3 * * * mysqldump -u litebans -pваш_пароль litebans | gzip > /backups/litebans_$(date +%Y%m%d).sql.gz

# Хранить последние 30 дней
0 4 * * * find /backups -name "litebans_*.sql.gz" -mtime +30 -delete

Для H2 (если не используешь MySQL) - регулярно копируй файл plugins/LiteBans/database.h2.mv.db. Лучший момент - во время перезагрузки сервера.

Типичные проблемы и решения

Бан не применяется в сети

  • Проверь что все серверы используют одинаковые данные MySQL в config.yml
  • Убедись что MySQL доступен с каждого сервера (mysql -h хост -u litebans -p)
  • Проверь синхронизацию времени между серверами (date на каждом)

Ошибка “Access denied” при подключении к MySQL

  • Проверь что пользователь MySQL имеет права с IP-адреса сервера: GRANT ALL ON litebans.* TO 'litebans'@'IP_сервера'
  • Если все серверы на одной машине - используй 127.0.0.1 вместо %

Игрок обходит бан через смену ника

  • Включи UUID-баны (используются по умолчанию в современных версиях)
  • Для пиратских серверов добавь IP-бан вместе с никнеймом: /banip Steve причина

LiteBans не загружается на BungeeCord

  • Убедись что используешь BungeeCord-версию jar (не Spigot)
  • Некоторые версии требуют установку и на прокси, и на сабсерверы

Связанные материалы

Для полноценной системы модерации на сервере рекомендуем изучить настройку прав через LuckPerms - он определяет, кто из персонала может использовать команды LiteBans. Список других полезных плагинов для сервера собран в статье лучшие плагины для Minecraft-сервера. Если ты разворачиваешь отдельный MySQL-сервер для хранения банов - пригодится руководство по базам данных MySQL для игровых серверов.

Заключение

LiteBans закрывает все задачи модерации на Minecraft-сервере: от простого временного бана до полноценной синхронизированной системы наказаний в сети из десятков серверов. Благодаря MySQL-бэкенду все данные надёжно сохраняются и доступны через веб-интерфейс, а модераторы получают удобные команды и шаблоны причин. Плагин активно развивается и в 2026 году поддерживает все актуальные версии Minecraft, включая 1.21+. Единовременная покупка на BuiltByBit окупается многократно, если сервер серьёзно относится к модерации и удержанию аудитории.

Pterohost - игровой хостинг с NVMe-дисками, автоматическими бэкапами и круглосуточной поддержкой: надёжная основа для Minecraft-сервера любого масштаба. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг