LiteBansBridge - это плагин-мост для LiteBans, который поднимает встроенную веб-страницу со списком банов и киков прямо из вашего сервера.

Что это и зачем нужно

LiteBans - топовый плагин для управления наказаниями. Но проблема в том, что для вывода истории банов на отдельный сайт обычно нужно поднимать веб-сервер (Apache или Nginx), настраивать базу данных и ковыряться с PHP. LiteBansBridge решает эту проблему. Он делает из вашего сервера Minecraft полноценный LiteBans web-host прямо из коробки.

Плагин универсальный. Один JAR-файл работает на Bukkit, Spigot, Paper, Purpur, а также на прокси BungeeCord и Waterfall. По данным Modrinth, заявлена поддержка версий Minecraft от 1.8.x до 1.21.x. Лицензия MIT, проект активно развивается.

Два сайта в одном порту

Плагин хостит сразу два независимых веб-интерфейса на одном порту:

• Публичный сайт (http://your-ip:PORT/) - обычные игроки могут смотреть историю банов и киков. Авторизация не нужна. Дизайн минималистичный, приватность в безопасности.
• Стафф-портал (http://your-ip:PORT/staff) - доступ по секретному API-ключу. Браузер запоминает вход, так что админам не надо вводить пароль каждый раз. Тут показывается чувствительная инфа: IP-адреса игроков и их последние локации на сервере.

Дизайн и фишки версии 2.0

В версии 2.0 интерфейс полностью переработали. Сделали темную тему на TailwindCSS. По факту, выглядит это очень сочно.

• Live Search - мгновенный поиск по никам, причинам бана или IP без перезагрузки страницы.
• Табы - переключение между банами и киками с анимациями.
• Динамические аватарки - плагин сам тянет 3D головы игроков и админов, которые выдавали наказание.
• Бейджи статусов - четко видно, бан активен, истек или снят (Active, Expired, Unbanned).

Прямой доступ к базе LiteBans

Никакого сложного MySQL-веб-сета. Плагин использует нативный LiteBansAPI, чтобы напрямую цепляться к базе данных, которую вы уже настроили для LiteBans. Unix-времения автоматически переводятся в читаемые даты. SQL-запросы защищены от инъекций.

Установка и настройка

Плагин работает по принципу Drop-In & Play. Кидаете JAR в папку plugins/ и рестартите сервер.

Шаг 1. Конфиг

После первого рестарта идем в plugins/LiteBansBridge/config.yml: yml

==========================================

LiteBansBridge Settings

Version: 2.0

==========================================

Порт для веб-сайта

port: 8888

Секретный API-ключ для STAFF-сайта

Если пусто - сгенерируется автоматически

api-key: "lb_generated_key_here"

По дефолту стоит порт 8888. Меняйте на любой свободный. API-ключ генерируется сам, но можете вписать свой пароль. Главное - не светите его обычным игрокам.

Шаг 2. Проброс портов (Критично!)

Чтобы сайт открывался не только у вас на ПК, нужно открыть порт. Если у вас домашний сервер - пробрасывайте TCP порт 8888 в роутере.

Хотите поиграть с друзьями онлайн без боли с портами? Плагин отлично работает на BungeeHost (https://bungee.host). Там вы можете развернуть свою серверную сеть в пару кликов, а нужные порты для веб-интерфейса открываются проще.

Шаг 3. Кастомизация

В отличие от классических веб-мостов, тут HTML отдается прямо из папки плагина. Идем в plugins/LiteBansBridge/. Там лежат index.html (публичный) и staff.html (для админов). Редактируйте текст, цвета, лого в Notepad++ или VSCode. Сохраните файл и просто обновите страницу в браузере. Рестарт сервера не нужен!

Команды и права

• /lbbridge (право lbbridge.admin) - показывает текущий порт и секретный API-ключ. Удобно, если забыли пароль от стафф-портала.
• /lbbridge reload (право lbbridge.admin) - перезагружает конфиг. Внутренний веб-сервер рестартует мгновенно, если вы сменили порт.

Важные нюансы из практики

По дефолту BungeeGuard может блочить подобные веб-запросы. Но LiteBansBridge поднимает свой внутренний HTTP-сервер, который обходит фаерволы BungeeGuard. Так что на защищенных бэкендах все заведется.

Скачайте плагин LiteBansBridge, если устали настраивать отдельные сайты для просмотра банов. Это must-have для любой сети на BungeeCord или Paper, где админам нужен быстрый доступ к логам наказаний игроков.