Aurora Plugins

AuroraLevels·Updated 14 Oct 2026

Placeholders

List of PlaceholderAPI placeholders

AuroraLevels provides built-in placeholders for PlaceholderAPI.

  • %aurora_level% - Current level of the player

  • %aurora_level_roman% - Current level of the player as a roman numeral (e.g. XII)

  • %aurora_level_xp% - Current XP of the player (not combined, just from the current level). This is the raw number, so it can contain decimals (e.g. 150.0)

  • %aurora_level_xp_formatted% - Same as above, but the number is formatted with the number format from the AuroraLib config (decimals are kept)

  • %aurora_level_xp_short% - Same as above, but the number is short formatted like 15k

  • %aurora_level_xpnext% - How much XP is needed from the player's current level to achieve the next level (This always gives the full amount XP needed, doesn't matter if the player already has some of it.) This is the raw number, so it can contain decimals

  • %aurora_level_xpnext_formatted% - Same as above, but the number is formatted

  • %aurora_level_xpnext_short% - Same as above, but the number is short formatted like 15k

  • %aurora_level_progressbar% - The same progressbar you can see in the menu

  • %aurora_level_icon% - Custom icon generator for player level (to use with Nexo/ItemsAdder for example). See the icon-generator section in the Main config

Leaderboard placeholders:

[number] is the leaderboard position, starting from 1. Only the top positions up to leaderboard-cache-size (10 by default, set in config.yml) are available.

  • %aurora_lb_levels_name_[number]% - name of the player

  • %aurora_lb_levels_value_[number]% - value of the tracked stat (the player's total XP collected across all levels)

  • %aurora_lb_levels_fvalue_[number]% - same but formatted number

  • %aurora_lb_levels_cvalue_[number]% - Custom value that the leaderboard provides. This is also formatted. It would be best if you used this as the value placeholder. This is the actual level of the player. The previous two would be just their total XP.