AuroraLib

Base plugin for every Aurora project. Provides common utilities and functions.

Загрузки: 4K
Подписчики: 18
Обновлён: 10 апреля 2026 г.
Лицензия: All-Rights-Reserved

Опубликован 8 июля 2024 г.

AuroraLib

This is the base plugin for every Aurora plugin. It requires PaperMC as the server software and Java 21 or higher. Folia is also supported.

You can view the full documentation here.

It provides the following utilities:

chat/actionbar messaging, text building using every possible color formats and styles.
custom logger
automatic yaml to class mapping and config versioning
plugin dependency management
inventory menu/gui builder with premade configs
user data management via file or mysql (mysql can sync between servers as well)
builtin user metadata store with placeholder support
economy expansion with builtin providers (CMI, EssentialsX, Vault)
placeholder expansion to interact with PAPI
configurable number formatting (regular and short formats as well)
player placed block tracker (supporting flatfile or sqlite as storage) which integrates with Multiverse-Core and WildRegeneration for cleanup. It can even handle manual chunk deletions.
WorldGuard expansion to provide events like PlayerRegionEnterEvent and PlayerRegionLeaveEvent
CommandDispatcher to easily dispatch commands from config files
Common leveler / level matcher / level reward utilities.
Item resolver/builder interface which supports items from other plugins.
Leaderboard APIs

Include it in your project

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}")
}

Ченджлог

2.5.3Релиз26.1, 26.1.1, 26.1.2 · 10 апреля 2026 г.

26.1.1 support

2.5.1Релиз1.21.9, 1.21.10, 1.21.11 · 25 декабря 2025 г.

Remove leftover warning message for number rewards

2.5.0Релиз1.21.9, 1.21.10, 1.21.11 · 11 декабря 2025 г.

Add CraftEngine as an item resolver
Add CrackShot as an item resolver
Highly improve /aurora debug itemid <level> command
Make every type of reward a number reward (available automatically in every Aurora plugin)
Fix some teleport error when a world is unloaded

2.4.2Релиз1.21.8, 1.21.9, 1.21.10 · 12 ноября 2025 г.

Fix message migrator 1.20.4 compat
Add getLanguageProvider to AuroraAPI

2.4.1Релиз1.21.8, 1.21.9, 1.21.10 · 8 ноября 2025 г.

Fill placeholders in menus even if localization provider is not set
Make slots option higher priority than default slot

2.4.0Релиз1.21.8, 1.21.9, 1.21.10 · 30 октября 2025 г.

Per player localization support added

https://docs.auroramc.gg/aurora/per-player-localization

messages.yml is now messages_en.yml and you can create more using proper language codes like messages_de.yml for german.

Examples: en-US, en-UK, en, de, sk, hu In this file, you can add a new section, named custom (which is already there if you do a fresh install:

custom:
  stash-title: Item stash
  prev-page: '&fPrevious Page'
  npc:
    quests: <white>Quests

These values are available in the plugin menus like item stash. You can reference them as {{stash-title}} or {{npc.quests}}. Notice the dot (.) notation for nested structures.

These are also exposed as PlaceholderAPI placeholders: %aurora_lang_<key>% for example: %aurora_lang_npc.quests%

This allows you to add per player localization to any plugin that supports PlaceholderAPI placeholders.

To enable per player localiaztion:

In your config.yml you have to:

add the language codes you support in supported-languages
choose your default language and set it to locale field
set use-per-player-locale to true

And then you have to:

grant the aurora.core.user.language to the players so they have access to the /language command After all these, players will be able to use their desired language.

Notice that in config.yml the number-format section also have a locale value. That is only used when per player locale is disabled, otherwise it will use the player's selected locale.

2.3.4Релиз1.21.6, 1.21.7, 1.21.8 · 22 июля 2025 г.

Add item resolver priorities to config
Add item resolver for KGenerators plugin using kgenerators:generator_id
Add item interop for every supported item plugin with MythicMobs drops/equipment using auroralib{item=namespace:item_id}, example: auroralib{item=nexo:forest_chestplate}
Expose data saving/loading latency measurements via debug command: /aurora debug latency (should be ran after about half an hour of active player joining/leaving)
Offline players loaded through API aren't cached anymore to prevent potentional synchronization issues

2.3.3Релиз1.21.6, 1.21.7, 1.21.8 · 25 июня 2025 г.

Mark blocks as player placed that are created using a builder wand from WildTools
Extend the API of RegionExpansion to work with just locations instead of blocks
Removed useless scheduler calls from actionbar/chat handlers
Actionbar utility now pauses AuraSkills idle/xp actionbar just like AuraSkills does when using its ProtocolLib hook

AuroraLib

Include it in your project

Maven

Gradle

Ченджлог

Per player localization support added

To enable per player localiaztion:

Комментарии