Skip to content
BeastMark441Public

About

BugReports - это мощный плагин для управления баг-репортами и предложениями на вашем сервере Minecraft. Плагин предоставляет удобный GUI-интерфейс для игроков и администраторов, систему уведомлений и гибкие настройки.

Resources

Stars

2 stars

Watchers

1 watching

Forks

Latest commit

 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

BugReports

📝 Краткое описание

BugReports - это мощный плагин для управления баг-репортами и предложениями на вашем сервере Minecraft. Плагин предоставляет удобный GUI-интерфейс для игроков и администраторов, систему уведомлений и гибкие настройки.

⚙️ Технические требования

  • Поддерживаемые версии Minecraft: 1.16.5 и выше
  • Минимальная версия Java: Java 16
  • Зависимости:
    • PlaceholderAPI (обязательно)
    • Purpur/Paper/Spigot (рекомендуется Purpur)

🚀 Возможности

  • Создание баг-репортов и предложений через удобный GUI
  • Категории для разных типов репортов
  • Система статусов репортов (Новый, В обработке, Завершено и т.д.)
  • Уведомления для игроков и администраторов
  • Черный список для блокировки спамеров
  • Автоматическое создание бэкапов конфигурации
  • Поддержка PlaceholderAPI
  • Полностью настраиваемые сообщения
  • Ограничения для предотвращения спама
  • Статистика репортов
  • Автоматическая проверка обновлений

🔄 Обновления

Версия 1.1.1

  • 🐛 Исправлены ошибки:
    • Исправлена проблема с двойными уведомлениями в Telegram
    • Исправлена проблема с загрузкой messages.yml
    • Исправлено отображение даты создания репорта в Telegram
    • Исправлено форматирование сообщений от администраторов
    • Добавлена корректная обработка уведомлений для оффлайн игроков
    • Добавлена поддержка Minecraft 1.16.5
  • ✨ Улучшения:
    • Добавлена система уведомлений для сообщений от администраторов в игре
    • Улучшена обработка текстовых компонентов в чате
    • Оптимизирована работа с базой данных при получении последнего репорта

Версия 1.1.0

  • ✨ Добавлена интеграция с Telegram
    • Управление репортами через бота
    • Уведомления о новых репортах
    • Изменение статусов
    • Отправка сообщений игрокам
    • Блокировка/разблокировка пользователей
  • 🔒 Улучшена система безопасности
  • 📱 Добавлены новые команды для управления Telegram
  • 🎮 Добавлена поддержка Minecraft 1.20.4

Версия 1.0.1

  • 🐛 Исправлены мелкие ошибки
  • ⚡ Улучшена производительность
  • 📝 Обновлена документация

📥 Установка

  1. Скачайте последнюю версию плагина
  2. Установите PlaceholderAPI, если еще не установлен
  3. Поместите JAR файл в папку plugins
  4. Перезапустите сервер
  5. Настройте конфигурацию в plugins/BugReports/config.yml

📚 Команды

Команды для игроков

Команда Описание Права
/bugreport Создать баг-репорт bugreports.create
/bugreport status Просмотр статуса репортов bugreports.create
/bugreport list Список всех ваших репортов bugreports.create
/suggestion Создать предложение bugreports.create
/reportstats Открыть GUI со статистикой bugreports.create

Команды для администраторов

Команда Описание Права
/reportadmin gui Открыть админ-панель bugreports.admin
/reportadmin status <id> <статус> Изменить статус репорта bugreports.admin
/reportadmin delete <id> Удалить репорт bugreports.admin
/reportadmin blacklist <player> Добавить в черный список bugreports.admin
/reportadmin unblacklist <player> Удалить из черного списка bugreports.admin
/reportadmin reload Перезагрузить конфигурацию bugreports.admin
/telegram link Привязать Telegram bugreports.admin
/telegram unlink Отвязать Telegram bugreports.admin
/telegram status Проверить статус привязки bugreports.admin

🔒 Права доступа

  • bugreports.create - Создание репортов (по умолчанию: true)
  • bugreports.admin - Доступ к админ-командам (по умолчанию: op)
    • bugreports.telegram - Доступ к Telegram интеграции (включено в bugreports.admin)

⚡ PlaceholderAPI

Плагин добавляет следующие плейсхолдеры:

  • %bugreports_total% - Общее количество репортов
  • %bugreports_player_total% - Количество репортов игрока
  • %bugreports_player_active% - Количество активных репортов игрока
  • %bugreports_new% - Количество новых репортов
  • %bugreports_in_progress% - Количество репортов в обработке

📁 Файлы конфигурации

config.yml

  • Настройки базы данных
  • Категории репортов
  • Статусы репортов
  • Ограничения
  • Настройки уведомлений
  • Параметры админ-панели

messages.yml

  • Все сообщения плагина
  • Поддержка цветовых кодов
  • Настраиваемый префикс

🔄 Автоматические бэкапы

Плагин автоматически создает бэкапы конфигурационных файлов при каждом запуске сервера. Бэкапы хранятся в папке plugins/BugReports/backups/. Сохраняются последние 5 версий каждого файла.

🎨 Особенности админ-панели

  • Цветовая кодировка статусов
  • Фильтрация и сортировка репортов
  • Массовые действия
  • Быстрый доступ к игрокам (телепортация, сообщения)
  • Детальная статистика
  • Автоматическое обновление

🛠️ Для разработчиков

Плагин использует:

  • Java 17+
  • Maven для сборки
  • SQLite для хранения данных
  • Bukkit API
  • PlaceholderAPI

🤝 Поддержка

Если у вас возникли вопросы или проблемы:

📱 Telegram интеграция

Плагин поддерживает интеграцию с Telegram для удобного управления репортами:

Возможности бота:

  • 📋 Просмотр всех репортов
  • 🆕 Уведомления о новых репортах
  • 📝 Изменение статусов
  • ✉️ Отправка сообщений игрокам
  • 🚫 Блокировка/разблокировка пользователей
  • ⚙️ Гибкие настройки уведомлений

Настройка:

  1. Получите токен бота у @BotFather
  2. Укажите токен в config.yml
  3. Включите интеграцию в настройках
  4. Используйте команду /telegram link в игре

Безопасность:

  • 🔐 Двухэтапная привязка аккаунтов
  • ⏱️ Временные коды подтверждения
  • 🛡️ Защита от несанкционированного доступа

📜 Лицензия

Этот проект распространяется под лицензией GNU Affero General Public License v3.0

About

BugReports - это мощный плагин для управления баг-репортами и предложениями на вашем сервере Minecraft. Плагин предоставляет удобный GUI-интерфейс для игроков и администраторов, систему уведомлений и гибкие настройки.

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages