Плагин AuroraQuests 2.5.0-b168 +2.2.0

AuroraQuests — серверный GUI-плагин заданий с пулами, таблицами лидеров, уровнями, более чем тридцатью типами задач, несколькими наградами и интеграциями. Проект erik_sz распространяется по Apache-2.0 для Folia, Paper и Purpur.

Назначение и модель использования​

Плагин объединяет квесты в управляемую систему: администратор формирует пулы, задаёт сложность, связывает задачи с наградами и выводит их через настраиваемые GUI-меню.

Заявлены два основных подхода к пулам. Global рассчитан на задания, которые выполняются один раз, поэтому подходит для сюжетной последовательности или постоянной цепочки прогресса. Timed Random выбирает случайные задания по настраиваемому cron-расписанию и подходит для регулярно обновляемой активности.

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

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

Кому подходит AuroraQuests​

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

Практические сценарии:

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

Квестовые пулы, сложность и прогресс​

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

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

Задачи и награды​

AuroraQuests допускает несколько задач в одном квесте и несколько наград за его завершение. Среди подтверждённых видов наград названы RPG-показатели, команды, деньги, разрешения и предметы. Это позволяет связывать квесты как с базовой экономикой, так и с внешними игровыми системами.

Командные награды требуют проверки полномочий, аргументов и эффекта. Готовые безопасные команды в основе не приведены.

Баланс наград следует оценивать по трём вопросам:

• Можно ли повторять квест и как часто?
• Не дублируется ли выдача после переподключения или синхронизации?
• Соответствует ли ценность награды сложности и времени выполнения?

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

Совместимость и ограничение Folia​

Подтверждены Folia, Paper и Purpur, а также Minecraft 1.20.4–1.20.6, 1.21–1.21.11 и 26.2. Отсутствующий номер нельзя автоматически считать поддерживаемым.

Для Folia заявлена совместимость, но с прямым ограничением: фильтры биомов использовать нельзя. Это важное различие между платформами. Если квест зависит от проверки биома, такой сценарий нельзя переносить на Folia без отдельной переработки и теста.

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

Зависимости и интеграции​

AuroraLib является обязательной зависимостью; официальный текст требует актуальную версию библиотеки. AuroraLevels указана как необязательная зависимость. Установка одного AuroraQuests без совместимой AuroraLib не соответствует заявленной схеме.

Подтверждённые интеграционные возможности включают:

• MySQL для межсерверной синхронизации;
• PlaceholderAPI для динамических заполнителей;
• Developer API для расширения;
• AuroraLevels как необязательное дополнение;
• несколько типов внешних наград.

Точные версии и порядок настройки интеграций в основе отсутствуют. Интеграция требует проверки.

Установка и первый запуск​

JAR помещают в папку plugins совместимого сервера вместе с требуемой AuroraLib. Первый запуск проводят на тестовом экземпляре.

Базовая последовательность:

• Сверить версию Minecraft и платформу.
• Выбрать выпуск AuroraQuests.
• Установить совместимую AuroraLib.
• При необходимости подготовить AuroraLevels.
• Проверить контрольные суммы JAR.
• Поместить файлы в папку plugins.
• Запустить сервер и изучить журнал.
• Открыть GUI и проверить минимальный тестовый квест.

В основе нет команд установки, шаблонов конфигурации или реквизитов базы. Их нельзя придумывать; секреты MySQL не публикуют в отчётах.

Проверка результата​

Проверка должна охватывать интерфейс, прогресс, награду и сохранение данных. Простого появления плагина в списке недостаточно.

Минимальный чек-лист:

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

Периодический пул проверяют на границе расписания, включая поведение после рестарта. Синтаксис cron в основе не приведён.

Безопасное обновление и откат​

В перечне файлов указаны AuroraQuests-2.5.0-b168.jar размером 696 837 байт и AuroraQuests-2.2.0.jar размером 672 174 байта. Для обоих опубликованы SHA-512 и SHA-1. Перед заменой версии нужно сохранить JAR, конфигурации, данные игроков и резервную копию используемой базы.

Порядок обновления:

• Остановить тестовый сервер.
• Сохранить AuroraQuests, AuroraLib и данные.
• Проверить совместимость версий зависимостей.
• Сверить SHA-512 нового файла.
• Запустить копию с существующими квестами.
• Проверить GUI, прогресс, награды и синхронизацию.
• Только затем повторить процедуру в рабочей среде.

Для отката возвращают прежние AuroraQuests, совместимую AuroraLib и сохранённые данные. Одного JAR может быть недостаточно.

Ограничения и диагностика​

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

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

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

Целостность файлов, лицензия и авторство​

Файлы получены по официальному HTTPS, сверены по хешам и статически проверены. JAR не запускались, поэтому нужен изолированный тест.

AuroraQuests распространяется по Apache-2.0. При локализации нужно сохранять имя проекта, авторство erik_sz и сведения о лицензии. Редакционные рекомендации и результаты конкретного тестирования не следует приписывать автору.

FAQ​

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

Да. В выбранных данных она указана как required, а официальный текст требует актуальную AuroraLib для запуска.

Нужна ли AuroraLevels?​

Нет, она обозначена как optional. Её следует устанавливать только для функций, которые действительно нужны и подтверждены документацией.

Работает ли AuroraQuests на Folia?​

Совместимость заявлена, но биомные фильтры на Folia использовать нельзя.

Можно ли синхронизировать прогресс между серверами?​

Да, заявлена межсерверная синхронизация через MySQL. Корректность схемы и миграций нужно проверить на тестовой базе.

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

Приведены 2.5.0-b168 и 2.2.0. Выбор делают по совместимости с сервером, AuroraLib и существующими данными, а файл сверяют по SHA-512.