
AuroraLib
Base plugin for every Aurora project. Provides common utilities and functions.
Автор: erik_sz6,4 тыс.20обновлён 17 авг. 2026 г.
БиблиотекиТехнологииУтилиты
Описание
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
PlayerRegionEnterEventandPlayerRegionLeaveEvent CommandDispatcherto 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}")
}
Последние версии
Все версии →release
2.6.0
2.6.0-b21517 авг. 2026 г.657Minecraft: 26.2folia, paper, purpur
release
AuroraLib 2.5.3
2.5.310 апр. 2026 г.1,3 тыс.Minecraft: 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2folia, paper, purpur
Что нового
26.1.1 support
release
2.5.1
2.5.125 дек. 2025 г.499Minecraft: 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11folia, paper, purpur
Что нового
- Remove leftover warning message for number rewards
release
2.5.0
2.5.011 дек. 2025 г.84Minecraft: 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11folia, paper, purpur
Что нового
- 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
release
2.4.2
2.4.212 нояб. 2025 г.233Minecraft: 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10folia, paper, purpur
Что нового
- Fix message migrator 1.20.4 compat
- Add getLanguageProvider to AuroraAPI
release
2.4.1
2.4.18 нояб. 2025 г.39Minecraft: 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10folia, paper, purpur
Что нового
- Fill placeholders in menus even if localization provider is not set
- Make slots option higher priority than default slot
release
2.4.0
2.4.030 окт. 2025 г.79Minecraft: 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10folia, paper, purpur
Что нового
## 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:
```yml
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.
release
2.3.4
2.3.422 июл. 2025 г.538Minecraft: 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8folia, paper, purpur
Что нового
- 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
release
2.3.3
2.3.325 июн. 2025 г.178Minecraft: 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8folia, paper, purpur
Что нового
- 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
release
2.3.1
2.3.125 мая 2025 г.158Minecraft: 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6folia, paper, purpur
Что нового
- Add support for ItemEdit in item resolvers with syntax `itemedit:server_item_id`
- Add support for EvenMoreFish **2.0** in item resolvers with sytanx: `emf:rarity:fish_id`
- Fix very rare race condition with user data loading