Level menu

menus/levels.yml configuration guide

title - Title of the inventory

rows - How many rows (1-6) the menu should have. Default is 6.

level-track - Defines how many levels are shown and where to put them. The first is always the current, 2nd is always the in-progress level. After that, everything will be the next not yet completed levels. In case if you use the paginated menu variant, every page shows as many levels as there are slots in level-track, starting from level 1, and the menu opens on the page that contains the player's current level.

use-pagination - Setting this to true will create a menu that has pages. Only works if there is a max-level set in config.yml

use-item-amounts - Setting this to true will set the item amounts on the menu items equal to the level the menu item represents. Only works if you have a max-level set in config.yml that is less or equal to 64.

progress-bar:

length - how many characters should a progress bar use? This is also used by the %aurora_level_progressbar% placeholder.
filled-character - character to show for the progress bar completed part
unfilled-character - character to show for the progress bar not completed part

Display components

These are for more advanced templating features. Currently, only rewards are supported as components.

display-components:
  rewards:
    title: "&7ʀᴇᴡᴀʀᴅѕ"
    line: "  {reward}"

The title will only show at the start when there is at least one reward. The line will be filled with the reward placeholder, and every reward will get its new line.

Items

Filler

Set enabled to false if you don't want any inventory filler item. You can use every item option under the item field.

Completed/next/locked level

This will be shown when the level is completed/locked/in progress by the player in the menu. You can use every item option for these. For custom levels, you can override parts of the item or even the whole item in your main config. For example for a high reward level, you could change the menu item material to stand out. The completed and locked level items are also used in the milestones menu.

Use component:rewards as a lore line to show the rewards of the level (see display components above). Besides the placeholders listed in the Main config (formula placeholders, {level}, {level_roman}, etc.), the next-level item also has:

{current} / {current_short} - XP the player has collected in the current level
{required} / {required_short} - XP required to reach the next level
{progressbar} - the progress bar

XP values are formatted with the number format from the AuroraLib config, so decimal XP is displayed properly.

Previous/current/next page

These are pagination controls in the menu. They are only used when use-pagination is enabled, and only visible if there is more than one page. {current} and {max} can be used for the current page and the page count. Every item option can be used here.

Custom items

You can add extra items with click actions to the menu. Every item option can be used (see Item config). on-left-click, on-right-click and on-click are also supported. These are a list of commands backed by CommandDispatcher. You can read about what can it do in Command dispatcher. Set custom-items to {} if you don't want any.

The {level} placeholder and the total XP of the player as {current} / {current_short} are available in custom items.

Leaderboards

If you want to display leaderboards, you can use some internal placeholders. Add this to your custom items:

  info:
    name: "&aYour level ranking"
    material: self_head
    slot: 4
    lore:
      - "&8Global ranking"
      - ""
      - "&7Your level: &f{level}"
      - "&7Total XP: &f{current_short}"
      - ""
      - "&7Rank: &8#&a{lb_position}"
      - "&8You are in the top &a{lb_position_percent}%&8 of &7{lb_size}"
      - "&8players!"