Bug Report (Баг репорт)

Плагин для серверов Майнкрафт, который собирает сообщения игроков об ошибках и помогает администрации разбирать их через игровые меню. Вместе с текстом обращения сохраняются игрок, UUID, мир, координаты, режим игры, сервер, категория, статус и время отправки.

Возможности

• Просмотр всех обращений, архива и настроек в меню.
• Изменение статусов, категорий и оформление окна с подробностями обращения.
• Архивация, восстановление из архива и удаление обращений.
• Отправка обращений в Discord через webhook: можно настроить заголовок, цвет, поля сообщения, миниатюру и упоминания ролей или участников.
• Хранение данных локально или в MySQL.
• Плейсхолдеры PlaceholderAPI: %bugreports_totalBugReports%, %bugreports_totalArchivedBugReports%, %bugreports_totalNonArchivedBugReports%.

Команды

• /bugreport <сообщение> — отправить обращение; при включённом выборе категорий открывает меню или предлагает категории в автодополнении.
• /br <сообщение> — короткий вариант /bugreport.
• /buglist или /bl — открыть список обращений.
• /buglistsettings или /bls — открыть настройки списка.
• /buglistarchived или /bla — открыть архив.
• /buglinkdiscord <Webhook URL> или /bld <Webhook URL> — привязать Discord webhook.

Права

• bugreport.admin — управление обращениями.
• bugreport.notify — уведомления о новых обращениях.
• bugreport.archived — доступ к архиву.
• bugreport.settings — просмотр и изменение настроек.
• bugreport.list — просмотр списка обращений.
• bugreport.use — отправка обращения.
• bugreport.archive — архивация обращений.
• bugreport.delete — удаление обращений.

Настройка

Основные параметры находятся в конфиге плагина: databaseType выбирает локальное хранилище или mysql, а данные подключения задаются в разделе database. Через max-reports-per-player ограничивается число обращений от одного игрока, а bug-report-cooldown задаёт задержку между ними.

Категории и статусы редактируются в reportCategories и statuses. Окно с подробностями настраивается в custom_bug_report_details_GUI.yml: размер задаётся ключом guiSize, а для каждого элемента выбираются slot, bugReportItem, материал и текстура. Размер меню — от 9 до 54 ячеек, кратный 9.

Требования

Для связи со статистикой игроков нужен Plan, установленный на Spigot-сервере. Плейсхолдеры в полях Discord работают при наличии PlaceholderAPI.