Плагин AevorinReports 1.1.0 +1.0.9.1

AevorinReports — серверный плагин для приёма и обработки жалоб игроков. Он формирует последовательный модерационный процесс: пользователь создаёт обращение, сотрудники получают уведомление, изучают запись и переводят её в итоговый статус.

Проект поддерживает графические интерфейсы, историю обращений, локальное и сетевое хранение, локализацию, Discord и PlaceholderAPI. Категории — management, social, utility и game-mechanics. Клиентская установка не предусмотрена: обязательная часть работает на сервере.

Назначение плагина​

AevorinReports заменяет разрозненные жалобы в чате и личных сообщениях отдельной системой записей. Она помогает персоналу видеть новые обращения, отличать активные случаи от завершённых и сохранять понятный порядок действий.

Подтверждённый цикл включает три состояния: Pending, Resolved и Rejected. Новая жалоба ожидает проверки, после чего сотрудник отмечает её как решённую или отклонённую. Критерии решений остаются частью правил самого сервера.

Скриншоты и внешний вид​

Создание и история жалоб​

Игрок может отправить жалобу на другого участника и указать причину. Если причина не передана сразу, открывается GUI; собственный текст разрешено вводить через чат. Набор готовых причин и ограничения текста в основе не раскрыты.

История отправленных обращений доступна игроку вместе с текущими статусами. Это позволяет проверить, находится ли запись в ожидании или уже закрыта, но не означает гарантированного срока ответа.

Рабочий цикл выглядит так:

• игрок создаёт жалобу;
• система сохраняет запись;
• персонал получает уведомление;
• сотрудник просматривает сведения;
• обращению назначается итоговый статус;
• автор видит обновлённое состояние.

Интерфейсы и уведомления​

Для персонала предусмотрен интерактивный административный GUI с управлением через клики. Поддерживаются два варианта: интерфейс в виде книги и контейнерный интерфейс в формате сундука. Они предназначены для просмотра, ведения и обновления записей.

О новых жалобах сотрудники могут получать уведомления в реальном времени. Это помогает быстрее заметить обращение, однако скорость реакции зависит от присутствия и внутренней организации команды.

Сообщения поддерживают MiniMessage, включая градиенты, форматирование и события наведения. Также заявлена многоязычная система с пользовательскими языковыми пакетами. При локализации важно проверить единообразие статусов и ясность уведомлений.

Хранение данных и серверные сети​

AevorinReports поддерживает SQLite и MySQL. SQLite указан как вариант локального хранения, а MySQL — как средство синхронизации в серверной сети. Плагин применим как на одном сервере, так и там, где несколько узлов должны работать с общей очередью.

В описании упомянуты асинхронная обработка и интеллектуальное кэширование. Они заявлены как меры оптимизации, но точные пределы нагрузки и результаты независимых испытаний не приведены.

Перед сетевым внедрением полезно определить:

• какие серверы используют общую базу;
• какие роли закрывают обращения;
• где хранятся резервные копии;
• должна ли история быть общей для всех узлов.

Интеграции и телеметрия​

Плагин заявляет интеграцию с Discord через отдельного бота, встроенные сообщения и оперативные уведомления. Перечень команд бота в предоставленном материале отсутствует, поэтому дополнительные возможности приписывать ему нельзя.

PlaceholderAPI отмечена как необязательная зависимость. При её наличии доступны заполнители со статистикой жалоб. Без неё основной плагин остаётся самостоятельным компонентом.

Также указаны bStats и FastStats для анонимной статистики использования и телеметрии. Точный состав данных и способы управления сбором следует проверять для выбранной версии.

Совместимость​

Серверная сторона обязательна, клиентская не поддерживается. Игрокам не требуется устанавливать мод или отдельный клиентский файл.

Подтверждены Bukkit, Folia, Paper, Purpur и Spigot. Ряд Minecraft начинается с 1.18 и охватывает выпуски 1.18.x, 1.19.x, 1.20.x и 1.21.x до 1.21.11, а также 26.1, 26.1.1, 26.1.2 и 26.2. Перед обновлением нужно сопоставлять JAR с версией игры и серверной платформой.

Установка и права доступа​

Подтверждённый способ установки — поместить один JAR в папку plugins совместимого сервера. Не следует одновременно оставлять несколько версий AevorinReports, если такая схема отдельно не предусмотрена.

Порядок развёртывания:

• Проверить версию Minecraft и платформу.
• Выбрать один выпуск и сделать резервную копию.
• Поместить JAR в plugins.
• Запустить сервер штатным способом.
• Проверить жалобу, историю и административный GUI.
• Раздать права только нужным ролям.

Команда /report создаёт жалобу и использует право aevorinreports.report; вместе с обращением можно передать причину. /reports с этим правом показывает игроку его записи. Для персонала /reports открывает административный GUI при aevorinreports.manage; /viewreport показывает подробности, а /setreportstatus меняет состояние. /ar reload связан с правом aevorinreports.reload.

Файлы и проверка целостности​

В основе приведены две сборки:

• AevorinReports-1.1.0-all.jar, версия 1.1.0, 20 727 413 байт;
• AevorinReports-1.0.9.1-all.jar, версия 1.0.9.1, 20 714 556 байт.

SHA-1 версии 1.1.0 — 342a669300080e8f469a5b1ff479022c70900e69; SHA-1 версии 1.0.9.1 — efd4b555c7888dffb3389c485cd44288e9145ca6. Для обеих сборок также опубликованы SHA-512. Размер и хеш должны относиться к одному файлу.

JAR-файлы получены по официальному HTTPS, сверены с опубликованными хешами и прошли статическую проверку структуры и путей. Динамический запуск не выполнялся, поэтому такая проверка не заменяет испытание на отдельном сервере.

Лицензия и ограничения​

AevorinReports распространяется по лицензии MIT. Она регулирует использование и распространение проекта, но не отменяет необходимость учитывать лицензии интеграций и собственную политику работы с обращениями.

Существенное ограничение указано разработчиком: плагин не функционирует на серверах, расположенных в Израиле. Оно применяется автоматически посредством проверки IP-адреса и часового пояса. Предоставленные данные не описывают поддерживаемого способа отключить это поведение.

Практическая проверка перед запуском​

Перед открытием системы для всех игроков полезно:

• создать жалобу с указанной причиной;
• повторить сценарий с вводом через чат;
• проверить уведомление сотрудника;
• открыть запись в выбранном GUI;
• изменить статус и проверить историю автора;
• убедиться в правильном разделении прав;
• при MySQL повторить тест на нужных узлах;
• проверить локализацию и интеграции.

Такой тест не гарантирует работу при любой нагрузке, но помогает обнаружить ошибки совместимости, хранения или прав до начала реальной модерации.

Безопасная проверка​

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

FAQ​

Нужна ли установка игрокам?​

Нет. Клиентская сторона не поддерживается, а обязательный компонент устанавливается на сервер.

Можно ли использовать общую очередь в сети?​

Проект поддерживает MySQL для сетевой синхронизации. Схему подключения и резервного копирования определяет администратор.

Обязательна ли PlaceholderAPI?​

Нет. Это необязательная зависимость для статистических заполнителей.

Какие статусы подтверждены?​

Pending, Resolved и Rejected: ожидание, решение и отклонение.

Выполнялся ли запуск файлов?​

Нет. Проведены загрузка по официальному HTTPS, сверка хешей и статическая проверка; динамическое выполнение не проводилось.