# AuroraLevels

**AuroraLevels** is a Minecraft plugin developed for PaperMC (and its forks like Purpur and Pufferfish) and Folia. You can check out the source code on [GitHub ](https://github.com/AuroraNetworkStudios/AuroraLevels)and download it for free on Modrinth. On the official [Website](https://auroramc.gg/downloads/auroralevels) you can download dev builds.

## Overview

**AuroraLevels** provides a level for every player and doesn't have any opinions about how you give XP to your players to level up. You can define your leveling XP curve with a simple math formula. The plugin will provide rewards (configured by you) to the players when they level up. To some degree, for certain reward types (like permissions or stats from other plugins) it can also automatically correct the rewards for players if you change your config later on (eg.: you get the new permissions which wasn't in the config before or your bonus stats like health/strength from other plugins will recalculate).

You can define interval-based `level matchers` with priorities and custom rewards for certain levels. This means you can have different rewards for every 1, every 5, every 10, and every X level, depending on how you configure the plugin. You can also customize rewards for just specific levels and these will become Milestone levels, where you reward your users with bigger bonuses, as server feature unlocks.

The plugin features fully customizable GUI menus for level progression and milestones.

All in all, this is a dead simple, GUI-based, fully configurable, and customizable global player leveling plugin.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.auroramc.gg/auroralevels/auroralevels.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
