XenoLevels

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

PlaceholderDescription
%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.

Formatting

Some plugins require braces instead of percent signs. Replace %xlv_level% with {xlv_level} (or the equivalent format your target plugin expects).

Last updated on