AuroraLib

AuroraLib - это основа всей экосистемы плагинов Aurora. Если ты собираешь сервер на PaperMC (нужна версия Java 21 или выше) и хочешь использовать плагины типа AuroraQuests, AuroraSkills и других, этот модуль обязателен. Кстати, поддерживается и Folia.

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

Что даёт AuroraLib

• Чат и уведомления - отправка сообщений в чат и экшнбар, гибкое форматирование текста с любыми цветами и стилями.
• Кастомный логгер - логирование с префиксом плагина.
• Умные конфиги - автоматическая подгрузка YAML в классы и версионирование конфигов. Не надо вручную парсить.
• Управление зависимостями - плагин сам следит, подгружены ли нужные модули.
• Графический интерфейс - билдер меню и инвентарей с готовыми шаблонами конфигов.
• Работа с пользователями - хранение данных в файле или MySQL (можно синхронизировать между серверами). Плюс встроенный метастор с поддержкой плейсхолдеров.
• Экономика - встроенная поддержка CMI, EssentialsX и Vault. Можно расширять.
• Плейсхолдеры - интеграция с PlaceholderAPI, свои плейсхолдеры.
• Форматирование чисел - обычные и короткие форматы (1.2K и т.п.).
• Трекер блоков, поставленных игроками - сохраняет данные в flatfile или SQLite. Работает с Multiverse-Core и WildRegeneration для очистки. Даже ручное удаление чанков обрабатывает.
• Интеграция с WorldGuard - добавляет события входа/выхода из региона (PlayerRegionEnterEvent, PlayerRegionLeaveEvent).
• CommandDispatcher - удобно запускать команды из конфигов.
• Левелер и награды - общие утилиты для уровней, подбора уровней, наград.
• Item resolver/builder - интерфейс для предметов из других плагинов.
• Лидерборды - API для таблиц рекордов.

Подключение к проекту

Если ты разрабатываешь свой плагин на базе AuroraLib, добавь зависимость.

Maven

<repository>
    <id>auroramc</id>
    <url>https://repo.auroramc.gg/releases/</url>
</repository>

<dependency>
    <groupId>gg.auroramc</groupId>
    <artifactId>Aurora</artifactId>
    <version>{VERSION}</version>
    <scope>provided</scope>
</dependency>

Gradle

Groovy DSL:

repositories {
    maven {
        url "https://repo.auroramc.gg/releases/"
    }
}

dependencies {
    compileOnly 'gg.auroramc:Aurora:{VERSION}'
}

Kotlin DSL:

repositories { 
    maven("https://repo.auroramc.gg/releases/")
}

dependencies { 
    compileOnly("gg.auroramc:Aurora:{VERSION}")
}

Скачайте AuroraLib - без него ни один плагин серии Aurora не заработает. А если вы разработчик, с этой базой писать свои модули станет в разы проще.