XenoLevels
gui.yml
Design progress, rewards, and booster menus.
gui.yml controls the inventory menus that players use to view progress, claim rewards, and review boosters.
Global options
| Path | Default | Description |
|---|---|---|
gui.enabled | true | Master switch for all GUIs in the system. |
gui.sounds.enabled | true | Toggle GUI sounds. |
gui.sounds.open / click / claim / close | "SOUND:volume:pitch" | Sounds for each action. |
gui.auto-refresh.enabled | true | Keep menus updated without closing them. |
gui.auto-refresh.interval | 30 | Refresh cadence in seconds. |
Main menu
| Field | Description |
|---|---|
main-menu.title | Inventory title. |
main-menu.rows | Inventory size (1–6 rows). |
main-menu.background | Optional filler item with material, name, and lore. |
main-menu.items.<id> | Define clickable items with material, slot, name, lore, commands, and optional conditions. |
Rewards menu
| Field | Description |
|---|---|
rewards-menu.title | Title that supports placeholders like {rewards_unclaimed}. |
rewards-menu.background | Background item definition. |
rewards-menu.pagination.items-per-page | Number of rewards shown per page. |
rewards-menu.pagination.previous / next / page-info | Items that control pagination. |
rewards-menu.reward-template | Default appearance for reward entries. |
Boosters menu
| Field | Description |
|---|---|
boosters-menu.title | Inventory title with placeholder support. |
boosters-menu.only-active | Show only active boosters when true. |
boosters-menu.background | Background item definition. |
boosters-menu.booster-template | Layout for booster entries, including lore placeholders. |
Placeholder recap
Combine GUI placeholders with
lang.yml strings and rewards.yml actions to build cohesive UX for your leveling systems.Last updated on