Плагин LiteBansNotify - уведомления администрации в Telegram [1.1.0]

Описание:​

Функционал и особенности:​

• Уведомления о всех типах наказаний: бан, мут, кик, варн
• Уведомления о снятии наказаний: разбан, размут, снятие варна
• Отображение полной информации: нарушитель, модератор, дата, длительность, причина
• Поддержка временных и постоянных наказаний
• Поддержка тем (топиков) в Telegram чатах
• Полностью настраиваемые сообщения через конфигурацию
• Настраиваемый формат даты и времени
• Легкий и не требовательный к ресурсам
• Работает на любых версиях от 1.16+

Требования:​

• Minecraft сервер версии 1.16 или выше
• Java 17 или выше
• Плагин LiteBans (обязательно)
• Telegram бот (бесплатно создается через @BotFather)

Конфигурация:​

patternTime: dd.MM.yy HH:mm

telegram:
  enable: true
  token: TOKEN_BOT_API
  id: -1002100000000
  theme: 52

messages:
  nonePlayer: ❓ Неизвестно
  noneTime: Навсегда
  kick:
    - 🦶 <b>КИК</b>
    - <b> </b>
    - <b>Нарушитель:</b> {player}
    - <b>Наказал:</b> {exec_player}
    - <b>Дата:</b> {time}
    - <b>Причина:</b> {reason}
    - <b>Режим:</b> {servers}
  ban:
    - 🚫 <b>БАН</b>
    - <b> </b>
    - <b>Нарушитель:</b> {player}
    - <b>Наказал:</b> {exec_player}
    - <b>Дата:</b> {time}
    - <b>Длительность:</b> {time_end}
    - <b>Причина:</b> {reason}
    - <b>Режим:</b> {servers}
  mute:
    - 🔇 <b>МУТ</b>
    - <b> </b>
    - <b>Нарушитель:</b> {player}
    - <b>Наказал:</b> {exec_player}
    - <b>Дата:</b> {time}
    - <b>Длительность:</b> {time_end}
    - <b>Причина:</b> {reason}
    - <b>Режим:</b> {servers}
  warn:
    - ⚠️ <b>ПРЕДУПРЕЖДЕНИЕ</b>
    - <b> </b>
    - <b>Нарушитель:</b> {player}
    - <b>Наказал:</b> {exec_player}
    - <b>Дата:</b> {time}
    - <b>Длительность:</b> {time_end}
    - <b>Причина:</b> {reason}
    - <b>Режим:</b> {servers}
  unban:
    - ✅ <b>РАЗБАН</b>
    - <b> </b>
    - <b>Нарушитель:</b> {player}
    - <b>Исполнитель:</b> {exec_player}
    - <b>Дата:</b> {time}
    - <b>Причина:</b> {reason}
    - <b>Режим:</b> {servers}
  unmute:
    - 🔊 <b>РАЗМУТ</b>
    - <b> </b>
    - <b>Нарушитель:</b> {player}
    - <b>Исполнитель:</b> {exec_player}
    - <b>Дата:</b> {time}
    - <b>Причина:</b> {reason}
    - <b>Режим:</b> {servers}
  unwarn:
    - ✅ <b>РАЗВАРН</b>
    - <b> </b>
    - <b>Нарушитель:</b> {player}
    - <b>Исполнитель:</b> {exec_player}
    - <b>Дата:</b> {time}
    - <b>Причина:</b> {reason}
    - <b>Режим:</b> {servers}

Команды:​

Разрешения:​

• litebansnotify.admin — Доступ ко всем командам плагина (по умолчанию только для операторов сервера)

Инструкция по настройке Telegram бота:​

Шаг 1: Создание бота​

1. Напишите @BotFather в Telegram
2. Отправьте команду /newbot
3. Придумайте имя для бота (например, "My Server Notify")
4. Придумайте username для бота (должен заканчиваться на "bot", например, "myserver_notify_bot")
5. Скопируйте полученный токен и вставьте его в config.yml в поле token

Шаг 2: Получение ID чата​

1. Создайте группу в Telegram или используйте существующую
2. Добавьте вашего бота в эту группу (через поиск по username)
3. Отправьте любое сообщение в группу
4. Откройте в браузере: https://api.telegram.org/bot<ВАШТОКЕН>/getUpdates (замените <ВАШТОКЕН> на токен бота)
5. Найдите в ответе значение "chat":{"id": — это и есть ID вашего чата
6. Скопируйте это значение (обычно это отрицательное число) и вставьте в config.yml в поле id

Шаг 3: Получение ID темы (опционально)​

1. Откройте нужную тему в Telegram
2. ID темы можно найти в URL-адресе темы или через бота при отправке тестового сообщения
3. Вставьте ID темы в config.yml в поле theme

Шаг 4: Проверка работы​

1. Перезагрузите плагин командой /litebansnotify reload
2. Используйте команду /litebansnotify test для отправки тестового сообщения
3. Проверьте, пришло ли сообщение в ваш Telegram чат

Установка:​

1. Скачайте последнюю версию плагина
2. Поместите .jar файл в папку plugins вашего сервера
3. Убедитесь, что плагин LiteBans установлен и работает
4. Перезапустите сервер
5. Настройте файл config.yml в папке plugins/LiteBansNotify/ (см. раздел "Инструкция по настройке Telegram бота")
6. Используйте команду /litebansnotify reload для применения настроек
7. Используйте команду /litebansnotify test для проверки работы

Примеры использования:​

🚫 БАН
 
Нарушитель: Griefer
Наказал: Moderator
Дата: 17.12.25 14:30
Длительность: Навсегда
Причина: Читы
Режим: Все серверы

🔇 МУТ
 
Нарушитель: Spammer
Наказал: Admin
Дата: 17.12.25 14:35
Длительность: 1 день
Причина: Спам в чате
Режим: Все серверы