Placeholders
Use XenoLevels data in scoreboards, chat formats, and other plugins.
XenoLevels registers two PlaceholderAPI identifiers: %xlv_*% (XenoLevels) and %clv_*% (legacy CyberLevels). Install PlaceholderAPI, ensure the XenoLevels expansion is available, and reference the placeholders below.
Player placeholders
| Placeholder | Description |
|---|---|
%xlv_level% | Current level in the default system (alias: %xlv_player_level%). |
%xlv_level_next% | Next level value (caps at the system maximum when set). |
%xlv_level_key% | Formatted level key from lang.level-keys for the current level. |
%xlv_exp% | Current EXP amount (alias: %xlv_player_exp%). |
%xlv_exp_required% | EXP required for the next level. |
%xlv_exp_remaining% | EXP still needed before leveling up. |
%xlv_exp_progress_bar% | Progress bar rendered using lang.progress settings (aliases: %xlv_player_progress_bar%, %xlv_progress_bar%, %xlv_player_exp_progress_bar%). |
%xlv_exp_percent% | Progress percentage toward the next level (aliases: %xlv_player_percent%, %xlv_percent%). |
%xlv_prestige% | Current prestige name (aliases: %xlv_player_prestige%, %xlv_prestige_name%, %xlv_player_prestige_name%). |
%xlv_prestige_displayname% | Prestige display name (aliases: %xlv_player_prestige_displayname%, %xlv_prestige_display_name%, %xlv_player_prestige_display_name%). |
%xlv_prestige_level% | Prestige level based on the player level (alias: %xlv_player_prestige_level%). |
%xlv_level_maximum% | Highest level the system allows. |
%xlv_level_minimum% | Starting level. |
%xlv_exp_minimum% | Starting EXP. |
Add the system identifier before the key to target another system: %xlv_<system>_level%, %xlv_<system>_exp_required%, and so on.
Leaderboard placeholders
Use either %xlv_top_<position>_<type>% or %xlv_leaderboard_<position>_<type>% (positions start at 1). Supported types:
name– Player name.displayname/display_name– Bukkit display name.level– Current level.exp– EXP value.prestige/prestige_name– Prestige name.prestige_displayname/prestige_display_name– Prestige display name.prestige_level– Prestige level for the player’s current level.
If a leaderboard is disabled or a position has no entry, the placeholder returns disabled or - respectively.
Booster placeholders
| Placeholder | Description |
|---|---|
%xlv_booster_active% | Returns yes if the player has any active booster, otherwise no. |
%xlv_booster_count% | Number of currently active boosters for the player. |
%xlv_booster% | Sum of all active booster multipliers (alias: %xlv_booster_total_additive%). |
%xlv_booster_total_effective% | Real multiplier sum after applying stacking rules. |
%xlv_booster_<id>_active% | Returns yes if the specific booster is active. |
%xlv_booster_<id>_multiplier% | Multiplier value of the specific booster. |
%xlv_booster_<id>_remaining_seconds% | Remaining time in seconds. |
%xlv_booster_<id>_remaining_raw% | Remaining time in raw format (alias: %xlv_booster_<id>_duration_raw%). |
%xlv_booster_<id>_remaining_smart% | Remaining time in smart human-readable format (aliases: %xlv_booster_<id>_duration%, %xlv_booster_<id>_duration_smart%). |
%xlv_booster_<id>_end_at% | Timestamp when the booster expires. |
Replace <id> with your booster identifier from boosters.yml (e.g., %xlv_booster_vip_boost_active%).
Formatting
%xlv_level% with {xlv_level} (or the equivalent format your target plugin expects).Last updated on